Claude Code SkillsのメリットとSKILL.md作成手順

【結論】解決策 / 実行コマンド

Claude CodeのSkillsは、外部サービス接続を行うMCPとは別機能です。

Skillは指示、スクリプト、参考資料をフォルダへまとめ、必要な場面で動的に読み込ませる再利用可能な作業手順です。

# ターミナルで実行：プロジェクト用Skillを作成
mkdir -p .claude/skills/release-check
# ターミナルで実行：Skill定義を保存
cat > .claude/skills/release-check/SKILL.md <<'EOF'
---
name: release-check
description: リリース前にテスト、ビルド、差分確認を行う
---
1. git status と git diff --check を実行する。
2. package.json の test と build スクリプトを確認して実行する。
3. 失敗内容、影響範囲、修正候補を報告する。
4. 明示的な許可なしにバージョン番号やタグを変更しない。
EOF
# ターミナルで実行：Claude Codeを起動
claude

具体的な手順・設定方法

1. Skillは通常、プロジェクトでは .claude/skills/、個人共通では ~/.claude/skills/ に配置します。
2. description は「何をするか」だけでなく「どの場面で使うか」まで書きます。
3. 外部DBやGitHubなどへ接続する場合はSkillではなくMCPを追加し、SkillからそのMCPツールを使う手順を定義します。

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

# 起動後のセッション内で入力
release-check Skillを使って、このブランチをリリース可能か検査してください。
コードは変更せず、実行したコマンド、失敗項目、リリース阻害要因を簡潔に報告してください。

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

SkillsとMCPを同一視すると設定場所や権限設計を誤ります。

Skill内のスクリプトもClaude Codeの権限確認対象であり、危険なコマンドを無条件実行させる設計は避けてください。

APIキーなどの秘密情報はSKILL.mdへ直書きせず、環境変数や組織のシークレット管理を使用してください。