AgentSkillの構造解剖
AgentSkills仕様の全体構造、必須フィールド、プログレッシブ・ディスクロージャーの3層モデルを理解する。
プレミアムコースコンテンツ
このレッスンはプレミアムコースの一部です。Proにアップグレードすると、すべてのプレミアムコースとコンテンツを利用できます。
- すべてのプレミアムコースを利用
- 1,000以上のAIスキルテンプレート付き
- 毎週新しいコンテンツを追加
AgentSkillsとは何か
AgentSkillsは、AIエージェントに新しい能力を教えるための標準仕様です。スキルファイルは単なるMarkdownファイル——プログラミング言語ではなく、構造化されたプレーンテキストです。
仕様の全体像
AgentSkillsの核心は驚くほどシンプルです:
| 要素 | 役割 | 必須? |
|---|---|---|
| name | スキルの一意な識別子 | 必須 |
| description | エージェントが使用タイミングを判断する説明 | 必須 |
| 命令本文 | エージェントへの詳細な指示 | 推奨 |
| リファレンスファイル | テンプレート、サンプル、設定 | オプション |
プログレッシブ・ディスクロージャー(3層モデル)
エージェントはスキルを段階的に読み込みます:
第1層:メタデータ(常に読み込み)
- name、description、タグ、呼び出し設定
- コンテキストウィンドウの消費は最小限
第2層:命令全文(スキル使用時に読み込み)
- YAML以降のMarkdown本文全体
- エージェントへの詳細な行動指示
第3層:リンクファイル(必要時に読み込み)
- テンプレート、サンプルコード、設定ファイル
referencesで指定したディレクトリの内容
この段階的読み込みにより、数百のスキルがインストールされていても、コンテキストウィンドウを圧迫しません。
✅ 確認クイズ: SKILL.mdのdescriptionフィールドがスキルの成功にとって最も重要な理由は?→エージェントはdescriptionを読んでスキルを「いつ使うか」を判断します。優れた技術的命令があっても、descriptionが曖昧ならエージェントはスキルを呼び出しません。
まとめ
- AgentSkills仕様の必須フィールドはnameとdescriptionの2つだけ——シンプルなMarkdownファイルで誰でもスキルを作れる
- プログレッシブ・ディスクロージャーの3層モデルで、コンテキストウィンドウを効率的に使う
- AgentSkillsはオープンスタンダードで、複数のエージェントプラットフォーム間でポータブル
- descriptionの品質がスキルの活用度を決める——エージェントはdescriptionで使用判断する
次のレッスン: 初めてのカスタムスキル——実際にスキルフォルダを作成し、最初のSKILL.mdを構築・テストします。
理解度チェック
まず上のクイズを完了してください
レッスン完了!