2026-09-10 発行(読了 6 分)
実プロダクトのアーキテクチャ・使用例から AI 開発の現在地を週 3 回・1 号 1 テーマで深掘り
2025年10月にAnthropicが発表したAgent Skillsは、当初はClaude専用のディレクトリ形式に過ぎなかった。しかし同年12月に仕様がagentskills.ioとしてオープン化されて以降、Microsoft・OpenAI・Cursorなど20以上のプラットフォームが同じSKILL.md形式を採用し、Notion・Canva・Rakutenなどがパートナー製スキルを提供するに至った。RAGやツール呼び出しとは別の「第3のコンテキスト供給経路」がここまで速く普及した例は珍しい。仕組みと実例からその理由を見る。
Agent Skills の基本構造は、SKILL.md というファイル1枚に frontmatter(name / description)と本文を持たせ、それをディレクトリ単位でまとめたものだ。エージェントは起動時に全スキルの description だけ(1件あたり目安100トークン程度)をシステムプロンプトに読み込み、タスクとの関連が疑わしいと判断した時点で初めてそのSKILL.md本文(推奨5000トークン未満)を読みに行く。さらに scripts/ や references/ 配下のファイルは、本文を読んだ後に必要になったものだけを個別に読む。
この3段構成が要るのは、スキルの「量」に制約を持たせないためだ。数十個のスキルを常駐させても、常に載るのはdescriptionの合計だけで、本文以下はタスクごとに1〜数個しか展開されない。RAGが「検索して該当ドキュメントを渡す」設計であるのに対し、Skillsは「事前にインデックス化された手順書を、目次から本文、付録の順にエージェント自身がたどる」設計であり、検索インフラを持たずに同じ効果を得られる点が普及の起点になった。
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は「手順とノウハウをどう配布するか」の標準であり、両者は補完関係にある。
スキルが数十個規模になると、次に問題になるのは「常駐コストの低さ」ではなく「エージェントが余計なタイミングでスキルを呼んでしまう」ことだ。GitHub上で最も星の多いAgent Skillsコレクションの一つであるmattpocock/skillsは、v1.0でスキルを「モデルが自律的に呼ぶもの」と「ユーザーが明示的に /skill-name で呼ぶもの」に分離し、後者には disable-model-invocation: true を設定してdescriptionごとモデルの判断対象から外した。
この分離が必要になるのは、デプロイや送信のような副作用のある操作を「意味的に関連しそうだから」とモデルが自動発火させると事故につながるためだ。実務ブログでも、副作用を持つスキルには disable-model-invocation を付け、ユーザーの明示的な呼び出しだけで発火させる設計が推奨されている。プログレッシブディスクロージャーが「いつ本文を読むか」の設計だったのに対し、この分離は「いつ実行を許可するか」の設計であり、Skillsの普及後に議論の焦点が移った先はここにある。