チャットに同じチェックリストを何度も貼っているなら、その内容はスキルにします。スキルは SKILL.md が入ったフォルダです。Claude はそれを使える道具として登録し、説明が合うときに使うか、/skill-name で直接呼びます。
CLAUDE.md の役割は違います。毎セッションの最初に読み込まれるので、そのたびに必要な短い情報だけ残します。よく使うコマンド、チームの決まり、この作業が終わったと見る目安です。スキル本文は使うときだけ読み込まれます。長い参考資料は、使うまで会話の文脈（トークン）をほとんど食いません。
カスタムコマンドはスキルに統合されました。.claude/commands/deploy.md も .claude/skills/deploy/SKILL.md も /deploy を作ります。既存のコマンドファイルはそのまま動きます。新しい仕事はスキルにしてください。補助ファイルを置けます。あなたと Claude のどちらが呼ぶかを決められます。関係があるときに自動で読み込まれます。
置く場所
- プロジェクト:
.claude/skills/<name>/SKILL.md。コミットしてチームが受け取ります - 個人:
~/.claude/skills/<name>/SKILL.md。このマシンの全プロジェクト - 入れ子: 複数パッケージが入ったモノレポなら、そのパッケージの下に置いて、そこだけの仕事に使います
フォルダ名が打つコマンドになります。ファイル先頭の --- で囲んだ YAML がいつ使うかを伝え、その下のマークダウンが手順です。
レビューだけのスキルから
ファイルを編集せず報告だけする最初のスキルは、初めて試すときに安心です。まだコミットしていない変更を読んでメモを書きます。ファイルは直さず、コミットも作りません。
保存するファイルは次の英語本文です。各行が Claude にさせることは次のとおりです。
description: まだコミットしていない変更を短くレビューします。何が変わったか、コミット前のメモ、リスク一覧を求められたときに使い、報告だけしてファイルを編集したりコミットしたりしません。!`git diff HEAD`: 残りの指示を読む前に、まだコミットしていない変更を本文へ入れます。- 1: 変更を箇条書き3つ以内で要約します。
- 2: 足りないテスト、秘密情報、偶然に見える動作をリスクとして挙げます。
- 3: 変更がなければその旨を言って止めます。
- 4: ファイルを編集しません。git の書き込みコマンドも実行しません。
この英語本文を .claude/skills/review-notes/SKILL.md として保存してください。
---
name: review-notes
description: Write a short review of the current diff. Use when the user asks what changed, wants notes before a commit, or asks for a risk list. Report only; do not edit files or create a commit.
---
## Diff
!`git diff HEAD`
## Instructions
1. Summarize the change in three bullets or fewer.
2. List risks: missing tests, secrets, or behavior that looks accidental.
3. If the diff is empty, say so and stop.
4. Do not edit files. Do not run git write commands.リポジトリで Claude を起動し /review-notes と打つか、説明だけで足りるなら「何が変わった？」と聞いてください。! の行が本文より先に、まだコミットしていない変更を入れるので、メモはその未コミットの差分を基準に書かれます。短い要約とリスク一覧が出るか確認してください。
スキル本文が読み込まれると、あとのやり取りにも残ってトークンを使うので、手順だけ書いて理由の説明は省きます。勝手に起動しないようにするなら disable-model-invocation: true を置き、/review-notes だけで呼んでください。
関連
YouTube
指示200件のスキル上限はまだ現実か