Claude Code Skillsの全体像 ― 仕組み・作り方・実践テンプレートまとめ

「毎回同じ指示をClaude Codeに伝えるのが面倒」「プロジェクト固有のルールを自動で反映させたい」――こうした課題を解決する仕組みが Agent Skills(エージェントスキル) です。 Anthropicが2025年10月16日に発表し、同年12月18日にオープンスタンダードとして仕様を公開したこの機能は、Claude Codeだけでなく OpenAI Codex CLI・Cursor・VS Code・GitHub Copilot・Gemini CLI をはじめ27以上のAIコーディングツールで採用が広がっています(出典: agentskills.io)。GitHubリポジトリ anthropics/skills は65,000を超えるスターを獲得しており、開発者コミュニティの関心の高さがうかがえます。 Agent Skillsの定義と基本構造 Agent Skillsは、指示・スクリプト・リソースをフォルダ単位でまとめた「再利用可能な専門知識パッケージ」です。Claudeは会話の文脈に応じて必要なSkillだけを動的に読み込み、タスクに適した振る舞いに切り替わります。 1つのSkillは以下のようなディレクトリ構成を取ります。 my-skill/ ├── SKILL.md # エントリポイント(必須) ├── template.md # Claudeが埋めるテンプレート ├── examples/ │ └── sample.md # 期待される出力例 └── scripts/ └── validate.sh # Claudeが実行するスクリプト SKILL.md がエントリポイントです。このファイルにYAMLフロントマターとMarkdown形式の指示を記述します。その他のファイルはオプションで、テンプレート・出力例・実行スクリプト・リファレンスドキュメントなどを必要に応じて配置します。 プログレッシブディスクロージャーによるコンテキスト管理 Agent Skillsは3段階のローディングシステムを採用しており、コンテキストウィンドウを効率的に利用します。 読み込み段階 対象データ タイミング レベル1: メタデータ name + description(約100語) 常時コンテキストに存在 レベル2: SKILL.md本文 指示・手順(約5,000語目安) Skillが発動した時点で読み込み レベル3: 付属リソース スクリプト・リファレンス等 Claudeが必要と判断した時のみ この段階的読み込みにより、多数のSkillを登録していても、使われないSkillの本文がコンテキストを圧迫する心配がありません。descriptionのみが常時読み込まれ、Claudeはそこから「今のタスクにどのSkillが関連するか」を判断します。 Skillの配置場所とスコープ Skillの配置場所によって有効範囲が異なります。優先度は Enterprise > Personal > Project の順です。 ...

2026年2月9日 · 3 分 · 8043 文字 · uiuifree