【結論】SkillsはSKILL.mdで作り、必要時に呼び出す
Claude CodeのSkillsは、繰り返し使う手順・判断基準・参考資料を必要時だけ読み込ませる拡張機能です。
プロジェクト固有のSkillは.claude/skills/スキル名/SKILL.mdに置き、Claudeが自動選択するか、対話画面で/スキル名として明示的に呼び出します。
# ターミナルでSkill用ディレクトリを作成
mkdir -p .claude/skills/code-review
# ターミナルで定義ファイルを作成
cat > .claude/skills/code-review/SKILL.md <<'EOF'
---
name: code-review
description: 変更差分を品質・安全性の観点でレビューする
---
目的: git差分を確認し、根拠付きで問題点を報告する。
手順: テスト実行、差分確認、重大度別の指摘、修正案の提示。
EOF具体的な手順・設定方法
Claude Codeを新しいセッションで
/helpを実行し、Skillが検出されていることを確認します。Skill本文は常時コンテキストへ入らず、関連タスクで選択された時に読み込まれるため、CLAUDE.mdへ長い手順を詰め込むより効率的です。
ツールを限定したい場合は公式仕様に従ってfrontmatterの
allowed-toolsを設定し、権限ルールとも整合させます。
実践プロンプト / 活用テクニック
Skillの動作確認では対象ファイルと出力形式を明示します。
# 起動後のセッション内で実行
/code-review src/auth.ts
# 続けて確認
このレビューで実行したコマンド、未確認事項、修正を推奨する理由を表形式で示してください。注意点・よくあるエラーと対処法
claude --skillという一般CLIオプションを前提にしないでください。
呼び出す場合は対話画面の/skill-nameを使い、非対話処理ではclaude -pに指示を渡します。
Skillへ秘密情報や破壊的コマンドを埋め込まず、Git差分とテスト結果を人間が確認してから採用してください。