Claude CodeでプロンプトをSkillsとして保存・再利用する方法

結論

最初にやること：OSのターミナルでmkdir -p .claude/skills/review-prを実行します。

Claude Codeには再利用可能なSkillがあり、頻出プロンプトをシェルaliasへ埋め込むより安全に共有できます。

プロジェクト用Skillは.claude/skills/<skill-name>/SKILL.mdへ置き、説明と手順をMarkdownで管理します。

関連する場面でClaudeが自動適用でき、必要なら/skill-nameで明示的に呼び出せます。

実行場所：コメントに従い、ターミナルとClaude Codeの対話画面を使い分けます。

# ターミナルで実行：必要なフォルダを作成
mkdir -p .claude/skills/review-pr
# ターミナルで実行：設定ファイルへ内容を書き込む
cat > .claude/skills/review-pr/SKILL.md <<'EOF'
---
name: review-pr
description: 現在のGit差分を安全性と回帰リスクの観点でレビューする
---
1. git diff --stat と git diff を読む。
2. 重大度順に問題を列挙する。
3. ファイルを変更せず、テスト不足も指摘する。
EOF

# ターミナルで実行：Claude Codeを起動
claude
# Claude Code起動後の対話画面で実行：対話コマンドを実行
/review-pr

具体的な手順

1. 一つの目的だけを持つSkill名を決める

2. frontmatterに用途が分かるdescriptionを書く

3. 必要な入力、手順、禁止事項、出力形式を記載する

4. Gitへコミットしてチームレビューを受ける

Skill追加後は/reload-skillsで再走査でき、セッション再起動は必須ではありません。

個人用Skillは~/.claude/skills/へ置き、プロジェクト固有の規約はリポジトリ側へ置きます。

実践プロンプト

引数を受け取るレビューSkillで使う依頼例です。

実行場所：Claude Code起動後の対話画面で実行します。

/review-pr src/payments/
この範囲を重点対象にしてください。
認証情報の露出、金額計算の丸め、例外処理、回帰テスト不足を確認してください。
修正はせず、根拠となるファイルと行番号を付けて報告してください。

注意点

aliasへ長文を直接保存すると引用符、OS差、資格情報の混入、チーム共有の難しさが発生します。

Skillの説明を長くしすぎると毎ターンのSkill一覧がコンテキストを圧迫するため、発火条件を短く明確にします。

自動実行するBashや外部ツールをSkillへ含める場合も、Claude Codeのpermissionsとsandboxが別途適用されることを確認してください。