【結論】Skills作成チュートリアル
Claude CodeのSkillsはMCPの別名ではなく、繰り返し使う手順やチェックリストをSKILL.mdとして追加する仕組みです。
外部DBやSaaSへ接続する機能はMCPであり、Skillは必要に応じてClaudeが読み込む再利用可能な指示です。
プロジェクト固有Skillは.claude/skills/<skill-name>/SKILL.mdへ配置し、/skill-nameで直接呼び出せます。
# ターミナルで実行：Skill用ディレクトリを作成
mkdir -p .claude/skills/api-review
# ターミナルで実行：再利用するレビュー手順を作成
cat > .claude/skills/api-review/SKILL.md <<'EOF'
---
name: api-review
description: REST API変更の互換性と安全性を確認する
---
対象差分を読み、認証、入力検証、互換性、テスト不足を確認する。
ファイルは変更せず、重大度、根拠、修正案の順で報告する。
EOF
# ターミナルで実行：Claude Codeを開始
claude具体的な手順・設定方法
セッション内の
/skillsで作成したSkillが認識されるか確認します。Skillのdescriptionは発動条件が分かる具体的な文にし、長い参考資料は同じSkillディレクトリへ分離します。
外部ツールが必要な処理だけMCPを追加し、単なる作業手順はSkillとして管理します。
実践プロンプト / 活用テクニック
作成したSkillを明示的に呼び出す例です。
/api-review
現在のGit差分だけを対象にレビューしてください。
コードは変更せず、重大度が高い順に根拠ファイルと修正案を報告してください。注意点・よくあるエラーと対処法
旧記事のclaude_mcp.jsonは現行の標準プロジェクト設定名ではなく、MCP共有設定は通常.mcp.jsonです。
JSON内へAPIキーを直書きせず、環境変数展開またはOAuthを使います。
Skill本文は使われたときに読み込まれますが、名前とdescriptionはコンテキストへ影響するため、不要なSkillを大量登録しないでください。