Claude Skills 解説：段階的開示の3つのレベル

Claude Skillとは、物理的にはひとつのフォルダです。ホストされたサービスでも、バイナリでも、会話の冒頭に貼り付けるテキストの塊でもなく、SKILL.mdファイルと、その作業に必要なその他のものを含むディレクトリです。Skillsに関する興味深い点のほとんどは、このひとつの決定から導かれます。なぜならフォルダは、エージェントが選択的に開くことのできるものだからです。プロンプトは選択的に開くことができません。それは会話の中にあるか、ないかのどちらかです。

Anthropicのドキュメントでは、この仕組みは、新しいチームメンバーのために作るオンボーディングガイドのように整理されていると説明されており、そのたとえは一見した以上に深く当てはまる。オンボーディングガイドを仕事を始める前に最初から最後まで読む人はいない。人々は目の前の疑問に合ったページを読み、必要になったときには残りの部分もそこにあると信頼している。スキルも同じ賭けの上に成り立っている。つまり、手順の大部分はほとんどの間、ディスク上に置いておけるというものだ。

ファイルシステムを優先し、機能は二の次にする

Claudeはファイルシステムにアクセスできる仮想マシン内で動作します。これが、スキルが設定エントリではなくディレクトリであるための前提条件です。なぜなら、エージェントが人間と同じ操作を使って、フォルダを一覧表示し、ファイルを読み取り、別のファイルへの参照をたどることができるからです。その中で、スキルは指示、メタデータ、そしてスクリプトやテンプレートなどの任意のリソースをパッケージ化します。

その結果として生まれるのは、フォルダ内のどの単一ファイルよりも大きな能力です。指示ファイルはタスクの進め方を示します。同梱されたスクリプトは、散文で説明されていなくてもその一部を実行できます。参照ドキュメントは、記憶しておくのではなく都度参照される資料を保持できます。この3つを単なる寄せ集めではなく一つのシステムにしているのは、それらが見えるようになる順序であり、これがAnthropicの言う「プログレッシブ・ディスクロージャー」の部分です。つまり、コンテキストを前もって消費するのではなく、必要に応じて情報を段階的に読み込むということです。

レベル1：常に読み込まれる2つのフィールド

すべてのスキルは、名前と説明を含むYAMLフロントマターから始まります。Claudeは起動時にそのメタデータを読み込み、システムプロンプトに含めます。誰かが何かを要求する前に存在しているスキルの部分はこれだけであり、スキルがトリガーされるまでは、その名前と説明だけがコンテキストを占めます。

説明文は同時に3つの役割を担っており、それらを切り分けて考えると、なぜ多くのスキルが黙って無視されるのかがよく分かる。1つ目はラベルであり、その対象が何と呼ばれるかを示す。2つ目は索引エントリであり、Claudeがそのスキルが関連するかどうかを判断する際に、リクエストと照合されるテキストである。3つ目は適用範囲の表明であり、だからこそAnthropicのガイダンスでは、スキルが何をするかと、いつ使うべきかの両方を示さなければならないとされている。最初の役割しか果たしていない説明文では、照合する側に照合できる材料が何も与えられない。

同じスキルの2つのバージョンを考えてみましょう。一方は、PDFフォームの記入と検証を行うものとして説明され、リクエストでPDFフォームの記入や確認が必要な場合に使用されます。もう一方は、ドキュメントを扱う支援として説明されています。前者はアクションと状況を明示していますが、後者はどちらも明示していません。説明でどちらも明示していないスキルは、エージェントが遠回りしてタスクを実行している間、ディスク上で読まれないままになります。それはスキルが失敗したからではなく、見つけられなかったからです。

レベル2：本文。説明が一致したときに読む

リクエストが説明と一致すると、第2レベルが開きます。それが SKILL.md の本体です。ここには手順、すなわちワークフロー、ベストプラクティス、ガイダンスが記され、このスキルこそがその作業に適したツールだとすでに判断したエージェントに向けて書かれています。チームが、そうしなければ毎回の会話で繰り返すことになる手順を書き留める場所であり、より深い資料へのポインタが置かれる場所でもあります。

ここでは、順序がレベル1の場合と同じくらい重要です。本文は起動時に読み込まれず、念のため読み込まれることもありません。本文は判断が下された後に届くため、その判断はレベル1だけで下せる必要があります。説明が曖昧なスキルは、レベル2では挽回できません。レベル2は決して読まれないからです。

レベル3：何かがそれらを指し示したために開くファイル

第3階層はフォルダの残りの部分です。つまり、{{1}}SKILL.md{{/1}}から参照される追加ファイルです。{{2}}Anthropic{{/2}}の例は、フォーム入力に関する高度なガイダンスを保持する{{3}}FORMS.md{{/3}}で、メインの指示から外して置くことで、その指示を短く保ち、詳細はタスクで必要なときにのみ利用できるようにしています。スクリプトやテンプレートもこの階層に属します。

構造上の効果は、スキルが大量の資料を一度にすべて抱え込むことなく保持できるという点にある。フォルダには、主要な指示ファイル、詳細なリファレンス、テンプレート一式、スクリプトが入っていることがあり、特定のタスクではそのうちの1つにしか触れないかもしれない。どこからも参照されないものはディスク上に残り、エージェントにとってディスクは希少な資源ではない。コンテキストが希少なのだ。

そこがまた、この形式がプロンプトでは突き当たってしまう上限を引き上げる点でもある。プロンプトは、貼り付ける価値がある程度に短くなければならない。スキルに同梱される資料は、ディレクトリが保持できる量によって制限される。なぜなら、モデルに届くのは、タスクが実際に触れた部分だけだからだ。

なぜ「順序」は細部ではなく設計なのか

三つの帰結が導かれる。そして、それらが相まって、これが単に知るだけでなく理解するに値する理由となっている。

• コンテキストは予算であり、常時読み込まれるコンテンツは固定費です。システムプロンプト内のすべては、そのスキルと無関係なリクエストも含め、あらゆるリクエストでコストが発生します。プログレッシブ・ディスクロージャーは固定費を条件付きのコストに変えます。つまり、説明は常に、指示は関連するときに、参照情報は参照されたときに読み込まれます。

• 説明文はインターフェースです。 それはスキルの中で必ず目にされる唯一の部分なので、作成者が内容だけでなくトリガーについても考える必要がある場所です。

• スキルには3つのメンテナンス速度があります。メタデータはスキルの発動条件が変わる場合に、本文はワークフローが変わる場合に、参照資料は基盤となる資料が変わる場合に変更します。これらを分けておけば、参照の更新が指示の書き直しに発展するのを防げます。

コストは利点の裏返しだ。あらゆるレベルの境界は、モデルが正しく判断を下さなければならない地点である。説明が狭すぎれば、そのスキルは決して発動せず、フォルダはただのお荷物になる。広すぎれば、想定していない作業で発動し、その指示が無関係なタスクへの負担になる。プログレッシブ・ディスクロージャーは、常に存在する長いプロンプトには決してない形で、説明を不可欠な支えにする。

Anthropicがすでに提供しているものと、あなた自身のスキルがどこから来るのか

AnthropicはPowerPoint、Excel、Word、PDF向けの事前構築済みSkillsを提供しています——プレゼンテーション、スプレッドシート、ドキュメント、書式設定済みPDF出力に対応します。これらはclaude.ai、Claude API、Claude Platform on AWS、Microsoft Foundryで利用できますが、FoundryではHosted on Anthropicデプロイメントが必要という注意点があります。

それらは、仕組みについて読むのではなく実際に見るための最短の方法です。読み込み順序は、自分で書いたものとまったく同じです。既製のスキルとカスタムスキルの違いは、フォルダーを誰が作成したかであり、モデルにどのように届くかではありません。

カスタムスキルは、Claude Code で作成することも、Claude API を通じてアップロードすることも、claude.ai の設定で追加することもできます。Anthropic が挙げている利点は、再利用可能なものなら当然期待されるものです。つまり、Claude をドメイン固有のタスク向けに特化させること、ガイダンスを繰り返すのではなく一度作成すること、複数ステップの作業のために複数のスキルを組み合わせることです。最後の点はアーキテクチャから最も直接的に導かれます。各スキルがオンデマンドで開くフォルダーであれば、作業が実際にそれらを必要とするまでは、スキルをいくつ重ねてもコストはごくわずかだからです。

スキルはプロンプトではなく、コネクターでもありません

会話では3つのことが混同されがちだが、ロードの順序を踏まえると、その区別は容易に保てる。

プロンプトは会話レベルのものだ。最初のターンから存在し、その会話のすべてに影響を与え、会話とともに消える。スキルはオンデマンドだ。会話が始まる前から存在し、その大部分は会話に入ることさえなく、入ってくる部分は説明が一致したから入ってくる。それが、エージェントにどう振る舞うべきかを伝えることと、エージェントが拾い上げられる何かを与えることの違いだ。

コネクタは「リーチ」に関するものです。コネクタはアプリへのアクセスであり、エージェントが何に触れられるかを決めます。スキルは、エージェントが触れられるようになった後に、どう作業すべきかを決めます。優れたコネクタを揃えていても、アクセスは手順ではないため、一貫性のない文書しか生み出せないチームもあります。また、優れたスキルを揃えていても、手順はアクセスではないため、データを見られないこともあります。

Anthropicのドキュメントでは、SkillsとModel Context Protocolを異なるレイヤーとして扱っており、3段階の仕組みが、その分離がなぜ明確なのかを示しています。読み込み順序は、情報がどこから来たかではなく、いつ情報が届くかに関するものです。

寄付がどこに位置づけられるかを1段落で

2026年10月22日、AnthropicはAgent Skills標準をLinux Foundation傘下のAgentic AI Foundationに寄贈した — 名称、ロゴ、GitHub組織、agentskills.ioドメインを含めて — そしてAnthropic、Google、OpenAIなどの企業のエンジニアが個人としてそれを保守している。これらのいずれも上記の仕組みを変えるものではない。フォルダー形式、YAMLフロントマター、読み込み順序、および事前構築済みのドキュメントスキルは、前日とまったく同じだ。変わったのはその名称の所有者であり、これは標準の長期的な安定性にとっては非常に重要だが、今日の午後にスキルをどう書くかにはまったく関係がない。

スキルをインストールする前に読む

三つのレベルがアーキテクチャであるなら、それは短いレビューチェックリストにもなる。まず説明文を読む。それが、他のことが実際に起きるかどうかを決めるからだ。説明文は、スキルが何をするのか、そしていつ使われるべきなのかを、リクエストで実際に使われそうな言葉で示しているべきである。次に SKILL.md を読む。これはエージェントが従う手順であり、こうなってほしいという願望の要約ではなく、有能な同僚への指示のように読めるべきだからだ。三番目に、それが参照しているものを読む。その後でスクリプトを読む。

最後の項目は妄想ではない。このフォーマットでは、スキルが任意のリソースと並べて指示を保持することができ、リソースには実行可能コードを含めることもできる。したがって、インストールするスキルは会話を形作るテキストだけではなく、有能なエージェントがファイルを開いて行動するフォルダでもある。レベルごとのモデルは、どこを見ればよいかを正確に教えてくれる。これは、大半のインストール済みのものにはない利点だ。

自社ページから来た読者のために、一つの境界を明示しておく価値があります。OrcaRouter はモデル呼び出しをルーティングするものであり、Anthropic のアプリやそのスキル面を当社がホストしているわけではありません。スキルはエージェントのファイルシステムがある場所で実行され、それは当社のレイヤーではありません。当社が担うのはモデル選択の土台部分です。OpenAI 互換の単一キーの背後に 200 以上のモデルがあり、プロバイダーの定価を上乗せなしでそのまま適用し、プロバイダーが利用できない場合にはプロバイダー間で自動フェイルオーバーします。スキルはタスクをどう実行すべきかを決め、ルーターはどのモデルがそれを実行するかを決めます。どちらのレイヤーも、相手についてあまり知る必要はないはずです。

プログレッシブ・ディスクロージャーは、自らが解決する制約に対して正直です。コンテキストは有限であり、手順は長く、与えられた手順のほとんどは目の前のタスクには無関係です。名前と本体、そして一連のファイルという構成は、複雑な設計ではありません。エージェントが膨大な知識を担いながら、必要な部分だけを保持できるようにする、最小限の設計なのです。

だからこそ、よく作られたスキルにおいて最も重要な一文は、同時に最も短い一文でもある。フォルダ内の他のすべては図書館のようなものだ。説明文はその目録であり、目録が間違っていれば、図書館も存在しないに等しい。