Claude Codeのような汎用AIエージェントは幅広いタスクをこなせますが、「プロジェクト固有の手順」や「組織のコンテキスト」は持っていません。この課題を解決するのがAgent Skillsです。
本記事では、Agent Skillsの概念・コンポーネント・中核ファイルであるSKILL.mdの具体的な構造と動作原理を解説します。
さらに2025年12月のオープンスタンダード化の背景、MCPとの違い、セキュリティ上の注意点まで網羅します。AIエージェントの再現性・品質を高めたい方はぜひ最後までお読みください。
なぜAgent Skillsが必要なのか
汎用エージェントは、コードの読み書き・テスト実行・ファイル操作など幅広いタスクをこなせます。しかし、「プロジェクト固有の手順」や「組織のコンテキスト」は持っていません。
たとえばPDF処理を依頼しても、Claudeはライブラリの選び方・フォーム入力の注意点・出力フォーマットの規約などを都度推測するしかなく、毎回品質がブレます。
Anthropicはこの課題を解決するためにAgent Skillsを設計しました。Skillは「新入社員向けオンボーディングガイドをエージェントに渡すこと」に例えられます。一度書けば、何度でも同じ専門知識でエージェントが動きます。
※オンボーディングガイド：新規プロジェクト参画者に迷わず、自立して、素早く業務を開始できる状態になるために必要な情報をまとめた資料のこと
Agent Skillsの概念とコンポーネント
Agent Skillsとは、エージェントが特定のタスクでより正確・効率的に動くよう、オンデマンドで発見・読み込める「指示・スクリプト・リソースの整理されたフォルダ」です。
主なコンポーネントは以下のとおりです。
- Skill（スキル）：SKILL.mdを含むディレクトリ。1タスク＝1スキルの単位でパッケージ化。
- SKILL.md：スキルの心臓部。YAMLフロントマター＋Markdownによる指示書。Claudeがこれを読んで行動する。
- スクリプト類：スキル内に置いたPythonなどのコード。Claudeが必要に応じて実行する。
- 参照ファイル：forms.md・reference.mdなど。SKILL.mdから参照され、必要なときだけ読み込まれる。
PDFスキルを例にした典型的なディレクトリ構成は次のとおりです。
pdf/
├── SKILL.md # 中核ファイル（必須）
├── reference.md # 参照ドキュメント（オンデマンド）
├── forms.md # フォーム処理手順（オンデマンド）
└── extract_form.py # Claudeが実行するスクリプトSkillは「汎用エージェント → 専門エージェント」への変換装置です。組織・チーム・個人それぞれが自分のノウハウをSkillとしてパッケージ化することで、再現性のあるAI活用が実現します。
SKILL.mdの構造と3層Progressive Disclosure
Agent Skillsの最大の特徴がProgressive Disclosure（段階的開示）というアーキテクチャです。
Claudeは情報を一度に全部読むのではなく、必要な段階に応じて少しずつ読み込みます。これにより、コンテキストウィンドウを効率的に使いながら、実質無制限の規模の知識を扱えます。
SKILL.mdの実際の記述フォーマットは以下のとおりです。
---
name: pdf-processing
description: PDFファイルの操作、テキスト抽出、フォーム入力、ページ結合。
PDFやフォームを扱う際に使用すること。
---
# PDF Processing
## Quick start
pdfplumberを使ってPDFからテキストを抽出します：
```python
import pdfplumber
with pdfplumber.open("document.pdf") as pdf:
text = "n".join(page.extract_text() for page in pdf.pages)
```
## フォーム入力の場合
フォームへの入力が必要な場合は @forms.md を参照してください。
## 注意事項
- スキャンPDFにはOCRが必要。extract_form.pyスクリプトを使用すること
- 出力ファイルは output/ ディレクトリに保存することnameとdescriptionが最重要です。Claudeはこの2つだけを見て「このスキルを使うべきか」を判断します。descriptionには「いつ使うか」を具体的に書くことがポイントです。
Skillの実行ライフサイクル
ユーザーがPDF処理を依頼してからSkillが実行されるまでの流れを追ってみましょう。
- 起動時：メタデータをシステムプロンプトに注入
インストールされた全スキルのname・descriptionだけがシステムプロンプトに追加される。「こんなスキルが使える」という一覧表として機能する。トークン消費は最小限。 - ユーザー指示受け取り
“このPDFのフォームを埋めてください” という指示が来る。 - スキルのマッチング判定
Claudeがdescriptionと照らし合わせて「pdf-processingスキルが必要」と判断。Bashツールでpdf/SKILL.mdを読み込む。 - 追加ファイルの読み込み（必要な場合）
「フォーム入力」が必要と判断し、forms.mdをさらに読み込む。関係のないreference.mdは読まない。 - タスク実行
Skillから得た指示に従い、extract_form.pyスクリプトを実行してPDFのフォームフィールドを特定・入力する。
コード実行との統合
Skillはテキスト指示だけでなく、実行可能なコードも含められます。処理の種類によって担当を分けることで、柔軟性と正確さを両立します。
| 処理タイプ | 担当 | 理由 |
|---|---|---|
| 「何をどう処理するか」判断 | Claude（LLM） | 自然言語理解・文脈判断が得意 |
| ソート・計算・フォーム抽出 | Pythonスクリプト | 決定論的な正確さが必要 |
| エラー処理・リトライ判断 | Claude（LLM） | 状況に応じた柔軟な対応 |
スクリプトはコンテキストに読み込まずに実行できます。コードとPDFをコンテキストに入れる必要がないため、大きなファイルも効率よく処理できます。
利用できるプラットフォーム
| プラットフォーム | Skillの種類 | 導入方法 |
|---|---|---|
| claude.ai | Anthropic提供 + カスタム | Settings → Skills で有効化 |
| Claude Code | カスタムSkillのみ | .claude/skills/ に配置 |
| Claude API | Anthropic提供 + カスタム | container.skills で指定 |
Anthropicが提供するプリビルトSkillは以下のとおりです。
- Excel（xlsx）
- Word（docx）
- PowerPoint（pptx）
パートナー企業のSkill（2026年3月時点）としては、Atlassian（Jira/Confluence）・Figma・Canva・Cloudflare・Notion・Ramp・Sentryなどが提供されています。
オープンスタンダード化（2025年12月）
2025年12月18日、AnthropicはAgent Skillsの仕様をオープンスタンダードとして公開しました（agentskills.io）。
- ポータビリティ：Claude向けに作ったSkillが、他のAgent対応ツールでもそのまま使える。ベンダーロックインを排除。
- エコシステム拡張：Cursor・Windsurf・OpenAI CLIなど多数のツールが採用。
- エンタープライズ管理：Team・Enterprise管理者が組織全体のSkill利用を一元管理できる。
MCPが「エージェントにツール（外部API）を繋ぐ仕組み」であるのに対し、Agent Skillsは「エージェントに手順書・専門知識を渡す仕組み」です。両者は競合ではなく補完関係にあります。
Agent SkillsとMCPの違い
| 観点 | Agent Skills | MCP（Model Context Protocol） |
|---|---|---|
| 目的 | 手順書・専門知識を渡す | 外部ツール・APIを繋ぐ |
| 形式 | フォルダ（ファイル群） | サーバー（HTTP / stdio） |
| 実行 | コンテキスト注入＋スクリプト | MCPサーバーへのリモート呼び出し |
| 適したユースケース | 組織固有の業務フロー | Slack通知・DB検索・外部API連携 |
例として「Jiraチケットを取得してプレゼン資料を作る」タスクでは、JiraアクセスにはMCP、PowerPoint作成にはAgent Skills（pptx）を組み合わせて使います。
SKILL.mdの作り方・ベストプラクティス
最小限のSKILL.mdテンプレートは以下のとおりです。
---
name: my-skill-name
description: このスキルが何をするか、いつ使うかの明確な説明。
例：CSVデータのクリーニングと集計。データ整形や
集計を依頼された際に使用すること。
---
# スキルのタイトル
## 基本手順
ここにClaudeが従う指示を書く。
## 注意事項
- 守るべきルール
## 詳細な手順が必要な場合
詳細は @advanced.md を参照すること。効果的なSkillを作るための4原則は以下のとおりです。
- descriptionから書く：Claudeはdescriptionでスキルをトリガーします。「いつ使うか」を具体的・明確に書くことが最重要。
- コアをシンプルに保つ：SKILL.md本文が肥大化したら、別ファイルに切り出してSKILL.mdから参照する。例）「詳細は @advanced.md を参照すること。」
- 実際に動かして改善する：Claudeにスキルを使って作業させながら改善を重ねる。
/initコマンドでも雛形生成が可能。 - バージョン管理に含める：Skillディレクトリをgit管理することでチーム全体で共有できる。
セキュリティ上の注意点
Skillはコードを含むため、悪意のあるSkillはデータ流出・不正なシステムアクセスを引き起こす可能性があります。必ず信頼できるソースのSkillのみ使用してください。
不明なソースのSkillを使う場合の確認事項は以下のとおりです。
- SKILL.md・スクリプト・画像など全ファイルの内容を確認する
- 意図しない外部ネットワーク接続がないか確認する
- EnterpriseではAdminでSkill利用を一元管理する
まとめ
- Agent Skillsとは、汎用エージェントを専門エージェントに変換する「知識パッケージ」の仕組みです。Skillはフォルダ単位で管理されます。
- SKILL.mdとは、Agent Skillsの中核ファイルです。YAMLフロントマター（メタデータ）＋Markdown本文で構成されます。
- Progressive Disclosureとは、情報を3層に分けて段階的に読み込む設計思想です。コンテキストウィンドウを効率的に使い、実質無制限の規模を実現します。
- オープンスタンダードとして2025年12月にagentskills.ioで公開され、Claude以外のAIツールでも同じSKILL.mdが使えます。
参考リソース
- Equipping agents for the real world with Agent Skills（Anthropicエンジニアリングブログ）：Agent Skillsの設計思想・Progressive Disclosure・実装例の詳細解説
- Agent Skills概要（Claude API公式ドキュメント）：APIからのSkill利用・セキュリティ注意事項の公式ガイド
- agentskills.io — Agent Skillsオープンスタンダード：SKILL.mdフォーマット仕様・クライアント実装ガイド
- anthropics/skills（GitHub）：AnthropicによるSkillサンプル集。SKILL.mdの書き方の参考に
- Agent Skills: Anthropic’s Next Bid to Define AI Standards（The New Stack）：オープンスタンダード化の背景とエコシステムへの影響の詳細分析
コメント