Claude Code を使っていると、「毎回同じ指示を出すのが面倒」「プロジェクト固有のルールを覚えてほしい」と思うことがありませんか？
そんなときに使えるのがスキルです。
スキルとは、SKILL.md というマークダウンファイルに指示を書いておくだけで、Claude の振る舞いを拡張できる仕組みです。たとえば「コードレビューのルール」「リリース手順」「コミットメッセージの書き方」などをスキルとして定義しておけば、Claude が必要なタイミングで自動的に読み込んでくれます。
もちろん /skill-name のようにスラッシュコマンドとして直接呼び出すこともできます。
補足：
/helpや/compactのような組み込みコマンドについては、公式ドキュメントのインタラクティブモードを参照してください。以前の
.claude/commands/によるカスタムスラッシュコマンドは、現在もそのまま動作します。スキルはその上位互換で、サポートファイル（テンプレートやスクリプト）を含められたり、Claude の自動呼び出しを制御できたりと、より柔軟な機能が追加されています。
まずはスキルを作ってみよう
ここでは「コードレビューを自動化するスキル」を例に、作成手順を紹介します。
ステップ 1：ディレクトリを作る
プロジェクト直下の .claude/skills/ にディレクトリを作ります。ここに置いたスキルは、そのプロジェクトで作業するメンバー全員が使えます。
mkdir -p .claude/skills/review
Tip： 個人用のスキル（どのプロジェクトでも使いたいもの）は
~/.claude/skills/に置きましょう。プロジェクト固有のルールは.claude/skills/がおすすめです。使い分けを最初に決めておくと、あとで散らかりません。
ステップ 2：SKILL.md を書く
スキルの本体は SKILL.md というファイルです。構成は 2 つのパートに分かれています。
- フロントマター（
---で囲まれた YAML 部分）：スキルの名前や説明など、メタ情報を書く - マークダウン本文：Claude に従ってほしい指示を書く
.claude/skills/review/SKILL.md を以下の内容で作成しましょう。
---
name: review
description: >
コードレビューを実施する。変更されたファイルを読み、
バグ・パフォーマンス・可読性の観点でフィードバックする。
---
以下の観点でコードレビューしてください。
## チェック観点
1. **バグの可能性** — null チェック漏れ、境界値、競合状態
2. **パフォーマンス** — 不要な再レンダリング、N+1 クエリ、メモリリーク
3. **可読性** — 命名、関数の長さ、ネストの深さ
4. **セキュリティ** — XSS、SQL インジェクション、認証漏れ
## 出力フォーマット
- ファイルパスと行番号を必ず示す
- 重要度を「Critical / Warning / Suggestion」で分類する
- 修正案のコードも提示する
フロントマターの name がそのままスラッシュコマンド名（/review）になります。description は Claude が「このスキルを今使うべきかどうか」を判断する材料です。
Tip：
descriptionは日本語で書いて OK です。普段 Claude に日本語で話しかけるなら、日本語のほうが自動呼び出しのマッチ精度が上がります。
ステップ 3：動作確認
作ったスキルは 2 通りの方法で使えます。
方法 A：自然に頼んで Claude に判断させる
この PR の変更をレビューして
description の内容に合致すれば、Claude が自動的にスキルを読み込みます。
方法 B：スラッシュコマンドで直接呼び出す
/review src/lib/auth.ts
どちらでも、チェック観点に沿った構造化されたレビューが返ってくるはずです。
スキルの保存場所と優先順位
スキルをどこに置くかで、使える範囲が変わります。
| 場所 | パス | 使える範囲 |
|---|---|---|
| Enterprise | 管理設定で配布 | 組織全体 |
| Personal | ~/.claude/skills/<名前>/SKILL.md |
自分の全プロジェクト |
| Project | .claude/skills/<名前>/SKILL.md |
そのプロジェクトだけ |
| Plugin | <plugin>/skills/<名前>/SKILL.md |
プラグイン有効時 |
同じ名前のスキルが複数の場所にある場合は、Enterprise > Personal > Project の優先順位で適用されます。Plugin スキルは plugin-name:skill-name という名前空間を使うので、他と衝突しません。
CLAUDE.md との使い分け： 「常にすべての作業で守ってほしいルール」は CLAUDE.md に、「特定のタスクのときだけ使いたいルール」はスキルに書くのがおすすめです。たとえば「TypeScript を使え」は CLAUDE.md、「レビューの手順」はスキル、という具合です。
monorepo での自動検出
monorepo のようにサブディレクトリごとに .claude/skills/ を持つ構成もサポートされています。packages/frontend/ 内のファイルを編集していれば、packages/frontend/.claude/skills/ のスキルも自動で検出されます。
スキルディレクトリの構成
スキルは 1 つのディレクトリとして管理します。SKILL.md だけが必須で、その他はオプションです。
review/