mcpField
S
skill-template

skill-template

github.com/muratcankoylanエージェントワークフロー18.2k110 回インストール2 週間前に更新
リポジトリ

skill-template について

エージェントスキルの作成用テンプレートで、起動条件、担当範囲、実践ガイド、例、参考資料を扱います。簡潔なスキル文書を構成し、隣接するスキルとの担当範囲を明確にできます。

主な機能

  1. 01起動条件を定義
  2. 02スキルの担当範囲を明示
  3. 03実践ガイドを構成
  4. 04例と注意点を追加
  5. 05参考資料とメタデータを整理

活用シーン

  1. 01新しいエージェントスキルを作成
  2. 02スキルの起動条件を明確化
  3. 03関連スキルの範囲を分ける
  4. 04スキル文書の構成を整える

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/muratcankoylan/agent-skills-for-context-engineering --skill skill-template

インストール後、Claude Code で/skill-templateを入力して読み込まれたか確認します。

同梱ファイルreferences/reference-file.mdreferences/topic-details.md

詳細

スキル名

このスキルが対象とする内容と、使用する状況を明確かつ簡潔に説明します。この説明はスキルの検索時に表示され、エージェント（および人間）がこのスキルの関連性を判断するのに役立ちます。

重要：パフォーマンスを最適化するため、SKILL.md の本文は全体で 500 行未満にしてください。詳細な参照資料は references/ ディレクトリ内の別ファイルに移動してください。

すべてのスキルで、責任範囲を明確にする必要があります。説明と「有効化するタイミング」セクションでは、このスキルが担当する範囲と、隣接する作業を担当するスキルを記載してください。これにより、広範なスキルが、より狭い範囲を扱うスキルの有効化を妨げるのを防げます。

有効化するタイミング

このスキルを有効化する具体的な状況、タスク、コンテキストを説明します。直接的なトリガー（具体的なキーワードやタスクの種類）と、関連性を示す間接的な兆候（より広範なパターン）の両方を含めてください。

三人称で記述してください。説明はシステムプロンプトに挿入されるため、一貫性のない視点を使うと、スキルの検出に問題が生じることがあります。

  • 良い例：「Excel ファイルを処理し、レポートを生成します」
  • 避ける例：「Excel ファイルの処理をお手伝いします」

隣接するスキルを対象外とする、短い「有効化しない場合」のブロックを記載してください。例：

  • プロジェクトレベルのパイプライン構成では有効化しないでください：project-development。
  • 個々のツールのスキーマ設計では有効化しないでください：tool-design。

中核となる概念

このスキルが対象とする基本概念を説明します。このスキルが教えるメンタルモデル、原則、フレームワークを記載してください。

デフォルトの前提：Claude はすでに非常に高い知能を備えています。Claude がまだ持っていないコンテキストのみを追加してください。各情報について、次の点を検討してください。

  • 「Claude は本当にこの説明を必要としているか？」
  • 「Claude はこれを知っていると想定できるか？」
  • 「この段落はトークンを費やすだけの価値があるか？」

一般的な背景知識よりも、動作を変える仕組みを優先してください。概念をコーパス全体で再利用する場合は、researcher/mechanisms/registry.jsonl にレコードを追加するか、既存のレコードを更新してください。

詳細なトピック

トピック 1

最初の主要なトピックを詳しく説明します。具体的な手法、パターン、アプローチを含めてください。概念を説明する例も使用してください。

トピック 2

2 つ目の主要なトピックを詳しく説明します。必要に応じて、さらにトピックを追加してください。

トピックが長くなる場合は、内容を references/ に移動し、リンクを記載することを検討してください。

実践的なガイダンス

スキルを適用するための実行可能なガイダンスを記載します。よく使われるパターン、避けるべきアンチパターン、アプローチを選択するための判断基準を含めてください。

タスクの壊れやすさに合わせて、具体性のレベルを調整してください。

  • 自由度が高い：複数のアプローチが有効であり、判断は状況によって異なります
  • 自由度が中程度：推奨されるパターンがありますが、ある程度の変更は許容されます
  • 自由度が低い：操作が壊れやすく、特定の順序に従う必要があります

実践的なガイダンスは、エージェントが実行できるものである必要があります。ワークフロー、チェックリスト、判断表、または具体的な運用ルールを記載してください。歴史や動機を説明するだけのセクションは、references/ に移動してください。

例

スキルの適用方法を示す具体例を記載します。例では、変更前と変更後を比較したり、正しい使い方を示したり、例外的なケースへの対処方法を説明したりしてください。

明確にするため、入力と出力の組み合わせを使用してください。

例：

Input: [describe input]
Output: [show expected output]

ガイドライン

このスキルを適用する際に従うべき、具体的なガイドラインを列挙します。実行可能で、確認可能なルールにしてください。

  1. 具体的で検証可能な基準を示すガイドライン 1
  2. 成功条件が明確なガイドライン 2
  3. 必要に応じて続けてください

注意点

経験に基づく失敗例、よくある間違い、直感に反する動作を列挙します。これらは、あらゆるスキルの中でも特に価値の高い情報です。各注意点は具体的かつ実行可能で、スキル本文ですでに説明されているガイダンスと重複しないようにしてください。番号付きリストを使用します。

  1. 簡潔で内容がわかるタイトル：何が問題になるのか、どうすれば防げるのかを1～2文で説明します。
  2. 別の注意点のタイトル：失敗例と、代わりに何をすべきかを説明します。

統合

このスキルがコレクション内の他のスキルとどのように連携するかを説明します。ディレクトリ間の参照に関する問題を避けるため、関連スキルはリンクではなくプレーンテキストで列挙します。

  • skill-name-one - 関連性の簡単な説明
  • skill-name-two - 関連性の簡単な説明

参考資料

内部資料（スキル自身の参考資料ファイルへの相対パスを使用）：

このコレクション内の関連スキル：

  • skill-name - 関連性の説明

外部リソース：

  • 研究論文、ドキュメント、ガイド

数値、ベンチマーク、変動しやすい情報、またはベンダーの性能に関する主張には、researcher/claims/index.jsonl に裏付けられたインラインの claim-* ID が必要です。そうでない場合は、表現を控えめにし、日付を明記した参考資料に移してください。

スキルのメタデータ

作成日：[Date]
最終更新日：[Date]
作成者：[Author or Attribution]
バージョン：[Version number]

コメント

Markdown 対応