AI 活用記事AIコーディングツール

Agent Skillsとは|寄贈で何が変わるか・SKILL.mdの書き方

AnthropicがAgent SkillsをMCPと同じAgentic AI Foundation(AAIF)に寄贈。仕組みと寄贈で変わること、SKILL.mdの書き方のコツ、MCPとの違い、Codex CLIとClaude Codeで試した結果を公式情報と実機で解説します。

AIコーディングツール、、読了時間:22分

朝もやの草原の手前に立つ、熟したタンポポの綿毛。いくつかの種が風に乗って、開けた野原の方へ飛んでいく

Agent Skillsは、AIエージェントに特定の仕事の手順や専門知識を教えるための公開の標準です。中身は、SKILL.md というファイルを入れた1つのフォルダです。Anthropicは2026年10月22日(米国)、この標準を、Linux Foundation傘下の**Agentic AI Foundation(AAIF)**に寄贈すると発表しました。AAIFは、AnthropicがMCP(Model Context Protocol)を寄贈したのと同じ団体です。Anthropicは、AAIFに参加しなくても、これまでどおり標準を使い、改善に加われるとしています。

本記事は2026年10月23日(日本時間)に速報として公開し、10月26日に、Codex CLIとClaude Codeで実際に試した結果、MCPとの違いの表、製品ごとのスキルの置き場所、SKILL.mdの書き方のコツ、10月26日までの続報を加えました。公式発表・公式ドキュメントと、編集部の実機ログで確認できたことだけを書いています。

結論から言うと、同じSKILL.mdは、Codex CLIでもClaude Codeでも指定どおりに動きました(普通の依頼でも、Codexは6回、Claude Codeは3回すべてで起動)。ただし置くフォルダが製品ごとに違います。Codexは .agents/skills/、Claude Codeは .claude/skills/ を読みます。

Agent Skillsとは

公式仕様によると、スキルは少なくとも SKILL.md を1つ含むフォルダです。SKILL.md には名前と説明、作業の手順を書きます。必要なら、実行するスクリプトや参考資料、テンプレートも同じフォルダに入れられます。

エージェントは、スキルを3段階で読み込みます。起動時は各スキルの名前と説明だけを読み、作業が説明に合うと SKILL.md の全文を読み、手順に従って作業します。使わないスキルの中身は読み込まないため、たくさんのスキルを置いておけます。

Agent Skillsの構成と読み込まれ方。スキルは1つのフォルダで、必須のSKILL.md(名前・説明と手順)と、任意のscripts(実行するコード)、references(参考資料)、assets(テンプレートなど)からなる。エージェントは、1 発見:起動時は名前と説明だけを読む、2 有効化:作業が説明に合うとSKILL.mdの全文を読む、3 実行:手順に従い必要ならスクリプトや資料も使う、の順に読み込む
Agent Skillsの構成と読み込まれ方。出典: agentskills.io(Overview、Specification)

Agent SkillsとMCPの違い

ひと言でいうと、MCPはAIを外部のシステムにつなぐ仕組み、Agent Skillsは作業の進め方を教える仕組みです。Claudeのヘルプセンターは「MCPはClaudeを外部のサービスやデータにつなぎ、スキルは手順の知識を教える」と説明し、両方を一緒に使えるとしています。公式ドキュメントに書かれている範囲で比べると、次のとおりです。

項目 Agent Skills MCP
役割 作業の手順や専門知識を教える AIアプリを外部のデータやツールにつなぐ
実体 SKILL.mdを入れたフォルダ(スクリプトや資料も入れられる) AIアプリ(クライアント)とMCPサーバーの間の通信の決まり(JSON-RPC 2.0)
AIに渡すもの 名前と説明。必要になったときにSKILL.mdの全文 サーバーが用意するツール、リソース、プロンプト
動く場所 エージェントが読めるフォルダに置く ローカル(STDIO)か、リモート(Streamable HTTP)のサーバー
作るのに必要なもの テキストの編集(Markdown) サーバーのプログラム
運営 AAIF(2026年10月に寄贈を発表) AAIF(Anthropicが先に寄贈)

出典: agentskills.io(Overview、Specification)、modelcontextprotocol.io(What is MCP?、Architecture)、Claudeのヘルプセンター、Anthropicの発表(いずれも2026年10月26日に取得)。

両者は組み合わせて使えます。たとえばCodexのドキュメントは、スキルが使うMCPサーバーを、スキルのフォルダの設定ファイル(agents/openai.yaml)に書ける例を載せています。これはCodex独自の拡張で、Agent Skillsの仕様にはありません。MCPサーバーを自分で作ってAIにつなぐ手順は、MCPサーバーの作り方で実際に試しています。

何が発表されたか

Anthropicの発表とLinux Foundationのプレスリリースで確認できた内容です。

  • 寄贈するもの:Agent Skillsの名前とロゴ、GitHubの組織、仕様を公開しているagentskills.ioのドメイン。
  • 寄贈先:AAIF。AnthropicがBlock、OpenAIと前年に共同で設立した団体で、MCPもここに寄贈されています。
  • 今後の運営:AAIFのブログによると、複数の企業から選ばれた技術運営委員会(Technical Steering Committee)が方向を決めます。Anthropic、Google、OpenAIなどのエンジニアが個人の立場で仕様を保守し、AnthropicのDavid Soria Parra氏とMahesh Murag氏がリードメンテナーを務めます。
  • 広がり:2025年12月に標準を公開して以来、ChatGPT、Cursor、GitHub Copilot、VS Codeなど70以上のエージェント製品が対応したとしています。Anthropicは、公開されたスキルは100万、インストールは約2億8,000万回としています(AAIFのブログは、登録サイトskills.shでの数としています)。
  • 同時に加わった仕組み:AAIFは同じ日に、OpenAIのOpen Responses、Hugging FaceのOpenEnv、AlibabaのOpenSandboxも受け入れ、扱うプロジェクトは10件になりました。

使う人にとって変わること・変わらないこと

公式に書かれている範囲で整理します。

公式の説明
変わること 標準の運営が、Anthropic単独から中立の団体(AAIF)に移る。方向は複数の企業からなる委員会が決める
今後の予定(提案) 版の番号つきのリリース、変更を提案する正式な手続き、スキルを書く人と入れる人のためのセキュリティの指針
変わらないこと AAIFに参加しなくても、標準を使い、改善に加われる。仕様は引き続きagentskills.ioで公開
ライセンス 仕様はApache 2.0とCC BY 4.0で公開(AAIFのブログ)

Claudeの場合、Claude Codeは個人用の ~/.claude/skills/ か、プロジェクトの .claude/skills/ に置いたスキルを使います。claude.aiではコード実行を有効にすると使え、自作のスキルは設定からzipで追加します。寄贈でこの使い方が変わるという案内は、発表にはありません。

10月26日までの続報

2026年10月26日17時12分〜13分(日本時間)に、AAIFのサイトと、仕様を管理するGitHubのリポジトリ(agentskills/agentskills)を確認しました。

  • 新しい発表はなし:AAIFのAgent Skillsのページに載っている記事は、10月22日のブログ1本だけです。AAIFのニュース一覧も、10月22日のプロジェクト追加の発表が最新でした。
  • 版の番号つきのリリースはまだ:リポジトリにはリリースもタグもありませんでした。最後のコミットは2026年8月9日(協定世界時)で、寄贈の発表後のコミットはありません。
  • 運営の文書はまだ見当たらない:リポジトリの最上位に、ガバナンスや保守担当者の一覧の文書(GOVERNANCE、MAINTAINERSなど)はありません。貢献の手引き(CONTRIBUTING.md)は、仕様の変更の提案をGitHubのDiscussionsで受け付け、「仕様に足すのは慎重に(迷ったら入れない)」と書いています。対応製品のロゴの掲載依頼は「Anthropicのチームが確認する」と書かれています。
  • AAIFの技術委員会:AAIFの紹介ページの技術委員会(Technical Committee)の欄には、議長のDavid Soria Parra氏(Anthropic)、Caitie McCaffrey氏(Microsoft)、Bradley Axen氏(Block)、Nick Cooper氏(OpenAI)の4人が表示されています(全員の一覧は別ページで、編集部は未取得)。これはAAIF全体の委員会で、Agent Skillsの技術運営委員会の顔ぶれは、まだ公表を確認できていません。
  • ライセンス:リポジトリはApache 2.0、仕様の文書のフォルダ(docs)はCC BY 4.0でした。AAIFのブログの説明と一致します。
  • 仕様の置き場所:仕様の本文はこのリポジトリの docs フォルダにあり、agentskills.ioで公開されています。スキルを検証する参考ライブラリ(skills-ref)も同じリポジトリにありますが、「デモ用で、本番での利用は想定していない」と書かれています。

SKILL.mdの書き方(最小の例)

SKILL.md は、先頭にYAMLのフロントマター(--- で囲んだ設定)を書き、その下に手順をMarkdownで書きます。公式仕様で必須なのは次の2つです。

項目 公式仕様のルール
name 64文字まで。小文字の英数字とハイフンだけ。先頭と末尾にハイフンを置かない。フォルダ名と同じにする
description 1,024文字まで。何をするスキルか、どんなときに使うかを書く

編集部が確認に使った例です。フォルダ名は meeting-memo-ja です。

---
name: meeting-memo-ja
description: 会議のメモを「決定事項・宿題・次回の予定」の3つの見出しで整理する。会議メモや議事録の整理を頼まれたときに使う。
---

# 会議メモの整理

1. メモを読み、決まったこと・担当者つきの宿題・次回の予定に分ける。
2. 「決定事項」「宿題」「次回の予定」の3つの見出しで箇条書きにする。
3. メモに書かれていないことは補わない。

公式仕様は、descriptionに「Helps with PDFs.」のような短い説明ではなく、何ができるかと、どんな言葉が出たら使うかを具体的に書くよう勧めています。

SKILL.mdの書き方のコツ(公式のベストプラクティスから)

agentskills.ioの「Best practices for skill creators」「Optimizing skill descriptions」と、Claude・Codexのドキュメントに書かれている勧めを、編集部が整理しました(2026年10月26日に取得)。

descriptionの書き方

  • いつ使うかを書く。エージェントは起動時に名前と説明だけを読み、使うかどうかを決めます。agentskills.ioは「説明が起動のすべてを担う」としています。
  • 利用者がしたいことを書く。スキルの内部のしくみではなく、利用者が頼みそうなことに合わせます。分野の言葉が出てこない頼み方でも使う場面を、はっきり挙げるよう勧めています。
  • 短く保つ。数文から短い段落が目安で、上限は1,024文字です。Claude Codeの一覧では、descriptionと when_to_use の合計が1,536文字で切られます。Codexは、スキルが多いと説明を短くして一覧に載せます。
  • 書き方の人称は製品で勧めが違う。agentskills.ioは「Use this skill when...(〜のときに使う)」という命令形を、Claudeのドキュメントは三人称を勧めています。編集部の例は「〜する。〜のときに使う。」と、何をするかといつ使うかを両方書いています。

本文(手順)の書き方

  • エージェントが知らないことだけを書く。PDFとは何か、のような一般的な説明はいりません。プロジェクト固有の決まりや、間違えやすい点を書きます。
  • 長さの目安は500行・5,000トークン以内。詳しい資料は references/ などに分け、「〜のときに〜を読む」と、読むタイミングを書きます。参照は、SKILL.mdから1段階までにします。
  • 選択肢を並べず、既定のやり方を1つ決める。ほかの方法は短く添えます。
  • 出力の形はテンプレートで示す。見出しや表の形を例として書くと、そのとおりに出やすくなります。
  • 落とし穴の節を作る。agentskills.ioは、環境に特有の「つい間違える点」の一覧を、もっとも価値の高い中身の1つとしています。
  • 実際に動かして直す。最初の版は直す前提で、実行の記録(最終出力だけでなく途中の動き)を読むよう勧めています。Claudeのドキュメントは、使う予定のモデルすべてで試すことも勧めています。

なお、agentskills.ioは「1回で終わる簡単な頼みごとでは、説明が合っていてもスキルが使われないことがある」とも書いています。エージェントが自力でこなせる作業より、専門の手順が要る作業ほどスキルの効果が出ます。

スキルを置く場所(製品ごと)

Agent Skillsの仕様は、フォルダの中身を決めています。どのフォルダから読み込むかは製品ごとに違います。各社のドキュメントに書かれている置き場所は次のとおりです(2026年10月26日に取得)。

製品 プロジェクト用 個人用
Claude Code(新しいウィンドウで開く) .claude/skills/ ~/.claude/skills/
Codex(CLI・IDE拡張)(新しいウィンドウで開く) .agents/skills/(作業フォルダからリポジトリのルートまで) ~/.agents/skills/
GitHub Copilot(新しいウィンドウで開く) .github/skills/・.claude/skills/・.agents/skills/ ~/.copilot/skills/・~/.agents/skills/
VS Code(新しいウィンドウで開く) .github/skills/・.claude/skills/・.agents/skills/ ~/.copilot/skills/・~/.claude/skills/・~/.agents/skills/
Cursor(新しいウィンドウで開く) .agents/skills/・.cursor/skills/(互換のため .claude/skills/・.codex/skills/ も) ~/.agents/skills/・~/.cursor/skills/(互換のため ~/.claude/skills/・~/.codex/skills/ も)

この5つでは、Claude Code以外のドキュメントに .agents/skills/ が載っています。Claude Codeのドキュメントには、.agents/skills/ の記載はありませんでした。編集部の確認でも、Claude Codeは .agents/skills/ だけに置いたスキルを読み込みませんでした(次の節)。Claude Codeと他の製品で同じスキルを使うなら、両方のフォルダに置くか、.claude/skills/ も読む製品と組み合わせます。

実際に動かした結果(Codex CLIとClaude Code)

2026年10月26日(日本時間)、編集部の環境で、上の例のSKILL.mdを2つのエージェントに読み込ませました(Codex CLIは17時14分〜35分、Claude Codeは21時55分〜56分)。

  • Codex CLI 0.163.0(ChatGPTでサインイン、記録上のモデルは全回gpt-6.1-sol)。codex exec を、読み取り専用・Web検索なしで実行しました。
  • Claude Code 2.1.306(ログイン済み、記録上のモデルは全回claude-sonnet-5-5)。claude -p で実行しました。
  • 毎回、新しい空のフォルダで実行しました。整理させたメモは検証用の架空のもので、次回の予定は書いていません(「書かれていないことは補わない」という指示を守るかを見るため)。

Codex CLIの結果(各条件3回)

条件 スキルの一覧に載った SKILL.mdを読んだ 3つの見出しで整理
A:.agents/skills/ に置き、$meeting-memo-ja と名前を指定 3/3 3/3 3/3
B:Aと同じ場所で、「次の会議メモを整理してください」と普通に依頼 3/3 3/3 3/3
C:descriptionを「会議メモを扱う。」だけにして、Bと同じ依頼 3/3 3/3 3/3
D:スキルなしで、Bと同じ依頼 — 0/3 0/3
E:.claude/skills/ だけに置いて、Bと同じ依頼 0/3 0/3 0/3
  • スキルが働いたA〜Cの9回は、すべて「決定事項」「宿題」「次回の予定」の見出しで整理し、次回の予定は「メモに記載なし」などと書きました。メモにない日付を足した回はありませんでした。
  • スキルなし(D)と、Codexが読まないフォルダに置いた場合(E)の6回は、「決定事項」と「対応事項」の表で整理し、「宿題」と「次回の予定」の見出しはありませんでした。
  • 説明を短くしたCでも起動しました。ただしスキルは1つだけで、頼んだのも会議メモそのものです。スキルが多いときや、紛らわしい依頼で同じ結果になるかは試していません。
  • 応答が300秒以内に返らなかった6回は、結果に数えず、やり直しました(いずれも途中の動きの記録がないまま止まったもの)。

Claude Codeの結果(各条件3回、起動時の情報・デバッグログ・出力)

条件 読み込まれたか 3つの見出しで整理
.claude/skills/ に置き、/meeting-memo-ja で呼ぶ 3/3(「Loaded 1 unique skills」) 3/3
.claude/skills/ に置き、descriptionを「会議メモを扱う。」だけにして普通に依頼 3/3 3/3
.agents/skills/ だけに置き、/meeting-memo-ja で呼ぶ 0/3(「Loaded 0 unique skills」) 0/3
  • 普通に依頼した3回は、3回ともClaudeが自分でスキルを起動してから整理しました。
  • スキルが働いた6回は、次回の予定を「メモに記載なし」などと書き、メモにない日付を足した回はありませんでした。
  • .agents/skills/ だけに置いた3回は、「/meeting-memo-ja はインストールされていない」と答えたうえで、スキルなしでメモを整理しました。「宿題」と「次回の予定」の見出しはありませんでした。

まとめると、同じSKILL.mdはそのまま両方で動きました。違うのは置く場所だけで、Codexは .agents/skills/、Claude Codeは .claude/skills/ からしか読み込みませんでした。

未確認の点

2026年10月26日の時点で、次の各点は確認できていません。確認できしだい更新します。

  • ほかの製品での挙動:GitHub Copilot、VS Code、Cursorは、ドキュメントに書かれた置き場所を載せただけで、編集部では動かしていません。
  • 仕様の今後の変更:版の番号つきのリリースなどは提案の段階で、時期や中身は公表されていません。リポジトリにも、まだリリースはありません。
  • 既存のスキルへの影響:これまでに書いたスキルの書き直しが必要になるかどうかは、公式に示されていません。
  • Agent Skillsの技術運営委員会の顔ぶれ:AAIF全体の技術委員会は公表されていますが、Agent Skillsの委員会のメンバーは確認できていません。
  • 対応製品の一覧:70以上の製品の内訳と、各製品が仕様のどこまでに対応しているかは確かめていません。

よくある質問

Q. Agent Skillsとは何ですか?

AIエージェントに特定の仕事の手順や専門知識を教えるための公開の標準です。スキルはSKILL.mdというファイルを入れた1つのフォルダで、必要ならスクリプトや参考資料も入れられます。Anthropicが開発し、2026年10月22日(米国)にAgentic AI Foundationへの寄贈が発表されました。

Q. Agent SkillsとMCPの違いは何ですか?

Claudeのヘルプセンターによると、MCPはClaudeを外部のサービスやデータにつなぐ仕組みで、スキルは作業の進め方を教えるものです。両方を一緒に使え、MCPでツールにつなぎ、スキルでそのツールの使い方を教えます。

Q. 寄贈で、これまでのスキルは使えなくなりますか?

Anthropicは、AAIFに参加しなくても引き続き標準を使い、改善に加われるとしています。仕様もagentskills.ioで公開されています。既存のスキルの書き直しが必要かどうかは、公式には示されていません。

Q. SKILL.mdには何を書けばよいですか?

先頭のフロントマターに、必須のnameとdescriptionを書きます。nameは小文字の英数字とハイフンで64文字まで、フォルダ名と同じにします。descriptionは1,024文字までで、何をするか、どんなときに使うかを書きます。その下に、作業の手順をMarkdownで書きます。

Q. Claudeではどこでスキルを使えますか?

Claude Codeでは個人用かプロジェクト用のスキルのフォルダに置いて使います。claude.aiではコード実行を有効にすると使え、自作のスキルは設定からzipで追加します。Claude APIでも使えます。

Q. Claude CodeとCodexで同じスキルを使えますか?

同じSKILL.mdが、そのまま両方で読み込まれ、指示どおりの見出しで整理しました。ただし置く場所が違います。Codexは.agents/skillsを、Claude Codeは.claude/skillsを読みます。編集部の確認では、Codexは.claude/skillsだけに置いたスキルを、Claude Codeは.agents/skillsだけに置いたスキルを、どちらも読み込みませんでした。両方で使うなら、両方のフォルダに置きます。

Q. スキルが使われないときは、どこを直せばよいですか?

まず置き場所が使っている製品に合っているかを確かめ、次にdescriptionを見直します。エージェントは起動時に名前と説明だけを読んで使うかを決めるため、何をするかと、どんな依頼のときに使うかを具体的に書きます。agentskills.ioによると、エージェントが自力でこなせる簡単な依頼では、説明が合っていてもスキルが使われないことがあります。

Q. Agent Skillsの仕様はどこで公開されていますか?

仕様はagentskills.ioで公開され、元の文書はGitHubのagentskills/agentskillsリポジトリにあります。寄贈ではagentskills.ioのドメインとGitHubの組織がAAIFに移ります。2026年10月26日の時点で、版の番号つきのリリースはまだありません。

参考にした公式情報

本記事は次の公式情報に基づきます(2026年10月23日8:10〜8:11と、10月26日17:12〜17:13、日本時間に取得)。内容は変わることがあるため、最新情報は各公式で確認してください。

Claude Codeの料金はClaude Codeの料金の記事に、Codex CLIで指示を固定するAGENTS.mdはCodex CLIの使い方にまとめています。

この件を自社の業務でどう扱うか、30分の無料オンライン相談(新しいウィンドウで開く)で一緒に整理できます。

自社の業務にどのAIツールの使い方が合うか、約3分で確かめる

全8問に答えると、AI 導入の準備度と、最初に試す活用アイデアがわかります。無料・登録不要です。

関連記事

すべてを表示