← 仕様一覧
SKILL.md — エージェントスキルのフォーマット
SKILL.md は、AI コーディングエージェントがオンデマンドで発見・起動できる再利用可能な機能をパッケージ化するためのオープン標準です。Anthropic が作成し、 agentskills.ioで標準化されたこのフォーマットは、Claude Code、Cursor、Codex、Gemini CLI、VS Code を含む 27 以上の AI エージェントに対応しています。
どんな問題を解決するのか？
スキルがなければ、PDF 生成・デザインシステムの構築・Playwright テストの作成など、エージェントに特定の作業をさせるたびに同じ複雑なプロンプトを繰り返す必要があります。SKILL.md はその手順を一度パッケージ化することで、対応エージェントが自動的に読み込めるようにします。スキルはオンデマンドで読み込まれるため、エージェントのコンテキストウィンドウを圧迫しません。
仕組み
スキルは、YAML フロントマターとマークダウンの手順が含まれる SKILL.md ファイルを持つフォルダです。最低限、スキルには名前と説明が必要です。
---
name: pdf-processing
description: Extract text and tables from PDF files,
merge documents, fill forms, and convert to images.
license: MIT
compatibility:
- Claude Code
- Cursor
allowed-tools: Bash(python:*) Read Write
---
# PDF Processing
When the user asks you to work with PDF files, follow
these instructions...
フロントマターフィールド
| フィールド | 必須 | 説明 |
|---|---|---|
| name | はい | 一意の識別子。最大 64 文字、小文字・数字・ハイフンのみ使用可。 |
| description | はい | スキルの内容と起動するタイミング。最大 1024 文字。 |
| license | いいえ | SPDX ライセンス識別子またはライセンスファイルへの参照。 |
| compatibility | いいえ | 対応エージェントと環境要件の一覧。 |
| metadata | いいえ | 任意のキーバリューペア（author、version、tags など）。 |
| allowed-tools | いいえ | エージェントに事前承認するツールのスペース区切りリスト。 |
プログレッシブディスクロージャー
スキルはコンテキストウィンドウを効率的に使うために、3 フェーズの読み込みモデルを採用しています：
- ディスカバリー — エージェントは名前と説明のみ読み込む（約 100 トークン）
- アクティベーション — タスクが一致した場合、SKILL.md 全体が読み込まれる（5000 トークン未満）
- 実行 — エージェントは手順に従い、必要に応じて参照ファイルを読み込む
対応エージェント
SKILL.md フォーマットは Claude Code、Cursor、OpenAI Codex、Gemini CLI、VS Code、GitHub Copilot、Amp、Roo Code、Goose、Windsurf、Continue などでサポートされています。対応エージェントの完全なリストは agentskills.io.