Agent Skillsとは？Claude Codeのスキルが標準団体へ。CodexでもSKILL.mdが動くか実測

Agent Skillsとは？Claude Codeの「スキル」との関係

Agent Skillsは、SKILL.md というファイルを含むフォルダで、AIエージェントに「手順」と「資料」を渡すためのオープン仕様です。Anthropicが2025年10月にClaude Codeの機能として始め、同年12月にオープン標準として公開しました。Claude Codeで / から呼び出す「スキル」は、この仕様にClaude Code独自の拡張を足したものです。

仕様（agentskills.io の Specification、2026年10月25日確認）が定める中身は小さく、フォルダに SKILL.md を1つ置けば成立します。SKILL.md の先頭に YAML のフロントマターを書き、その下に Markdown で手順を書きます。フロントマターで必須なのは name（64字以内、小文字の英数字とハイフン、親フォルダ名と一致）と description（1,024字以内）の2つだけで、任意項目は license・compatibility（500字以内）・metadata・allowed-tools（実験的）の4つです。同じフォルダに scripts/（実行するコード）、references/（判断基準などの資料）、assets/（テンプレート）を置けます。

Anthropicのエンジニアリングブログ（Equipping agents for the real world with Agent Skills、2025年10月16日、Barry Zhang・Keith Lazuka・Mahesh Murag）は、スキルを「SKILL.md を含むディレクトリ」と定義し、読み込みを3段階に分けると説明しています。仕様はこれを「段階的開示」と呼び、目安の数字も示しています。

スキルは「社内ルールを常に覚えさせる」CLAUDE.md とは役割が違います。CLAUDE.md が毎回読まれる前提知識なのに対し、スキルは必要なときだけ呼ばれる作業手順です。この使い分けはCLAUDE.mdとskillsの使い分けガイドで詳しく書きました。本記事はその先、「書いたスキルが Claude Code の外でも使えるか」を扱います。

2026年10月22日に何が起きたのか？Agentic AI Foundationへの寄贈

Anthropicは2026年10月22日、Agent Skills の名称・ロゴ・GitHub組織・agentskills.io ドメイン・仕様そのものを、Linux Foundation傘下の Agentic AI Foundation（AAIF）へ寄贈すると発表しました（公式発表）。AAIFはAnthropic・Block・OpenAIが2025年12月に共同で設立した団体で、Anthropicはすでに MCP（Model Context Protocol）を寄贈しています。

発表に添えられた数字は次のとおりです。いずれもAnthropicの自己申告で、外部が再集計したものではありません。

運営の形も決まっています。公式発表によれば、保守はAnthropic・Google・OpenAIなどのエンジニアが個人として担い、Lead MaintainersはDavid Soria Parra氏とMahesh Murag氏です。Anthropic公式アカウント @ClaudeDevs の告知スレッドは、技術運営委員会（Technical Steering Committee）をAnthropic・Earendil (Pi)・Google・Microsoft・OpenAI・OpenCodeのエンジニアで構成すると述べ、最初の優先事項として「番号付きの版」「正式な提案手続き」「スキルの作者と利用者向けの安全指針」の3つを挙げています。

Claude Codeを作ったBoris Cherny氏（Anthropic）は、寄贈の動機を次のように書いています。

「Agent Skills は Claude Code での実験として始まりました。業界の多くが採用するようになったので、私たち Anthropic は MCP の隣に置くかたちで AAIF へ寄贈するのがふさわしいと考えました。」

"Agent Skills started as an experiment in Claude Code. Many across the industry have come to adopt it, so we at Anthropic found it more fitting to donate it to the @AgenticAIFdn, next to MCP."

Boris Cherny（Anthropic・Claude Code 開発者）— X の投稿（2026年10月23日 JST）

反響は大きく、@ClaudeDevs の告知は2026年10月25日時点で表示92.1万・いいね8.6K・ブックマーク2.5K、Cherny氏の投稿は表示25.9万・いいね2.5Kでした（当研究所がログアウト状態のブラウザで取得）。独立開発者のSimon Willison氏は同日のブログで、2025年12月にスキルが「オープン標準」と呼ばれた時点で「AAIF に行き着いても驚かない」と書いていたことを紹介しています。一方、日本語でこの寄贈を解説した記事は、2026年10月25日時点の検索では見つかりませんでした。

寄贈でClaude Codeのスキルは何が変わり、何が変わらないのか？

結論は、手元のスキルは何も変えなくてよく、変わるのは「仕様を誰が決めるか」と「これから付く版番号と安全指針」です。@ClaudeDevs は「あなたのスキルはそのまま動き、ライセンスも変わらない。AAIF に加入しなくても仕様を使い、貢献できる」と明言しています。仕様の中身も、寄贈の前後で変わっていません。

変わらないものの中で、業務で使う人が押さえておきたい点が2つあります。1つ目は、Claude Code独自の拡張フィールドは引き続きClaude Codeだけのものだという点です。Claude Codeのドキュメント（Skills、2026年10月25日確認）によれば、Claude Codeは仕様の6項目に加えて disable-model-invocation（自動呼び出しを止める）、user-invocable、argument-hint、context: fork（サブエージェントで実行）、hooks、paths、model、effort などを受け付けます。そして「Claude Code の外（claude.ai へのアップロードや Skills API）では name・description・license・compatibility・metadata・allowed-tools 以外のフィールドはアップロード時にハードエラーになる」と書かれています。拡張を使うほど、そのスキルはClaude Code専用になります。

2つ目は、ベンダー中立になったことで「業務手順をスキルとして書く」投資が、特定のツールに縛られにくくなった点です。士業事務所やバックオフィスが「申請書類の添付チェック」「月次報告の型」「入金の消込」のような手順をフォルダに書いておけば、今日はClaude Code、来年は別のエージェント、という移行が理屈の上では可能になります。ただし「理屈の上では」であって、実際に動くかどうかは次の2節で確かめます。

これから変わるものは、技術運営委員会のロードマップにある3点です。「番号付きの版」が出れば、スキルがどの版の仕様で書かれたかを示せるようになります。「正式な提案手続き」は、Anthropic以外の実装者が仕様の変更を提案する入口です。そして「安全指針」は、後述するSnykの調査が示した問題への対応になります。公式発表は「MCP と同じく、コミュニティの意見と透明な意思決定を優先する」としています。

手元の101個のスキルは標準に通るのか？skills-refで検査した結果

当研究所の手元にあるスキル101個を仕様の検査ツールにかけたところ、72個が合格し、29個が標準外でした。標準外の理由は、descriptionの1,024字超えが9件、Claude Code独自の disable-model-invocation が9件、argument-hint が3件、Cursor独自の environments と disabled-environments が計6件です（1つのスキルに複数の理由があるものを含みます）。

検査ツールは、仕様と同じリポジトリで公開されている参照実装 skills-ref（0.1.0、Python）です。README は「デモ目的で、本番向けではない」と断っていますが、仕様のページが「スキルの検証に使う」と案内しているので、現行仕様の最も素直な判定器といえます。導入と実行は次のとおりです。

git clone --depth 1 https://github.com/agentskills/agentskills.git
cd agentskills/skills-ref && uv sync
.venv/bin/skills-ref validate ~/.claude/skills/k
# Validation failed for ~/.claude/skills/k:
#   - Unexpected fields in frontmatter: argument-hint, disable-model-invocation.
#     Only ['allowed-tools', 'compatibility', 'description', 'license', 'metadata', 'name'] are allowed.

検査した101個の内訳と結果は次のとおりです。

同じフォルダをClaude Code自身の検査コマンド claude plugin validate（v2.1.233以降）に通すと、Claude Code独自フィールド入りも含めてすべて合格しました。Claude Codeの検査は自分の拡張を含めた「Claude Codeで動くか」を見ており、skills-refは「仕様どおりか」を見ています。両方に通して初めて「どこでも動き、Claude Codeでも動く」と言えます。なお claude plugin validate にスキルのフォルダを1つだけ渡すと「No manifest found」で失敗するので、スキル群を含むディレクトリ（.claude/skills など）を渡します。

意外だったのは、Anthropic製のスキルにも他の実装が読めないものがあったことです。後述するCodexの実行ログには、Codexが取り込んでいたAnthropic製の schedule スキルを「YAMLが不正」として読み飛ばした記録が残っていました。descriptionを二重引用符で囲んだ中に、さらに二重引用符が入っていたためです。Claude Codeはこの書き方を受け付けますが、Codexの厳密なYAML解析は受け付けません。agentskills.io の実装ガイドは「他のクライアント向けに書かれたスキルには、技術的に不正なYAMLが混ざる。引用符で包み直すなどの救済を検討せよ」と注意しており、実装によって扱いが分かれる部分です。

同じSKILL.mdはClaude CodeとCodexで動くのか？6回の実測

同じスキルフォルダを置き場所と依頼文を変えて6回動かした結果、Codexは共通の置き場所 .agents/skills のスキルを自動で選んで正しく処理し、Claude Codeは .agents/skills を読まず、.claude/skills に置いた場合も依頼文に業務の言葉がなければ自動では呼びませんでした。答えの正しさは6回とも9項目すべて正解で、スキルの有無で差は出ませんでした。

検証の設計

題材は、バックオフィスで毎月発生する「請求台帳と入金明細の消込」です。架空の事務所の請求8件（invoices.csv）と銀行の入金7件（bank.csv）を用意し、9つの正解を仕込みました。請求番号が摘要に入った入金3件、番号はないが名義と金額で一致する入金2件、振込手数料分の660円が足りない入金1件、期限を17日過ぎて入った入金1件、期限を20日過ぎた未入金（督促候補）1件、期限前の未入金1件、そして台帳にない名義からの110,000円の入金1件です。最後の1件は期限前の請求と金額が同じで、名義を見ずに金額だけで消し込むと誤りになる罠です。

スキル invoice-reconcile は仕様の範囲だけで書きました。フロントマターは name・description・license・metadata の4項目、本文は39行で、「scripts/reconcile.py を実行して候補を出す」「references/rules.md の分類ルールで4つに分ける」「5節構成で報告する」「送金・督促メールの送信・台帳の書き換えはしない」の4点です。スクリプトは請求番号と金額で候補を機械的に出し、名義の一致や手数料差の判断はエージェントに残しました。

---
name: invoice-reconcile
description: 請求台帳（invoices.csv）と銀行の入金明細（bank.csv）を照合し、入金済み・金額相違・未入金・請求のない入金を分類して報告する。入金確認、消込、未入金の洗い出し、督促前の確認、入金状況のチェックを頼まれたときに使う。Use when asked to reconcile invoices against bank deposits, check payment status, or find unpaid invoices.
license: Apache-2.0
metadata:
  author: claude-code-lab
  version: "1.0"
---

# 請求と入金の照合（消込）

## 手順
1. scripts/reconcile.py を実行する（引数は2つのCSVと基準日）。
   match_by が number のものは確定、amount のものは名義の確認が要る。
2. references/rules.md の分類ルールで、入金済・金額相違・未入金・請求のない入金に分ける。
3. 入金済／金額相違／未入金（督促候補・期限前）／請求のない入金／次のアクション の順で報告する。

## 禁止事項
- 送金、振込、督促メールの送信はしない。CSVや台帳を書き換えない。
- 金額だけが一致した候補を、名義を確認せずに「入金済」にしない。

実行環境は、Claude Code v2.1.310（モデルは Sonnet 5.5 固定、claude -p の無人実行、許可ツールは Read・Glob・Grep・Skill と Bash(python3 *) のみ）と、OpenAI の Codex CLI 0.164.0（codex exec、workspace-write サンドボックス、モデルは当研究所の設定ファイルの既定値）です。依頼文は「data フォルダの請求台帳 invoices.csv と入金明細 bank.csv を見て、入金状況を確認してください。督促が必要な取引先があれば理由も教えてください。今日は2026年10月25日です」で、スキル名も「消込」の語も入れていません。

結果

読み取れることは4つあります。

所要時間と費用も記録しました。Claude Codeはスキルを使わない2回が約14秒・約$0.106、スキルを使った2回が18〜19秒・$0.114〜0.122で、スキル本文とスクリプト実行の分だけ増えています。Codexは2回とも約41秒でした。モデルも課金体系も違うので速さや安さの比較ではなく、「どちらも1分以内に終わる」程度の目安として読んでください。

ここで押さえておきたいのは、各エージェントがスキルをどこから読むかです。公式ドキュメントから、2026年10月25日時点の対応をまとめました。

agentskills.io の実装ガイドは、エージェントの実装者に「自社固有のフォルダに加えて .agents/skills/ を読むこと」を勧め、「多くの既存スキルがそこにあるため .claude/skills/ も読む実装がある」と補足しています。表を見ると、Claude Code以外の4つはすべて .agents/skills を読み、CursorとCopilotは .claude/skills も読みます。仕様の生みの親であるClaude Codeが、共通フォルダに関しては最も保守的という構図です。

士業・バックオフィスはどう書けばいいのか？持ち運べるスキルの作り方

結論は、フロントマターは name と description を中心に仕様の6項目だけで書き、判断基準を references に、計算を scripts に分け、公開前に2つの検査に通すことです。今回の消込スキルはこの形で、Claude CodeとCodexの両方でそのまま動きました。手順を5つにまとめます。

権限の設計も持ち運びを前提に考えます。今回のスキルは「送金・送信・台帳の書き換えをしない」と本文に書きましたが、本文の禁止事項は守られる保証がない指示です。Claude Codeでは --allowedTools で Read・Glob・Grep・Skill と Bash(python3 *) だけを許可し、Codexでは workspace-write のサンドボックスで実行しました。スキル本文の「しない」と、エージェント側の「できない」を両方そろえる考え方は、権限設定ガードレールの作り方で整理しています。仕様の allowed-tools は実験的で、実装ごとに解釈が違うため、これだけに頼らないでください。

他人が作ったスキルを入れるときは、読んでから入れます。スキルはエージェントの権限をそのまま使うので、SKILL.md に書かれた「次のURLからダウンロードして実行せよ」という一行が、そのまま実行され得ます。Snykが2026年2月5日に公開した調査（ToxicSkills）は、ClawHub と skills.sh に公開されていた3,984個のスキルを監査し、13.4%にあたる534個に重大な問題、76個に悪意ある内容を確認しました。悪意あるものの91%はプロンプトインジェクションを使い、外部からのマルウェア取得、認証情報の送信、安全機能の無効化が主な手口でした。技術運営委員会が「安全指針」を最初の優先事項に入れたのは、この状況への対応です。指針が出るまでは、agentskills.io の実装ガイドが勧める「信頼していないリポジトリのスキルは読み込まない」運用と、入れる前に SKILL.md と scripts を自分の目で読むことが対策になります。

当研究所の見解では、士業事務所やバックオフィスがスキルを書く最初の題材は、今回のような「毎月同じ手順で、判断基準が言葉にできる作業」が向いています。消込のほかに、許可申請の添付書類チェック、契約書の必須条項の確認、月次報告書の型などです。手順を SKILL.md に、基準を rules.md に書き出す作業そのものが業務の棚卸しになり、書いた資産はエージェントを替えても持ち運べます。Claude Codeの入門ガイドから始めた方は、まず1つのスキルを .claude/skills に置いて明示呼び出しで動かし、次に description を磨いて自動発火を確かめる、という順番が確実です。

限界と注意点

この記事の実測には次の限界があります。

まとめ