スキル
Claude Code に「覚えさせる」作業手順書
このページのまとめ
スキルは .claude/commands/ フォルダに置く Markdown ファイルです。 ファイル名がそのままスラッシュコマンド名になり、/スキル名 と入力するだけで呼び出せます。 コードレビュー・デプロイ・テスト生成など繰り返す作業を一度スキルにすれば、何度でも同じ品質で再実行できます。 Git で管理してチーム全員で共有できるのも大きな特徴です。
スキルは、Markdown ファイルに書いた指示書です。 繰り返し行う作業（コードレビュー・テスト生成・デプロイなど）をスキルとして保存しておくと、 次回から /スキル名 と入力するだけで同じ作業を実行できます。 スキルはチームで共有でき、プロジェクトの品質基準・作業フローを統一する手段としても使えます。
料理で例えると、「レシピカード」のようなものです。 一度レシピを書けば、何度でも同じ料理を再現できます。 スキルに書く内容は「このファイルを確認してください」「以下の観点でレビューしてください」といった自然言語の指示です。 プログラミングの知識がなくても、普段 Claude に話しかけるような言葉で書けます。 1 ファイル＝1 スキルという構造なので、メンバーが自由に追加・改善できるのも特徴です。
スキルファイルの仕組み
スキルファイルはプロジェクトの .claude/commands/ フォルダに置く Markdown ファイルです。 ファイル名がそのままスラッシュコマンドの名前になります。 例えば code-review.md というファイルを作ると、 Claude Code のチャット欄で /code-review と入力するだけでそのスキルを呼び出せます。 スキルの内容は「どのファイルを見るか」「どんな観点でチェックするか」「出力フォーマットはどうするか」など、 Claude への詳細な指示を書いておけます。
スキルとプロンプトの違い
毎回チャットに長い指示を貼り付ける代わりに、スキルとして保存しておくのが大きな違いです。 プロンプトは一度きりですが、スキルはチームメンバー全員が同じコマンドを使って同じ品質の作業を繰り返せます。 また、スキルはファイルとして Git で管理できるため、 チームのコーディング規約や業務フローの変化に合わせて版管理しながら改善できます。フックと組み合わせると、スキルを自動トリガーで実行する高度な自動化も実現できます。
| 比較項目 | スキル | 通常のプロンプト |
|---|---|---|
| 再利用性 | /スキル名 で何度でも呼び出せる | 毎回チャットに貼り付けが必要 |
| Git 管理 | ファイルとしてバージョン管理できる | ブラウザ内にのみ存在 |
| チーム共有 | リポジトリに含めて全員で使える | 個人のセッション内のみ |
| 実行方法 | スラッシュコマンドで即座に起動 | 毎回手動でペースト・送信 |
| カスタマイズ | Markdown で自由に記述・改善できる | 毎回書き直しが必要 |
スキルの代表的な使い方と具体例
/code-review→ コードレビューを自動実行（可読性・バグ・セキュリティを観点に分析）/deploy→ デプロイ手順をステップ実行（確認・ビルド・リリースまで一括）/write-tests→ テストコードを自動生成（ユニット・統合テストの雛形まで）/summarize→ 変更内容を日本語でまとめる（PR の説明文として使えるレポートを出力）
チームでのスキル Git 管理と共有
スキルファイルは通常のソースファイルと同じく Git で管理できます。 リポジトリに含めてチームと共有すれば、全員が同じスキルを使って統一された作業フローを実現できます。 コードベースに特化したレビュー観点や、プロジェクト固有のデプロイ手順など、 チームの知見をスキルとして蓄積・共有するのに最適です。
新しいメンバーが参加したときも、リポジトリをクローンするだけで全スキルが使える状態になります。 オンボーディングのコストを下げながら、初日からチームの品質基準に沿った作業が可能になります。
さらに、Claude Naviでは有志が公開したスキルを日本語で探せます。 既存のスキルをそのまま利用したり、自分のプロジェクト向けにカスタマイズして使うことができます。
スキルファイルの内容例
以下は .claude/commands/code-review.md の記述例です。 このファイルを置くだけで /code-review コマンドが使えるようになります。
# コードレビュー 以下の観点で、指定されたファイルをレビューしてください。 ## レビュー観点 1. **可読性**: 変数名・関数名が意図を明確に表しているか 2. **バグ**: 境界値・null チェック・エラーハンドリングの漏れ 3. **セキュリティ**: XSS・SQL インジェクション等の脆弱性 4. **パフォーマンス**: 不要なループ・重い処理の見直し ## 出力フォーマット 各問題点を以下の形式で出力してください： - 🔴 重大: [問題の説明と修正案] - 🟡 警告: [問題の説明と修正案] - 🟢 提案: [改善の提案] レビュー対象: $ARGUMENTS
スキルの導入手順（3ステップ）
スキルファイルを見つける
Claude Navi または GitHub でスキルファイル（.md）を探します。カテゴリで絞り込んで用途に合ったスキルを選びましょう。
所定のフォルダに配置する
ダウンロードしたファイルを、プロジェクトの .claude/commands/ フォルダに置きます。フォルダがなければ mkdir -p .claude/commands で作成してください。
スラッシュコマンドで呼び出す
Claude Code のチャット欄で /スキル名 と入力して呼び出します。引数（対象ファイルなど）を続けて渡すこともできます。例：/code-review src/app/page.tsx
よくある質問
スキルファイルはどこに置けばよいですか？
プロジェクトの .claude/commands/ フォルダに置きます。フォルダがなければ mkdir -p .claude/commands で作成してください。チーム全体で使うにはリポジトリに含めて Git で管理するのがおすすめです。
スキルを呼び出すときに引数は渡せますか？
はい。/code-review src/app/page.tsx のように、スキル名の後にスペースで引数を続けることができます。スキルファイル内では $ARGUMENTS として受け取れます。
フックとスキルを組み合わせることはできますか？
できます。フックのコマンドとして Claude Code にスキルを実行させる指示を書くことで、ファイル保存時やコミット前など特定のイベント発生時にスキルを自動呼び出す構成にできます。
スキルの変更はチームにすぐ反映されますか？
Git でプッシュ後にチームメンバーがプルすれば、最新のスキルが反映されます。バージョン管理できるため、スキルの改善履歴も追跡できます。
プロンプトをそのままスキルにすればよいですか？
基本的にはそれで動きますが、$ARGUMENTS（引数の受け渡し）や出力フォーマットの指定を加えると再利用性が高まります。まず既存のプロンプトをスキルファイルにコピーして試してみましょう。