【保存版】Claude Code「スキル構築」バイブル〜AIを指示待ちから自律型エキスパートに変える設計・実装の全技術〜
2026. 02. 13
Anthropic社が公開した「The Complete Guide to Building Skills for Claude」
このドキュメントには、単にAIを使うだけでなく、AIに「あなたの仕事のやり方」そのものをインストールするための全技術が記されています。
本記事は、その内容を余すところなく日本語で体系化し、デザイナー・マーケター・発信者が「自分専用の自律型エージェント」を構築するための完全ガイドです。
第1章：スキルの正体と「段階的開示」の思想
1. スキルとは「指示のパッケージ」である
MCP（Model Context Protocol）が「道具（検索ツール、ブラウザ操作）」であるなら、スキル（Skills）はその道具を使いこなすための「熟練の手順書」です。
一度スキルを構築すれば、あなたは毎回「前提条件」や「手順」を説明する必要がなくなります。
Claudeはフォルダ内の指示を読み込み、文脈を理解したエージェントとして振る舞います。
2. 最重要概念：段階的開示（Progressive Disclosure）
なぜ、長文のプロンプトを毎回送るのではなく、「スキル化」すべきなのか？
その答えは「トークンの節約」と「精度の向上」にあります。
Claudeは、PC内の全てのファイルを常に見ているわけではありません。
- 第1層（YAMLフロントマター）:
「私は何ができるか」という名札だけを常に提示しておく。
- 第2層（SKILL.md本文）:
ユーザーが必要とした瞬間だけ、詳細な手順を読み込む。
- 第3層（外部リソース）:
作業中に本当に必要になった時だけ、参考資料（辞書）を開く。
この「必要な時に、必要な情報だけを開示する」設計思想こそが、Claudeを高速かつ賢く動かすための鍵です。
第2章：スキルの解剖学 —— フォルダとファイル構造の厳格なルール
スキルは、PC上のフォルダとして存在します。
適当に作っては動きません。
以下の厳格なルールに従う必要があります。
1. フォルダ構成の全貌
スキルフォルダ（例: my-design-agent）の中身は以下の通りです。
2. 命名規則（ここを間違えると動かない）
- ファイル名:
必ず SKILL.md としてください。skill.md（小文字）や README.md では認識されません。
- フォルダ名: ケバブケース（kebab-case）を使用してください。
⭕ competitor-analysis
- ❌ Competitor Analysis（スペース不可）
- ❌ competitor_analysis（アンダースコアは非推奨）
第3章：心臓部「SKILL.md」の完全実装ガイド
SKILL.md は、単なるテキストファイルではありません。「YAMLフロントマター」と「Markdown本文」の2部構成になっています。
Part 1: YAMLフロントマター（AIへの招待状）
ファイルの冒頭に、--- で囲まれたエリアを作ります。これが「第1層」の情報です。
description: >
Figmaのデザインデータを解析し、React/Tailwindのコードに変換するスキルです。
ユーザーが「デザインの実装」や「UIコーディング」を依頼した時、
または .fig ファイルを提示した時に使用してください。
【プロの記述テクニック】
description には、以下の3要素を必ず含めてください。
- What（何をするか）: デザイン解析とコード生成。
- When（いつ使うか）: 実装依頼があった時。
- Trigger（トリガーキーワード）: 「デザインの実装」「UIコーディング」「.figファイル」。
Part 2: Markdown本文（具体的な指示）
--- の下には、AIへの具体的な命令を書きます。
ここでのポイントは「曖昧さを排除する」ことです。
`
UI Coding Agent
あなたは熟練のフロントエンドエンジニアです。以下の手順に従って自律的に実装を行ってください。
手順
- 解析: 渡された画像またはファイルを読み込み、レイアウト構造を分析する。
- 計画: 実装に必要なコンポーネント（Button, Cardなど）をリストアップする。
- 実装:
scripts/generate_component.py を使用して、コンポーネントごとのファイルを作成する。
- 注意: スタイリングは必ず Tailwind CSS を使用すること。
エラーハンドリング
- 画像が不鮮明で文字が読めない場合は、勝手に推測せずユーザーに確認を求めてください。
参照
- ブランドカラーの規定については
references/brand-colors.md を必ず確認してください。`
- Bad: 「いい感じにコードを書いて」
- Good: 「scripts/generate_component.py を使用して作成して」
第4章：高度な実装パターン —— 5つの戦略（The 5 Patterns）
公式ガイドでは、単純なタスクだけでなく、複雑な業務をこなすための5つの設計パターンが紹介されています。
これを使いこなせば、あなたは「AIアーキテクト」です。
1. 逐次実行パターン (The Sequential Flow)
最も基本的で強力なパターン。「A → B → C」と手順を固定します。
- ユースケース:
定型業務の自動化（日報作成、決まった形式の画像生成）。
- 実装:
「手順1：検索する。手順2：要約する。手順3：メール下書きを作る」と番号付きリストで記述。
2. マルチMCP連携 (The Orchestrator)
複数の外部ツール（MCP）を、AIが指揮者のように行き来するパターン。
- ユースケース:
「Slackで依頼を受け（Slack MCP）→ GitHubでコードを直し（GitHub MCP）→ Linearで完了報告（Linear MCP）」。
- 実装:
手順の中で「[Slack MCP]を使用して…」「次に[GitHub MCP]を使用して…」とツール名を明記する。
3. 反復改善ループ (The Refiner)
一度出力して終わりではなく、AI自身に「自己レビュー」と「修正」を繰り返させるパターン。
- ユースケース:
高品質なLP制作、バグのないコード生成。
- 実装:
コードを作成する。
- scripts/validate_code.py を実行してエラーチェックを行う。
- エラーが出た場合、原因を特定してコードを修正し、再度ステップ2に戻る。
- エラーが0になったら完了とする。
4. 文脈依存のツール選択 (The Smart Selector)
状況に応じて、使うツールや保存先をAIに判断させるパターン。
- ユースケース:
ファイル形式の振り分け。
- 実装:
入力データが「数値」の場合は、CSVファイルとして data/ に保存してください。
- 入力データが「文章」の場合は、Markdownとして docs/ に保存してください。
5. 専門知識の埋め込み (The Expert Embed)
単なる作業代行ではなく、特定の業界知識やコンプライアンス基準を判断に組み込むパターン。
- ユースケース:
法律チェック、ブランドトーンの統一。
- 実装:
references/ フォルダに「NGワードリスト」や「ブランドガイドライン」を格納し、SKILL.md で「出力前に必ず references/guidelines.md と照らし合わせ、違反がないか確認すること」と指示する。
第5章：テスト・配布・トラブルシューティング
スキルを作ったら、必ずテストを行います。
1. テストの3つの視点
- トリガーテスト:
「LP作って」と言った時に、ちゃんとそのスキルが起動するか？（逆に、関係ない話で勝手に起動しないか？）
- 機能テスト:
エラーが出た時、指示通りにリカバリー（自己修復）できるか？
- ユーザビリティ:
ユーザーが追加でアレコレ指示しなくても、最後まで完走できるか？
2. トラブルシューティング全集
動かない時は、以下の表を確認してください。
3. スキルの配布
完成したスキルフォルダは、そのままチームメンバーに配布（コピー＆ペースト）するだけで使えます。
Gitリポジトリで管理すれば、「チーム全員が同じ手順で、同じクオリティの仕事をする」環境が一瞬で整います。
結び：AIに「自分」をインストールせよ
ここまで詳細に解説してきましたが、やることはシンプルです。
「あなたの頭の中にある手順（レシピ）を、テキストファイルに書き出すこと」。
これだけで、Claude Codeは単なるチャットボットから、あなたの分身である「エキスパート・エージェント」へと進化します。
2026年、クリエイターの価値は「制作すること」から、このような「スキルを設計し、AIエージェントを指揮すること」にシフトしています。
さあ、今すぐ最初の SKILL.md を作成し、あなたの仕事を自動化しましょう。
— 了 —