【結論】Skillを作成して再利用する
Claude CodeのSkillはMCPサーバーではなく、特定タスク向けの再利用可能なMarkdown指示と関連ファイルです。
MCPは外部ツールやデータへ接続する仕組みであり、SkillはClaudeへ手順や専門知識を与える仕組みです。
プロジェクト用Skillは.claude/skills/へ配置し、descriptionを具体的に書いて自動選択しやすくします。
# ターミナルで実行：Skill用ディレクトリを作成
mkdir -p .claude/skills/review-api
# ターミナルで実行：Skill定義を作成
cat > .claude/skills/review-api/SKILL.md <<'EOF'
---
name: review-api
description: API変更を認証、入力検証、互換性、テストの観点でレビューする
---
変更は行わず、根拠となるファイルと行を示す。
重大度、影響、再現方法、修正案を整理する。
EOF
# 起動後のセッション内で実行：Skill一覧を確認
/skills具体的な手順・設定方法
繰り返し行うタスクを一つ選び、入力、手順、成果物、禁止事項を定義します。
SKILL.mdのdescriptionへ利用場面を具体的に記載します。
小さなテスト用リポジトリで実行し、意図しない自動選択や過剰な権限要求を確認します。
実践プロンプト / 活用テクニック
# 起動後のセッション内で入力
/review-api
mainと現在ブランチのAPI差分を読み取り専用で確認してください。
認証、入力検証、後方互換性、エラー形式、テスト不足をレビューしてください。
ファイル編集、コミット、外部送信は行わないでください。注意点・よくあるエラーと対処法
非公式MCPパッケージをSkillとして紹介しないでください。
SkillへAPIキー、パスワード、顧客情報を書かないでください。
Skillは権限境界ではないため、危険操作はpermissionsやHooksでも制御します。