AgentSkillの構造解剖

AgentSkillsとは何か

AgentSkillsは、AIエージェントに新しい能力を教えるための標準仕様です。スキルファイルは単なるMarkdownファイル——プログラミング言語ではなく、構造化されたプレーンテキストです。

仕様の全体像

AgentSkillsの核心は驚くほどシンプルです：

プログレッシブ・ディスクロージャー（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を構築・テストします。