0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Claude Skills──OpenAIが先回り実装していたSKILL.md極小標準

0
Posted at

2025年12月18日、AnthropicがClaude Skills(Agent Skills)をオープン標準化した。同日にMicrosoftがGitHub Copilotで対応を発表し、その6日前にはOpenAIがChatGPTとCodex CLIに同じSKILL.md形式を密かに実装していたことがElias Judin氏により発見されていた。直接の競合関係にある大手3社が、Anthropicのオープン標準化の前後数日で同じファイル形式に集まった格好だ。2026年3月時点で32ツールが対応し、5月にはVercelのマーケットプレイスskills.shに約40万件のskillsが登録──npmが約7年(2017年1月時点)で到達した35万件規模を約4ヶ月で抜いた数だ。中身はSKILL.mdというファイル形式で、フォルダにYAML付きMarkdownを1枚置くだけの極小仕様。なぜここまで広がり、設計のどこが効いているのか読み解く。

フォルダにMarkdownを1枚置くだけ──SKILL.mdの中身

Skillはエージェントに「特定のタスクをこう進めて」と渡すための入れ物だ。最小単位はフォルダ1つ。中にSKILL.mdを置き、必要なら補助スクリプトや参考資料を同じ階層に並べる。中身はYAMLメタデータと指示文だけで、必須フィールドはnamedescriptionの2つしかない(agentskills.io公式仕様より)。

ディレクトリ構造と最小例は次の通り。

pdf-processing/
├── SKILL.md          # YAML frontmatter + 指示文(必須)
├── scripts/          # 実行可能コード(任意)
├── references/       # 詳細仕様(任意)
└── assets/           # テンプレート・画像(任意)
---
name: pdf-processing
description: Extract PDF text, fill forms, merge files. Use when handling PDFs.
license: Apache-2.0
metadata:
  author: example-org
  version: "1.0"
---

# PDF Processing

## Steps
1. Read the PDF using scripts/extract.py
2. Parse tables with the helper in references/REFERENCE.md
3. Output the result as markdown

これだけで1スキルが完成する。setup.pyもなく、Dockerfileも要らない。著名な独立エンジニアのSimon Willisonはこの仕様を「deliciously tiny(うっとりするほど小さい)」と評しつつ、「quite heavily under-specified(かなり仕様不足)」とも書いている。

3階層 Progressive Disclosure がコンテキスト圧を解いている

設計の中核は、情報を3段階に分けて読み込む仕組みだ。Anthropicはこれをprogressive disclosure(段階的開示)と呼ぶ。

  1. 第1階層・メタデータ(常時):namedescriptionだけがエージェント起動時に読まれる。1スキル約100トークンで、50スキル入れても合計5,000トークン程度(agentskills.io公式仕様より)
  2. 第2階層・SKILL.md本体(発動時):エージェントが「このskillを使う」と判断した瞬間に本文が読まれる。Anthropic公式17 skillsの中央値で約2,000トークン(SwirlAI Newsletterの独立分析より)
  3. 第3階層・補助リソース(必要時):scripts/references/内のファイルは本体から参照された時だけ読まれる

ここが既存手法と決定的に違う。MCP(Model Context Protocol)で90ツール以上を登録するとJSONスキーマだけで5万トークン以上を占有する(SwirlAI Newsletterの分析より)が、Skillsは50スキル入れても起動時5,000トークン。本に例えるなら「目次を見て必要な章だけ開き、付録は最後に読む」という読み方をエージェントにさせる発想だ。

効果はRakutenの公式コメントに数字が出ている。同社AI担当ジェネラルマネージャーのYusuke Kaji氏はAnthropicブログで「Claudeが複数のスプレッドシートを処理し、私たちの手順に従ってレポートを生成する。1日かかっていた作業が1時間で終わる」と述べている。約87%の時間削減に相当する。

MCPと混同されがちだが、解いている問題が違う

同じAnthropicが作るMCPとSkillsはよく混同される。MCPは「GitHubやSlackなど外部サービスへの接続」、Skillsは「接続後にそのツールをどう使い、どんな手順で仕事を進めるか」を解く別物だ。MCPが「何ができるか」、Skillsが「どう進めるか」を渡す。両者は補完関係で、MCPでGitHubに繋ぎ、Skillsで「社内コードレビュー規約に沿った指摘の出し方」を覚えさせる、といった組み合わせが自然だ。

標準化前後で大手3社が揃った異例の速さ

時系列で並べると、標準化前後の動きの異例さが見える。

  • 2025年12月12日(発見):OpenAIがChatGPTとCodex CLIに同じSKILL.md形式を密かに実装していたことがElias Judin氏により発見、Simon Willisonが追検証
  • 2025年12月18日:AnthropicがSkills仕様をagentskills.ioでオープン化、リファレンスSDKも公開。同日GitHub CopilotもAgent Skills対応を発表(GitHub Changelog)
  • 2026年1月8日:Microsoft VS Code 1.108(stable)がAgent Skills対応
  • 2026年3月時点:Cursor、Block Goose、Gemini CLI、JetBrains Junie、AWS Kiroを含む32ツールが対応(Paperclipped集計)
  • 2026年5月時点:skills.shに約40万件のskillsが登録

OpenAIの採用は公式発表を伴わない"quiet adoption"で、The Decoder紙は「OpenAI quietly adopts Anthropic's modular skills framework」と報じた。直接の競合関係にあるOpenAIとMicrosoftが、Anthropicのオープン標準化の前後数日で同じファイル形式に集まったのはAIインフラ業界では珍しい光景で、公式リポジトリanthropics/skillsは5月時点で約139Kスターに達している。

なお各ツールでskillsを置くパスは違う。Claude Codeは~/.claude/skills/、OpenAI Codexは~/.agents/skills/(またはリポジトリ内の.agents/skills)、Geminiは~/.gemini/antigravity/skills/。「ファイル形式は揃ったが、配置までは標準化されていない」点には注意したい。

400人全員がClaude Codeを使う米ヘッジファンドの中身

ここまで仕様と標準化の話をしてきたが、実運用で何が起きているかを示す好例が米ヘッジファンドのWalleye Capitalだ。Anthropic公式ブログによれば、従業員約400人の全員がClaude Codeを業務で利用しており、ピッチブック作成、決算レビュー、KYC審査、月次決算、評価レビューなど、Anthropicが提供する10種類の財務テンプレート(skillsベース)を業務フローに組み込んでいる。

400人組織で100%採用というのは、企業向けAIツールの導入事例で他にあまり見ない数字だ。普通AIの社内浸透率は数十%で頭打ちになる。Walleyeのケースが示しているのは、AIに何ができるかを一人ずつ教えるのではなく、業務手順そのものをskillとして配ることで誰が使っても同じ品質の仕事が回るようになる、という採用の作り方だ。Skillsの「ファイル1枚置くだけ」という極小さが、社内で配るときの摩擦をほとんどゼロにしている。

「何ができるか」より「どう進めるか」を渡す

Skillsの設計には「フォルダにmarkdownを置くだけ」という驚くほど素朴な姿勢が貫かれている。だがその極小さが、標準化前後の短期間で競合OpenAIを含む大手3社、5ヶ月で32ツール、そしてWalleye Capital全社採用という規模を生んだ。社内にAIエージェントを入れたいなら、まずは既存のチェックリストやコーディング規約を1枚SKILL.mdに書いてGitにコミットしてみることから始められる。「何ができるか」を機能で説明するより、「どう進めるか」を手順で渡す方が、エージェントは仕事をする。次にこの方式で標準化されるのは、何の「動かし方」だろうか。

参考になる公式情報・解説

  1. Anthropic公式ブログ - Claude Skillsローンチ記事(Box/Canva/Notion/Rakutenのexecutive quote、2025年10月16日ローンチ・12月18日オープン標準化) - https://claude.com/blog/skills
  2. Anthropic Engineering - Equipping agents for the real world with Agent Skills - https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills
  3. agentskills.io - 公式仕様(YAML frontmatter、ディレクトリ構造、progressive disclosure詳細) - https://agentskills.io/specification
  4. GitHub anthropics/skills - 公式リポジトリ(約139Kスター・16.3Kフォーク) - https://github.com/anthropics/skills
  5. Anthropic公式 - Finance Agents(Walleye Capital 100%採用、10種類の財務テンプレート) - https://www.anthropic.com/news/finance-agents
  6. Anthropic公式 - New in Claude Managed Agents(Netflix multiagentでhundreds of buildsを並列解析、Harvey/Wisedocs他) - https://claude.com/blog/new-in-claude-managed-agents
  7. Anthropic公式 - Financial services solutions(Citadel/BNY/Mizuhoの具体的な使い方) - https://claude.com/solutions/financial-services
  8. Simon Willison's blog - Agent Skills(2025年12月19日、「deliciously tiny」「under-specified」評価) - https://simonwillison.net/2025/Dec/19/agent-skills/
  9. Simon Willison's blog - OpenAI are quietly adopting skills(2025年12月12日、Elias Judin氏の発見の追検証) - https://simonwillison.net/2025/Dec/12/openai-skills/
  10. The Decoder - OpenAI quietly adopts Anthropic's modular skills framework(2025年12月13日) - https://the-decoder.com/openai-quietly-adopts-anthropics-modular-skills-framework-to-boost-agent-capabilities/
  11. Winbuzzer - OpenAI adds Skills framework to ChatGPT and Codex CLI(2025年12月13日) - https://winbuzzer.com/2025/12/13/openai-adds-skills-framework-to-chatgpt-and-codex-cli-mirroring-anthropics-agent-standard-xcxwbn/
  12. GitHub Changelog - GitHub Copilot now supports Agent Skills(2025年12月18日) - https://github.blog/changelog/2025-12-18-github-copilot-now-supports-agent-skills/
  13. Vercel changelog - Introducing skills(skills.shローンチ・18+対応エージェント一覧、2026年1月20日) - https://vercel.com/changelog/introducing-skills-the-open-agent-skills-ecosystem
  14. skills.sh - Vercel運営のAgent Skills Directory(All Time 約40万skills登録) - https://www.skills.sh/
  15. Paperclipped - Agent Skills 32ツール採用一覧と各ツールのインストールパス(2026年3月23日) - https://www.paperclipped.de/en/blog/agent-skills-open-standard-interoperability/
  16. SwirlAI Newsletter - Agent Skills: Progressive Disclosure as a System Design Pattern(MCP 90+ toolsで50,000+トークン、Anthropic公式17 skillsで合計約1,700トークン・本体中央値約2,000トークン) - https://www.newsletter.swirlai.com/p/agent-skills-progressive-disclosure
  17. OpenAI developers docs - Codex Skills(.agents/skillsパス公式定義) - https://developers.openai.com/codex/skills
  18. SiliconANGLE - Anthropic makes agent Skills an open standard - https://siliconangle.com/2025/12/18/anthropic-makes-agent-skills-open-standard/
  19. IntuitionLabs - Claude Skills vs MCP: A Technical Comparison - https://intuitionlabs.ai/articles/claude-skills-vs-mcp
  20. Cato Networks - Weaponizing Claude Skills with MedusaLocker(セキュリティ懸念) - https://www.catonetworks.com/blog/cato-ctrl-weaponizing-claude-skills-with-medusalocker/
0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?