Claude Code skills を使えば、チャットに繰り返し貼っているレビュー用チェックリストを保存できます。各スキルは SKILL.md ファイルを含むディレクトリです。依頼が説明と一致したときに Claude が使うことも、/review-notes のようなコマンドで自分から始めることもできます。
会話の最初に Claude が必要とするプロジェクト情報、たとえばテストコマンドやコーディングの決まりは CLAUDE.md に書きます。変更のレビューやデプロイの準備のように、手順がいくつかある特定の作業はスキルにします。スキルの全文は、その作業で必要になったときに読み込まれます。
カスタムコマンドはスキルに統合されました。.claude/commands/deploy.md も .claude/skills/deploy/SKILL.md も /deploy を作ります。既存のコマンドファイルはそのまま動きます。新しい仕事はスキルにしてください。補助ファイルを置けます。あなたと Claude のどちらが呼ぶかを決められます。関係があるときに自動で読み込まれます。
置く場所
- プロジェクト:
.claude/skills/<name>/SKILL.md。コミットしてチームが受け取ります - 個人:
~/.claude/skills/<name>/SKILL.md。このマシンの全プロジェクト。ただし Cowork とクラウドセッションでは読み込まれません - 入れ子:
<subdir>/.claude/skills/<name>/SKILL.md。そこでだけ使う仕事向けです。そのディレクトリより上で始めたセッションは、Claude がそこにあるファイルを扱った時点でこのスキルを読み込みます
プロジェクトまたは個人のスキルでは、ディレクトリ名が入力するスラッシュコマンドになり、frontmatter の name は一覧のラベルです。サンプルは意図的に両方を同じにしています。ファイル先頭の YAML frontmatter がいつ使うかを伝え、その下のマークダウンが手順です。
レビューだけのスキルから
報告だけをする最初のスキルは、信頼しやすいものです。現在のファイルと最後の Git コミットとの差分を読み、レビューメモを書きます。サンプルの4つの指示はモデルに報告だけをするよう伝え、ファイル編集や git のツールは撤回しません。
保存するファイルは次の英語本文です。各行が Claude にさせることは次のとおりです。
description: まだコミットしていない変更を短くレビューします。何が変わったか、コミット前のメモ、リスク一覧を求められたときに使い、報告だけしてファイルを編集したりコミットしたりしません。!`git diff HEAD`: Claude Code はgit diff HEADを実行し、Claude が指示を見る前にその!行をコマンドの出力へ置き換えます。この例には、すでにコミットがある Git プロジェクトが必要です。コマンドは Git がすでに追跡しているファイルだけをそのコミットと比べ、まだ Git に追加していない新しいファイルは含めません。注入したコマンドが拒否されるか失敗すると、Claude がスキルを見る前にスキルは中断します。- 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 と打つか、説明だけで足りるなら「何が変わった？」と聞いてください。! の行が本文より先に、直前のコミットとの差分を入れるので、メモはその差分を基準に書かれます。短い要約とリスク一覧が出るか確認してください。
指示はその作業に絞って書きます。一度読み込まれると、スキルは会話の一部として残り、モデルが使えるコンテキストの一部を使います。明示的に頼んだときだけ実行するには、--- で挟んだ YAML frontmatter の description の隣に disable-model-invocation: true を追加し、/review-notes で起動します。