Claude Code Skillsの作り方とMCPとの違い

【結論】SkillsはSKILL.md、外部接続はMCPで分ける

Claude CodeのSkillsは、繰り返し使う手順、チェックリスト、出力形式を「SKILL.md」へまとめて再利用する仕組みです。

SkillsとMCPは同義ではなく、SkillsはClaudeへの作業手順、MCPは外部サービスやローカルツールを接続するプロトコルです。

プロジェクト用スキルは「.claude/skills/スキル名/SKILL.md」へ作成し、関連時に自動利用させるか「/スキル名」で直接呼び出します。

mkdir -p .claude/skills/release-check
cat > .claude/skills/release-check/SKILL.md <<'EOF'
---
name: release-check
description: リリース前に型、テスト、差分、機密情報を確認する
---
1. git statusと差分を確認する。
2. 型チェックとテストを実行する。
3. .env、鍵、トークンの混入を検索する。
4. 失敗時は変更せず原因を報告する。
5. 結果をMarkdown表で返す。
EOF
claude

具体的な手順・設定方法

1. 何度も貼り付ける手順を一つ選び、目的、実行順序、停止条件、出力形式をSKILL.mdへ書きます。

   曖昧な一般論ではなく、実際のコマンドと成功条件を含めてください。

2. Claude Codeを起動し、スキル名を直接呼び出します。

   説明が具体的なら、関連タスクでClaudeが自動選択することもあります。

   /release-check

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

スキルは長大なCLAUDE.mdから手順部分を分離する用途に向いています。

release-checkスキルを使用してください。
今回の変更を読み取り専用で検査し、型チェック、対象テスト、git diff --check、秘密情報の混入確認を順番に実行してください。
失敗した項目があれば自動修正せず、コマンド、終了コード、該当ファイル、推奨対応を表で返してください。
すべて成功した場合だけ、リリース可能と判断した根拠を要約してください。

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

• 旧記事の「Skillsは内部Bashツールの総称」や「Skills=MCP」という説明は不正確です。

  SKILL.mdの手順、サブエージェントの役割、MCPの接続先を分けて設計してください。

• スキルが発火しない場合はdescriptionが曖昧か、配置場所やフロントマターに問題があります。

  直接「/skill-name」で呼び出し、「claude doctor」で設定を確認してください。

  claude doctor