Claude Code の Agent Skill 入門 ― AIアシスタントをカスタマイズする新しい方法
「このコードレビュー、毎回同じ観点を説明するの面倒だな...」「コミットメッセージのフォーマット、チームで統一したいけど毎回指示するの大変...」
AIコーディングアシスタントを使っていると、こんな悩みに直面することはありませんか？
実は、この問題を解決する仕組みがあります。それが Agent Skill（エージェントスキル）です。一度作っておけば、/skill-name と打つだけで、AIがあなたの望む通りに動いてくれます。
この記事では、Agent Skill の基本概念から実際の作り方まで、3つの核心ポイントに絞って解説します。
Agent Skill とは何か
料理のレシピに例えると
Agent Skill を一言で表すと、「AIに渡す再利用可能なレシピ」 です。
料理を想像してみてください。毎回「玉ねぎを切って、油を熱して、炒めて...」と手順を考えるのは面倒ですよね。でもレシピがあれば、その通りに作るだけ。Agent Skill も同じです。
出典: Anthropic Engineering Blog
技術的には、Skill は SKILL.md というマークダウンファイルです。このファイルに「どんな手順で」「どんなスタイルで」「どのツールを使って」作業するかを書いておけば、AIがそれを読み取って実行してくれます。
---
name: my-skill
description: このSkillが何をするかの説明
---
# 具体的な指示をここに書く
Skill の2つの大きなメリット
1. 漸進的開示（Progressive Disclosure）
これが Skill の最も重要な設計思想です。
普通のシステムプロンプトは、常に全ての指示がロードされます。つまり、使わない情報もトークンを消費し続けます。
一方、Skill は 必要な時だけロードされる 仕組みです。
出典: Anthropic Engineering Blog
例えるなら、分厚いマニュアルを丸ごと持ち歩くのではなく、目次を見て必要なページだけ開く イメージです。これにより：
- トークン使用量を削減
- コンテキストウィンドウを有効活用
- 関連性の高い情報だけをAIに渡せる
2. ツール・スクリプト拡展
Skill は単なるテキスト指示だけでなく、ツールやスクリプトとの連携も可能です。
skill-folder/
├── SKILL.md # メインの指示ファイル
├── scripts/
│ └── validate.py # 検証スクリプト
└── templates/
└── report.md # テンプレートファイル
出典: Anthropic Engineering Blog
SKILL.md の中で WebSearch や Write などのツールを使うよう指示すれば、AIは自動的にWeb検索をしたり、ファイルを生成したりできます。
主流 Agentic Tool の対応状況
Agent Skill（またはそれに相当する機能）は、2026年現在、主要なAIコーディングツールで採用されています。
| ツール | Skill機能 | 特徴 |
|---|---|---|
| Claude Code | Agent Skills |
.claude/skills/ に配置、/skill-name で呼び出し |
| Cursor | Skills (Nightly) | SKILL.md + Hooks + カスタムコマンド対応 |
| Windsurf | Memories | 会話を跨いでコンテキストを自動共有 |
| OpenAI Codex | Agent Skills |
$skill-name で呼び出し、VS Code/Cursor/Windsurf で動作 |
各ツールで呼び名や仕様は異なりますが、「再利用可能な指示をパッケージ化する」 という基本思想は共通しています。
Skill の作り方 ― AIに任せよう
手書きしない、AIと対話する
ここが最も重要なポイントです。
Skill を自分で一から手書きする必要はありません。 やりたいことをAIに伝えれば、AIがSkillを作ってくれます。
あなた: 「コードレビュー用のSkillを作って。
セキュリティ、パフォーマンス、可読性の3観点でチェックして、
結果はマークダウンで出力してほしい」
AI: 「わかりました。以下のSkillを作成します...」
（AIが SKILL.md を生成）
この方法のメリット：
- 正しいフォーマットが自動で適用される
- ベストプラクティスがAIの知識から反映される
- イテレーションが簡単（「ここをこう変えて」と言うだけ）
配置場所
AIが作成したSkillは、以下のいずれかに配置します：
# グローバル（全プロジェクトで使用可能）
~/.claude/skills/skill-name/SKILL.md
# プロジェクト固有
your-project/.claude/skills/skill-name/SKILL.md
正しく配置されると、/skill-name というスラッシュコマンドとして表示されます。
3つの注意点
1. セキュリティ（最重要）
Skill は強力ですが、悪意のあるSkillはリスクになり得ます。
Skill は Claude に「コードを実行する」「ファイルを操作する」「外部APIを呼ぶ」といった能力を与えます。これは便利ですが、裏を返せば：
- 悪意のある Skill がツールを悪用する可能性
- 外部URLからデータを取得する Skill は特にリスクが高い
- 敏感なデータが外部に漏洩する危険性
対策:
- 信頼できるソースからのみ Skill を使用する（自分で作ったもの、公式提供のもの）
- 外部から入手した Skill は、全てのファイルを監査してから使用
- ソフトウェアをインストールするのと同じ慎重さで扱う
2. パスと命名規則
Skill が読み込まれない場合、大抵はパスか命名のミスです。
# 正しい構造
.claude/skills/my-skill/SKILL.md ← ファイル名は必ず SKILL.md
# よくあるミス
.claude/skills/my-skill.md ← ディレクトリがない
.claude/skills/my-skill/skill.md ← ファイル名が違う（小文字）
確認方法：正しく設定されていれば、スラッシュコマンド一覧に表示されます。
3. ファイル分割でトークン節約
SKILL.md が大きくなってきたら、分割を検討しましょう。
skill-folder/
├── SKILL.md # メイン（概要と参照のみ）
├── detailed-guide.md # 詳細な手順
├── examples.md # サンプル集
└── templates/
└── output.md # 出力テンプレート
特に、排他的なコンテンツ（AパターンかBパターンか、どちらか一方しか使わない場合）は分離しておくと、不要な情報をロードせずに済みます。
まとめ
Agent Skill を使いこなすための3つのポイント：
- 漸進的開示で、必要な時だけ情報をロード → トークン節約
- AIに作ってもらう → 手書きせず、やりたいことを伝える
- セキュリティ最優先 → 信頼できるソースからのみ使用
Agent Skill は「毎回同じ指示を出す手間」を解消し、AIアシスタントをあなた専用にカスタマイズする強力な仕組みです。
まずは簡単なSkillから作ってみてはいかがでしょうか。「コミットメッセージを特定のフォーマットで生成する」「READMEを特定のテンプレートで作成する」など、日常的に繰り返す作業から始めると効果を実感しやすいです。
Discussion