【結論】Skillは再利用可能な手順と知識のPackageである
Claude CodeのSkillは、特定業務の手順、判断基準、参考資料、補助Scriptをまとめ、Claudeが必要時に利用できる再利用Packageです。
単なる短縮Promptではなく、入力、Tool、検証、Output、Error時の挙動を定義できます。
# ターミナルでProject Skill Directoryを作成
mkdir -p .claude/skills/api-review
# ターミナルでSkill定義Fileを作成
cat > .claude/skills/api-review/SKILL.md <<'EOF'
# API review
Review changed endpoints, run existing tests, and report breaking changes.
Do not edit files or publish results externally.
EOF具体的な手順・設定方法
Skill名と説明は、いつ使うかが判別できる具体的な表現にします。
手順には対象、入力、既存Command、Success条件、禁止操作を含めます。
補助Scriptを同梱する場合は、固定Version、依存関係、Exit code、Testを用意します。
# ターミナルでClaude Codeを起動
claude
# 起動後のセッション内でSkill一覧を確認
/skills
# 起動後のセッション内で作成したSkillを実行
/api-review実践プロンプト / 活用テクニック
良いSkillは、毎回同じ品質基準で作業でき、Reviewerが内容を監査できます。
/api-review を使い、mainとの差分だけを確認してください。
破壊的変更、認証漏れ、互換性、Test不足を重大度順に報告してください。
Fileは変更せず、根拠となるPathとLineを示してください。注意点・よくあるエラーと対処法
Skillを更新したら、期待入力、正常系、失敗系、Permission拒否時をTestしてください。
Skillが便利でも、法務判断、公開、支払い、本番変更などの最終責任をAIへ委譲しないでください。