「Agent Skills」は道具をまたいでどこまで動くか　違いは置き場所と追加の項目

米Anthropicが10月22日、エージェントに仕事の手順を教える形式「Agent Skills」を中立の財団に預けると発表したことで、同じスキルを複数の道具で使い回す前提が強まった。では、いま書いたスキルはClaude Code・Codex・Cursor・GitHub Copilotでそのまま動くのか。各社の公式の手引きを並べると、SKILL.mdの基本は共通で、違いはフォルダーの置き場所と、各社が足した追加の項目に集まっている。

共通なのは名前と説明と本文

Agent Skillsの仕様によると、スキルは「SKILL.md」を必ず含むフォルダーだ。先頭の設定欄に名前（name）と説明（description）を書く。名前は64字までの小文字の英数字とハイフンで、フォルダー名と同じにする。説明は1024字までで、何をするスキルで、いつ使うかを書く。

フォルダーには、動かすコードを入れる「scripts」、参考資料の「references」、ひな形や画像の「assets」も置ける。本文から別のファイルを指す時は、スキルの最上位からの相対パスで書き、参照は1段までにするよう仕様は勧める。CodexとCursorの手引きも、同じフォルダーの形を例に挙げている。

任意の項目はlicense、compatibility、metadata、allowed-toolsの4つしかない。しかもallowed-toolsは試験的な扱いで、対応は道具ごとに違うと仕様自身が書いている。

道具は起動時に名前と説明だけを読み、仕事が説明に合った時に初めて本文を読み込む。仕様は説明の部分を約100トークン、本文を5000トークン未満に収めるよう勧めている。要は、説明の書き方が、スキルが呼ばれるかどうかを左右する。

置き場所は道具ごとに違う

Codexの手引きによると、Codexはリポジトリの「.agents/skills」を、作業中のフォルダーから最上位までさかのぼって読む。個人用の置き場所は「$HOME/.agents/skills」だ。ところがClaude Codeの手引きが挙げる読み込み先は「.claude/skills」と「~/.claude/skills」で、「.agents/skills」は挙げていない。

Cursorの手引きは「.agents/skills」と「.cursor/skills」に加え、互換のために「.claude/skills」と「.codex/skills」も読むと書く。VS CodeのGitHub Copilotも「.github/skills」「.claude/skills」「.agents/skills」の3つを読む。

つまり、1つのフォルダーで4つ全部に届く置き場所は今のところ無い。「.agents/skills」ならCodex・Cursor・Copilotに届くが、Claude Codeには届かない。ただしClaude CodeとCodexの手引きはどちらも、スキルのフォルダーをシンボリックリンク（別の場所を指す印）にしてよいと書いている。中身を1か所に置き、もう一方からリンクを張れば、両方で同じスキルを読ませられる。

追加の項目は持ち運べない

各社は仕様の外にも項目を足している。Claude Codeは、自動で呼ばせない「disable-model-invocation」、/のメニューから隠す「user-invocable」、サブエージェント（親から呼び出される別のAI）で動かす「context: fork」、対象のファイルを絞る「paths」などを持つ。Cursorもdisable-model-invocationとpathsを使えるほか、見た目を決めるiconとcolorを足した。Copilotはuser-invocable、disable-model-invocation、argument-hintを受け付ける。

Codexは違う作りだ。手引きの項目にdisable-model-invocationは無く、同じ「自動で呼ばない」設定は、スキルのフォルダーに「agents/openai.yaml」を置き、allow_implicit_invocationをfalseにして書く。

追加の項目の危うさは、Claude Code自身が手引きで認めている。claude.aiへのアップロードやSkills APIでは、使える項目が仕様の6つに限られる。ほかの項目があると、無視されずにエラーで止まるという。

読む量の上限にも差がある

Codexは、最初に読むスキルの一覧に上限を設けている。既定では、モデルが一度に読める量の2%か、それが分からない時は8000字までだ。スキルが多いと説明から短くし、それでも収まらなければ一部を一覧から外して警告を出す。上限はskills.max_context_tokensで1万トークンまで広げられる。手引きが、説明の頭に使う場面と呼び出しの言葉を置くよう勧めるのは、短くされても呼ばれるようにするためだ。

結局、どの道具でも動くスキルの条件は、設定欄を仕様の6つの項目で書き、置き場所を道具に合わせることに尽きる。

編集部の見方

道具を使い分けるチームなら、まず手元のスキルの設定欄を見直したい。共通に使うスキルは仕様の6項目だけで書き、自動で呼ばせないといった制御は、道具ごとの設定に分けておくと持ち運びやすい。置き場所はリンクで1か所にまとめれば、直し忘れも減る。財団が版を区切った仕様を出せば、こうした差がどこまで埋まるかを見ておきたい。