Claude CodeのおすすめSkills：SKILL.mdでレビュー手順を再利用

【結論】繰り返す手順はSKILL.mdへ分離する

Claude CodeのSkillはMCPツールの別名ではありません。

Skillは定型手順やチェックリストをSKILL.mdとして保存し、Claudeが必要時に読み込む仕組みです。

外部サービス接続はMCP、プロジェクトの恒常的な事実はCLAUDE.md、繰り返す作業手順はSkillと役割を分けると、コンテキストと保守性を最適化できます。

mkdir -p .claude/skills/review
cat > .claude/skills/review/SKILL.md <<'EOF'
---
name: review
description: 変更差分を重大度順にレビューする
---
1. git diffを確認する。
2. 再現可能な不具合だけを指摘する。
3. テスト不足を具体化する。
EOF

具体的な手順・設定方法

1. プロジェクト固有Skillは.claude/skills、個人共通Skillは~/.claude/skillsへ配置します。

2. Skill名と説明を明確にし、長い参考資料は同じディレクトリの別ファイルへ分けます。

3. Claude Codeを起動して/reviewを実行し、期待する出力になるまで小さく改善します。

claude
/review

実践プロンプト / 活用テクニック

Skillの完了条件と出力形式を具体化します。

このSkillを評価してください。
同じgit diffに3回適用して、重大な指摘が安定して再現されるか確認してください。
曖昧なスタイル指摘が出た場合は、SKILL.mdの指示を改善してください。

注意点・よくあるエラーと対処法

• Skill本文は使用時だけ読み込まれますが、説明は発見のため常時参照されるため簡潔にします。

• 秘密情報や固定APIキーをSKILL.mdへ記載しません。

• 組み込みの/doctor、/debug、/code-review、/verifyなどもあるため、重複Skillを作る前に/helpで確認します。