Claude Codeのスキル機能を使えば、タスク内容に応じて専門家AIが自動的に起動する。コピーライター、テクニカルライター、セキュリティレビュアーなど、目的別に最適化されたAIエージェントを .claude/skills/ に配置するだけで使えるようになる。
スキルとは何か
Claude Codeにおける「スキル」は、Claudeの能力を拡張するモジュール式の仕組みだ。
スラッシュコマンドとの違い
よく似た機能に「スラッシュコマンド」があるが、両者は明確に異なる。
| 項目 | スラッシュコマンド | スキル |
|---|---|---|
| 呼び出し方 |
/command で明示的に実行 |
自動検出・自動実行 |
| ファイル構成 | 単一の .md ファイル |
ディレクトリ構造（SKILL.md + リソース） |
| ユースケース | 定型タスクの実行 | 文脈に応じた専門家の起動 |
スキルの最大の特徴は自動実行という点だ。ユーザーが「ブログ記事を書いて」と言えば、ブログライタースキルが自動的にトリガーされる。いちいち /blog-writer と打つ必要がない。
ただし「完全に自動」というわけではない。descriptionの書き方次第で精度が大きく変わる。曖昧な説明だと期待どおりに起動しないこともあるので、後述するdescriptionの書き方は要チェックだ。
スキルの配置場所
スキルは以下の3つの場所に配置できる。
# プロジェクト専用（推奨）
./your-project/.claude/skills/[skill-name]/SKILL.md
# 個人用（全プロジェクト共通）
~/.claude/skills/[skill-name]/SKILL.md
# プラグイン由来
# プラグインに含まれるスキル
プロジェクトごとに異なるスキルセットを使いたい場合は、プロジェクト直下の .claude/skills/ に配置するのがおすすめだ。
スキルファイルの書き方
スキルは SKILL.md というMarkdownファイルで定義する。
基本構造
---
name: copywriter
description: コピーライティングのスペシャリスト。心を動かし行動を促すコピーを作成。
---
You are a copywriting specialist creating persuasive, conversion-focused content.
## Primary Responsibilities
1. **Headlines & Hooks**
- Attention-grabbing headlines
- Curiosity gaps
- Benefit-driven copy
2. **Sales Copy**
- Landing pages
- Product descriptions
- Email sequences
## Frameworks
- AIDA: Attention, Interest, Desire, Action
- PAS: Problem, Agitate, Solution
メタデータの書き方
YAML形式のフロントマターで以下を指定する。
---
name: skill-name # 64文字以下、小文字・数字・ハイフンのみ
description: スキルの説明 # 最大1024文字
---
重要: description には「何をするか」と「いつ使うか」の両方を含めること。Claudeはこの説明を読んでスキルを自動起動するか判断している。
3段階の読み込みモデル
スキルはコンテキストを効率的に使うため、3段階で読み込まれる。
レベル1: メタデータ読み込み（常時）
↓ 約100トークン
「このスキルが存在する」ことを認識
レベル2: SKILL.md本体読み込み（トリガー時）
↓ 数千トークン程度を推奨
手続き的知識を取得
レベル3: リソースファイル読み込み（必要時）
↓ 参照ファイルやスクリプト
必要に応じて読み込まれ、コンテキストに追加される
つまり、大量のスキルを配置しても、使わないスキルはメタデータ分（約100トークン）しかコンテキストを消費しない。これは賢い設計だなと思った。
実際に使ってみる
1. スキルディレクトリを作成
mkdir -p .claude/skills/technical-writer
2. SKILL.mdを作成
cat << 'EOF' > .claude/skills/technical-writer/SKILL.md
---
name: technical-writer
description: テクニカルライティングのスペシャリスト。明確で正確な技術文書の作成を担当。
---
You are a technical writing specialist creating clear, accurate documentation.
## Primary Responsibilities
1. **Documentation Types**
- API documentation
- User manuals
- Developer guides
- Release notes
2. **Writing Principles**
- Clarity over cleverness
- Consistent terminology
- Task-oriented approach
## Best Practices
- Keep it current
- Include code examples
- Version documentation
EOF
3. Claude Codeを起動
claude --allowed-tools "Skill,Read,Write"
--allowed-tools でSkillツールを許可しておく必要がある。
4. タスクを実行
> APIドキュメントを書いてほしい
これだけで、technical-writerスキルが自動的にトリガーされ、テクニカルライティングの専門家としてドキュメントを作成してくれる。
スキルマッチャーツールの紹介
「どんなスキルを作ればいいかわからない」という人向けに、スキルを検索・ダウンロードできるツールを作った。
https://tools.easegis.jp/ja/tools/ai/skill-matcher
※これは私が独自に作成したツールで、Anthropic公式機能ではありません。
主な機能:
- 19カテゴリ、多数のスキルを収録
- キーワード検索で最適なスキルを推薦
- 個別・カテゴリ別・一括ダウンロード
タスクの説明を入力すると、関連度の高いスキルが表示される。気に入ったスキルをダウンロードして .claude/skills/ に配置すれば、すぐに使い始められる。
実用的なスキル例
以下は私が実際に使っているスキルの一部だ。
ブログライター
---
name: blog-writer
description: ブログライティングのスペシャリスト。読者を引き付ける記事の構成と執筆を担当。
---
セキュリティレビュアー
---
name: security-reviewer
description: セキュリティレビューのスペシャリスト。コードの脆弱性診断とセキュリティ改善提案を担当。
---
コンテンツストラテジスト
---
name: content-strategist
description: コンテンツ戦略のスペシャリスト。コンテンツ計画から実行までを統括。
---
ハマりポイント
メタデータの予約語
name に anthropic や claude は使えない。予約語になっているので注意。
# NG
name: claude-helper
# OK
name: code-helper
descriptionが短すぎる
descriptionが曖昧だと、Claudeが適切にスキルを選べない。「何をするか」と「いつ使うか」を明確に書こう。
# NG: 曖昧
description: ドキュメントを書く
# OK: 明確
description: テクニカルライティングのスペシャリスト。API仕様書やユーザーマニュアルなど技術文書の作成を担当。ドキュメント作成を依頼された時に使用。
まとめ
Claude Codeのスキル機能は、専門家AIを自動的に起動させる強力な仕組みだ。
- スラッシュコマンドと違い、自動検出・自動実行される
-
SKILL.mdに専門家のペルソナと知識を記述 - 3段階読み込みでコンテキストを効率的に使用
- プロジェクトごとに異なるスキルセットを配置可能
ぜひ自分のワークフローに合わせたスキルを作ってみてほしい。