Agent Skills(SKILL.md)とは？32ツールが読む共通標準と書き方・MCPとの違い【2026年】

Agent Skills(SKILL.md)とは、AIエージェントに特定作業のやり方や専門知識をフォルダ単位で覚えさせるオープン標準です。中核は SKILL.md という1枚のファイルで、YAML frontmatter(name・descriptionが必須)とMarkdown本文からなり、必要に応じて scripts/(実行コード)・references/(詳細資料)・assets/(テンプレート)を同梱します。Anthropicが2025年10月に発表し、同年12月にツール横断のオープン標準として公開しました(出典: Anthropic Engineering・参照2026-07-18)。

「毎回同じ前提や手順をプロンプトに貼り直している」「指示が長くなりコンテキストを圧迫する」——こうした非効率を、再利用できる手順ファイルに切り出して解消するのがねらいです。2026年3月時点でClaude Code・Codex CLI・Cursor・GitHub Copilot・Antigravity CLI(旧Gemini CLI)など約32のツールが同じ SKILL.md を読み込みます(出典: agentskills.io・参照2026-07-18)。

本記事は特定のツールを勝たせる目的では書いていません。Agent Skillsはベンダー横断の標準であり、対応ツールは並列に紹介して優劣づけや当社サービスへの送客は行いません。数値・仕様はすべて公開一次情報に出典を付け、利点と同じ粒度で制約(実装差・配置場所の違い・セキュリティ上の注意)も併記します。

Agent Skills(SKILL.md)は、AIエージェントに作業手順・知識をフォルダ単位で持たせるオープン標準。最小構成は name・description をYAML frontmatterに書いた SKILL.md 1枚で、任意で scripts・references・assets を同梱する。Anthropicが2025年10月に発表・同年12月にオープン標準化し、2026年3月までに約32ツールが同一 SKILL.md を読む。MCP(外部接続)やフック(確定処理)とは役割が異なる別レイヤーで、スキルは「やり方・知識の外部化」を担う(出典: Anthropic Engineering／agentskills.io・参照2026-07-18)。

Agent Skills(SKILL.md)とは？仕組みを一言で

Agent Skillsは、汎用のAIエージェントを特定業務に「オンボード」するための共通フォーマットです。ツールごとにバラバラだった指示の与え方を、フォルダ1つにまとめた再利用可能な単位へ標準化します。

Agent Skillsの定義とSKILL.mdの中身

Agent Skillsとは、作業手順や専門知識をフォルダ単位でエージェントに持たせるオープン標準です。フォルダ直下に置く SKILL.md が本体で、YAML frontmatterと手順を書いたMarkdown本文からなります。コード実行が必要なら scripts/、詳しい資料は references/、雛形は assets/ に分けて同梱します。

項目	内容
標準名	Agent Skills(本体ファイルは SKILL.md)
最小構成	SKILL.md 1ファイル(YAML frontmatter＋Markdown本文)
任意の同梱物	scripts/・references/・assets/
発表元	Anthropic(2025年10月発表)
オープン標準化	2025年12月
対応数	約32ツール(2026年3月時点)

この早わかり表だけでも要点はつかめます(出典: Anthropic Engineering／agentskills.io・参照2026-07-18)。

Agent Skillsが解決する課題

従来はセッションごとに同じ前提や手順を貼り直す必要があり、プロンプトが肥大していました。Agent Skillsではエージェントが起動時に全スキルの name と description だけを読み、タスクに関連したときに本文を読み込みます(段階的読み込み)。ただし呼び出しは description の記述品質に依存し、曖昧だと関連タスクでも発火しない点は前提として押さえます(出典: Anthropic「Skills, explained」・参照2026-07-18)。

オープン標準になるまでの経緯【時系列】

公開情報で確認できる主な流れは次の通りです。

• 2025年10月: AnthropicがAgent SkillsをClaude向けに発表(出典: Anthropic Engineering・参照2026-07-18)
• 2025年12月: ツール横断のオープン標準として公開し、仕様を agentskills.io に集約(出典: agentskills.io・参照2026-07-18)
• 2026年3月: 約32ツールが同一 SKILL.md を読み込む状態に到達(出典: agentskills.io・参照2026-07-18)

標準化の直後から複数のベンダーが相次いで対応した経緯がありますが、各社の採用日は公開状況にばらつきがあるため、本記事では裏取りできる範囲にとどめます。

Agent Skills対応ツール一覧【提供元×採用時期】

どのツールが SKILL.md を読むのかを、提供元・既定の配置先・採用時期で横断整理します。列挙は並列で、優劣づけはしません。

主要対応ツール対応表(独自横断集計)

提供元	主なツール	既定のスキル配置先	採用時期
Anthropic	Claude Code	.claude/skills/	2025年10月(発表元)
OpenAI	Codex CLI・ChatGPT	各ツールのdocs参照	2025年12月〜
Microsoft	VS Code・GitHub Copilot	各ツールのdocs参照	2025年12月〜
Google	Antigravity CLI(旧Gemini CLI)	.agents/skills/	移行に伴い対応
AWS	Kiro	各ツールのdocs参照	2025年12月〜
JetBrains	Junie	各ツールのdocs参照	2025年12月〜
Block	Goose・OpenCode・Cursor 等	各ツールのdocs参照	2025年12月〜

約32ツールが対応し、agentskills.io のshowcaseでは約40製品が確認できます。配置先を確定情報として載せられるのは公式が明示しているものだけで、それ以外は各ツールのdocsで確認してください(出典: agentskills.io・参照2026-07-18)。

なぜ競合各社が同じ標準を読むのか・注意点

利点は相互運用性です。1つの SKILL.md が複数ツールで動くため、ベンダーロックインを避けやすく、作った資産を移行しても使い回せます。一方で注意点も同じだけあります。allowed-tools などは実験的でツール間の挙動が異なり、配置ディレクトリも .claude/skills/ と .agents/skills/ のように分かれます。「読む」の実装も自動発火と明示呼び出しで差があるため、標準準拠でも完全に同じ動作は保証されません(出典: Google Developers Blog／agentskills.io・参照2026-07-18)。用途別のMCP選定はおすすめMCPサーバー実践カタログも参考になります。

SKILL.mdの書き方と構成

最小構成は SKILL.md 1枚です。ここでは作り方の手順とfrontmatterの仕様、トークン設計を順に見ます。

ディレクトリ構成と書き方の手順

作成手順は次の通りです。(1)スキル名と同じ名前のフォルダを作る (2)直下に SKILL.md を置き name・description を書く (3)本文に手順・入出力例・エッジケースを書く (4)長い詳細は references/ に分け、本文は目安500行以内に収める (5)公式のバリデータで検証する (6)使うツールのスキル配置先に置く。Claude Code本体の設計指針はClaude Code ベストプラクティス集にまとめています(出典: agentskills.io/specification・参照2026-07-18)。

YAML frontmatter必須・任意フィールド仕様表(独自集計)

フィールド	必須/任意	上限・制約	役割
name	必須	最大64字・小文字英数とハイフン・親フォルダ名と一致	スキルの識別子
description	必須	最大1024字・「何をする/いつ使う」を明記	発火判断とキーワード
license	任意	表記のみ	ライセンス明示
compatibility	任意	最大500字	動作環境・前提
metadata	任意	任意キー値マップ	補助情報
allowed-tools	任意	空白区切り・実験的	使用可能ツールの制限

必須は name と description の2つだけです。name は先頭・末尾のハイフンや連続ハイフンが使えず、親フォルダ名と一致させます。description は「何をする/いつ使う」を具体的に書くほど発火精度が上がります(出典: agentskills.io/specification／Anthropic Platform Docs・参照2026-07-18)。

段階的読み込み(progressive disclosure)のトークン設計

スキルが増えてもコンテキストを圧迫しないよう、読み込みは3段階に分かれます。

段階	読み込む内容	目安
1. メタデータ	全スキルの name・description	約100トークン・起動時に一括
2. 本文	発火したスキルの SKILL.md 全体	推奨5,000トークン未満・500行以内
3. リソース	scripts・references・assets	必要時のみ読み込み

この設計により、多数のスキルを併存させつつ必要な分だけを展開できます。本文が長くなるほど発火時のコスト増につながるため、詳細は references/ へ外出しするのが定石です(出典: agentskills.io/specification・参照2026-07-18)。

SKILL.md・CLAUDE.md・MCP・フック・サブエージェントの使い分け

Agent Skillsは単独で完結する仕組みではなく、周辺の機能と役割を分担します。混同しやすい5つのレイヤーを1枚で整理します。

5レイヤー使い分け早見表(独自集計・中核)

レイヤー	役割	発火タイミング	スコープ
Agent Skills	手順・知識の外部化	関連時に自動または明示呼び出し	タスク単位(段階的ロード)
CLAUDE.md／AGENTS.md	常時の規約・前提	常時ロード	リポジトリ全体
MCP	外部システムへの接続	ツール呼び出し時	接続先単位
Hooks(フック)	確定処理の強制(推論なし)	特定イベント発火	イベント単位
Subagents	隔離文脈での作業委任	委任時	独立文脈

役割・発火・スコープを1枚で見比べると、どれを使うべきかが判断できます(出典: Anthropic「Skills, explained」／各公式docs・参照2026-07-18)。

スキルとMCP・フック・サブエージェントの違いを一言で

役割で覚えると迷いません。外部システムに繋ぐならMCP、やり方や知識を教えるならSkill、何があっても走らせたい確定処理ならHook、隔離した作業を任せるならSubagent、常時のルールならCLAUDE.md／AGENTS.mdです。特にスキルとMCPは競合しません。スキルの中に「MCPのツールをどう使うか」という手順を書けるため、MCPとは（仕組みと使いどころ）を土台に併用するのが基本です。Claude Codeでの実際の接続手順はClaude Code × MCP 連携ガイドで扱っています。

導入前に知っておく制約と注意点

便利さと同じ粒度で、無条件に安全ではない前提も押さえておきます。

実装差・scripts実行とセキュリティの注意

scripts/ に置く実行コードは、実質的に任意コード実行です。配布スキルやマーケットプレイス品は監査してから導入し、信頼できるものだけを使います。allowed-tools は実験段階でツール間の差があり、description の記述品質次第で過大なら誤発火・過小なら不発火が起きます。便利でも権限の最小化とレビューを前提にするのが安全です(出典: agentskills.io/specification／各公式docs・参照2026-07-18)。

標準の成熟度と今後の見通し

Agent Skillsは2025年10月発足・同年12月標準化と歴史が浅く、対応範囲や allowed-tools などのフィールドは流動的です。配置場所や自動発火の挙動もツール更新で変わります。実例として、Gemini CLIはAntigravity CLIへ移行し、スキルの配置先が .gemini/skills から .agents/skills へ変わりました(出典: Google Developers Blog・参照2026-07-18)。採用は広がっていますが、本番運用の前に各ツールの最新docsで挙動を確認するのが確実です。

まとめ

Agent Skills(SKILL.md)は、AIエージェントに手順と知識をフォルダ単位で持たせるオープン標準です。最小構成は name・description を書いた SKILL.md 1枚で、段階的読み込みによりスキルが増えてもコンテキストを圧迫しません。約32ツールが同じ標準を読む一方、配置先や発火の挙動には差があり、scripts の実行にはセキュリティ上の注意も伴います。MCP(接続)・Hook(確定処理)・Subagent(委任)・CLAUDE.md(常時ルール)と役割を分け、組み合わせて使うのが実務的な出発点です。

---

標準や開発の型という観点では、AIに開発手順を定義させる仕様駆動開発ツールの比較も同じ系統の話題です。スキルと役割が異なるMCPについてはMCPとは（仕組みと使いどころ）で仕組みから確認でき、Claude Code側の運用設計はClaude Code ベストプラクティス集で深掘りできます。