Claude スキルガイド

問題: 毎新しいセッションで同じ行をClaude Codeに貼り付けています。「ブランドガイドラインに従ってください。」「デプロイプロセスを使ってください。」「まずセキュリティパターンを確認してください。」トークンが消え、分が去り、ルールの半分はどうせ忘れられます。

クイックウィン: 1分以内に最初のスキルを出荷する:

.claude/skills/my-skill/SKILL.md

---
name: code-review
description: Reviews code for security and performance issues
---
 
# Code Review Process
 
1. Check for SQL injection vulnerabilities
2. Verify input validation exists
3. Confirm error handling patterns

これが完全なスキルです。プロジェクトにフォルダを配置するだけで、次のレビューリクエストで自動的に引き込まれます。

スキルとは何か?

スキルは、Claudeがオンデマンドで見つけ、読み込む指示フォルダです。 短い参照マニュアルのキャビネットをイメージしてください。トピックが合うときだけ開かれます。

プロンプトは1ターンで消えます。MCPサーバーはClaudeを外部ツールに接続します。スキルはその中間に位置します: _どのようにすることか_を教えます。手続き的な知識。ワークフロー、チェックリスト、ハウスルール、ドメインのノウハウです。

Simon Willisonはこれを数値化しました: 「各スキルは数十トークンほどしか消費せず、詳細はスキルが解決できるタスクをユーザーがリクエストしたときにのみ読み込まれます。」

プログレッシブディスクロージャーの仕組み

コンテキストウィンドウをスリムに保つために、読み込みは2段階で行われます。

ステージ1 - メタデータのみ（約100トークン）: Claudeは各スキルの名前と短い説明のみを見ます。何が提供されているかを把握するのに十分です。

ステージ2 - 完全な指示（必要なとき）: Claudeがスキルがタスクに合うと判断した瞬間に本文が入ります。本文は通常5,000トークン以内に収まります。

my-skill/
├── SKILL.md              # Core instructions (loads when needed)
├── scripts/              # Automation scripts
├── references/           # Documentation Claude can read
└── assets/               # Templates and files

これにより、Claudeの作業メモリを圧迫することなく数十のスキルを持ち運べます。

スキルとその他のものの比較

スキルがスタックの他の部分とどう並ぶか:

主な区別: プロジェクトは「これを知っておく必要がある」と言います。スキルは「これをどうするか」と言います。MCPは「どう接続するか」と言います。

スキルを作るタイミング

ルール: 2つ以上の会話に貼り付けた指示はスキルにすること。

スキルの良い候補:

• ブランドガイドラインとスタイルルール
• コードレビューチェックリスト
• デプロイ手順
• セキュリティ監査パターン
• ドキュメントテンプレート
• gitコミット規約

スキルに向かないもの:

• 1回限りのリクエスト
• プロジェクト固有のコンテキスト（代わりにプロジェクトを使用）
• 外部APIアクセス（代わりにMCPを使用）

効果的なSKILL.mdの書き方

すべてのスキルには3つの要素が入ります:

---
name: my-skill
description: What it does and WHEN to trigger it
allowed-tools: "Read,Write,Bash"
---
 
# Clear Purpose Statement
 
## Step-by-Step Instructions
 
1. First action
2. Second action
3. Expected output

重要: descriptionフィールドはClaudeがスキルを発動させるかどうかを判断するためにスキャンするものです。トリガーについて具体的に記述してください。「コードレビューをリクエストされたとき」は「コードのサポート」より優れています。

Anthropicからの事前構築済みスキル

Anthropicは公式のドロップインスキルセットを公開しています:

• pdf: PDFドキュメントからテキストと表を抽出
• docx: 変更追跡付きでWordドキュメントを作成・編集
• xlsx: Excelスプレッドシートを操作
• pptx: PowerPointプレゼンテーションを生成
• brand-guidelines: 一貫したスタイルを適用

github.com/anthropics/skillsから入手するか、同じパターンで自分で作ってください。Claude Codeには/simplifyと/batchも組み込みとして付属しており、レビューとコードベース全体の移行に使えます。セットアップ不要です。

よくある間違い

曖昧な説明: 「このスキルはドキュメントのサポートをします」では確実に発動しません。トリガーをはっきりと明記してください。

過負荷の指示: SKILL.mdは5,000単語以内に収めてください。長いドキュメントは、スキルが指し示せる参照ファイルに移してください。

境界の欠如: スキルが触れるべきでないものを明示してください。そうすることで、対象外のプロンプトで発動するのを防ぎます。

次のステップ

1. 最も頻繁に繰り返す指示をカバーする1つのスキルを作成する
2. 明示的なコマンドだけでなく実際のリクエストを使ってトリガーをテストする
3. 実際のセッションで何が調整が必要かを確認したらイテレーションする
4. スキルごとの効果を最大化するためにコンテキスト管理を深掘りする
5. プロダクションAIスタックにおけるスキルの位置付けを理解するためにコンテキストエンジニアリングを読む

スキルが揃うとClaudeは汎用からスペシャリストにシフトし、繰り返しの説明によるコンテキスト税が消えます。あなたの専門知識が可搬になります。空フォルダではなく実際のキットが必要な場合は、ClaudeFastのCode Kitが21カテゴリにわたる20以上のプロダクションスキル（Reactパターンからデータベース操作まで）と、すべてのプロンプトで適切なスキルを選ぶSkillActivationHookを提供します。

トップのアジェンティックエンジニアが毎日行う5つの動作のうちの1つです。全セットはClaude Codeベストプラクティスガイドにあります。