Agent Skills の基本構造は、SKILL.md というファイル1枚に frontmatter（name / description）と本文を持たせ、それをディレクトリ単位でまとめたものだ。エージェントは起動時に全スキルの description だけ（1件あたり目安100トークン程度）をシステムプロンプトに読み込み、タスクとの関連が疑わしいと判断した時点で初めてそのSKILL.md本文（推奨5000トークン未満）を読みに行く。さらに scripts/ や references/ 配下のファイルは、本文を読んだ後に必要になったものだけを個別に読む。
この3段構成が要るのは、スキルの「量」に制約を持たせないためだ。数十個のスキルを常駐させても、常に載るのはdescriptionの合計だけで、本文以下はタスクごとに1〜数個しか展開されない。RAGが「検索して該当ドキュメントを渡す」設計であるのに対し、Skillsは「事前にインデックス化された手順書を、目次から本文、付録の順にエージェント自身がたどる」設計であり、検索インフラを持たずに同じ効果を得られる点が普及の起点になった。
", "examples": [ { "product": "Claude Skills（Anthropic公式エンジニアリングブログ）", "approach": "description(~100トークン)→SKILL.md本文(<5000トークン推奨)→scripts/referencesの3段階でコンテキストに展開する", "detail": "この3段階ロードの仕組みを最初に定義し、後続の仕様のベースになった", "source_url": "https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills" } ], "takeaway": "スキル数を増やしても常駐コストはdescription分だけで済むため、「ツールを増やすとコンテキストが膨らむ」問題への対処として、頻度の低い専門タスクはツールではなくスキルとして切り出す方が筋がいい。" }, { "heading": "独自フォーマットからオープン標準への転換", "body_html": "Agent Skills は登場から2ヶ月後の2025年12月18日、Anthropicが仕様を agentskills.io として公開し、Claude専用のディレクトリ形式からプラットフォーム非依存のオープン標準に切り替わった。SKILL.mdの命名規則・frontmatterの必須フィールド・progressive disclosureの3段階を仕様として固定したことで、Microsoft・OpenAI・Cursor・GitHubなど20以上のプラットフォームが同じフォーマットを採用し、1つのスキルディレクトリを複数のエージェント実装で使い回せるようになった。
Rakutenは公式ブログで、スキル導入後に経理関連の作業が「1日かかっていたものが1時間に短縮された」と報告している。この種の具体的な効果が出るのは、スキルが「プロンプトの中身」ではなく「組織の手順書そのもの」を成果物として管理できるからだ。MCPが「ツールをどう繋ぐか」の標準だったのに対し、Skillsは「手順とノウハウをどう配布するか」の標準であり、両者は補完関係にある。
", "examples": [ { "product": "agentskills.io（オープン仕様）", "approach": "SKILL.mdのfrontmatter必須フィールドとprogressive disclosureの3段階をプラットフォーム非依存の仕様として固定", "detail": "Microsoft・OpenAI・Cursor・GitHubなど20以上のプラットフォームが同一フォーマットを採用する起点になった", "source_url": "https://agentskills.io/specification" }, { "product": "Rakuten（Anthropic公式ブログのパートナー事例）", "approach": "経理関連ワークフローにスキルを導入し、作業時間を1日から1時間に短縮したと報告", "detail": "スキルが「プロンプトの工夫」でなく「組織の手順書」として機能した具体的な数値例", "source_url": "https://claude.com/blog/skills" } ], "takeaway": "自社の業務手順をスキルとして切り出すなら、社内限定のプロンプトの工夫として抱え込むより、オープン標準に沿って書いた方が将来複数のエージェント実装に転用でき、投資回収が早い。" }, { "heading": "モデル任せの呼び出しと、明示呼び出しの分離", "body_html": "スキルが数十個規模になると、次に問題になるのは「常駐コストの低さ」ではなく「エージェントが余計なタイミングでスキルを呼んでしまう」ことだ。GitHub上で最も星の多いAgent Skillsコレクションの一つであるmattpocock/skillsは、v1.0でスキルを「モデルが自律的に呼ぶもの」と「ユーザーが明示的に /skill-name で呼ぶもの」に分離し、後者には disable-model-invocation: true を設定してdescriptionごとモデルの判断対象から外した。
この分離が必要になるのは、デプロイや送信のような副作用のある操作を「意味的に関連しそうだから」とモデルが自動発火させると事故につながるためだ。実務ブログでも、副作用を持つスキルには disable-model-invocation を付け、ユーザーの明示的な呼び出しだけで発火させる設計が推奨されている。プログレッシブディスクロージャーが「いつ本文を読むか」の設計だったのに対し、この分離は「いつ実行を許可するか」の設計であり、Skillsの普及後に議論の焦点が移った先はここにある。