スキル
Claude Code に「覚えさせる」作業手順書
Markdown を書く
code-review.md.claude/commands/ に配置
.claude/commands//スキル名 で呼び出す
/code-reviewこのページのまとめ
スキルは .claude/commands/ フォルダに置く Markdown ファイルです。 ファイル名がそのままスラッシュコマンド名になり、/スキル名 と入力するだけで呼び出せます。 コードレビュー・デプロイ・テスト生成など繰り返す作業を一度スキルにすれば、何度でも同じ品質で再実行できます。 Git で管理してチーム全員で共有できるのも大きな特徴です。
何度でも再利用
/スキル名 を入力するだけで同じ品質の作業を繰り返せる
チームで共有
Git で管理 → クローンするだけ全員が同じスキルを使える
自然言語で書く
Markdown に日本語で指示を書くだけ。プログラミング知識不要
| 比較項目 | スキル | 通常のプロンプト |
|---|---|---|
| 再利用性 | /スキル名 で何度でも呼び出せる | 毎回チャットに貼り付けが必要 |
| Git 管理 | ファイルとしてバージョン管理できる | ブラウザ内にのみ存在 |
| チーム共有 | リポジトリに含めて全員で使える | 個人のセッション内のみ |
| 実行方法 | スラッシュコマンドで即座に起動 | 毎回手動でペースト・送信 |
スキルの代表的な使い方と具体例
/code-review→ コードレビューを自動実行(可読性・バグ・セキュリティを観点に分析)/deploy→ デプロイ手順をステップ実行(確認・ビルド・リリースまで一括)/write-tests→ テストコードを自動生成(ユニット・統合テストの雛形まで)/summarize→ 変更内容を日本語でまとめる(PR の説明文として使えるレポートを出力)
TEAM SHARING
スキルを Git で管理 → リポジトリに含めるだけで全員が共有
新メンバーはクローンするだけで初日から全スキルが使える
Claude Navi で有志が公開したスキルを日本語で探して即導入
スキルファイルの内容例
以下は .claude/commands/code-review.md の記述例です。 このファイルを置くだけで /code-review コマンドが使えるようになります。
# コードレビュー 以下の観点で、指定されたファイルをレビューしてください。 ## レビュー観点 1. **可読性**: 変数名・関数名が意図を明確に表しているか 2. **バグ**: 境界値・null チェック・エラーハンドリングの漏れ 3. **セキュリティ**: XSS・SQL インジェクション等の脆弱性 4. **パフォーマンス**: 不要なループ・重い処理の見直し ## 出力フォーマット 各問題点を以下の形式で出力してください: - 🔴 重大: [問題の説明と修正案] - 🟡 警告: [問題の説明と修正案] - 🟢 提案: [改善の提案] レビュー対象: $ARGUMENTS
スキルの導入手順(3ステップ)
STEP 1
スキルを入手
Claude Navi / GitHub で .md ファイルを探す
STEP 2
配置する
.claude/commands/STEP 3
呼び出す
/スキル名# スキルの配置例 mkdir -p .claude/commands cp code-review.md .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(引数の受け渡し)や出力フォーマットの指定を加えると再利用性が高まります。まず既存のプロンプトをスキルファイルにコピーして試してみましょう。