Claude Code用のSkillを1つ作る

今回やること

この記事では、PRレビュー用の簡単なSkillを作ります。

Skillは、毎回CLAUDE.mdに置くほどではないが、繰り返し使う手順をまとめるのに向いています。

前提条件

• Claude Codeの基本操作ができる
• .claude ディレクトリを作成してよいプロジェクトで試す
• まずは学習用または個人プロジェクトで試す

Step 1: ディレクトリを作る

プロジェクト内にSkill用のディレクトリを作ります。

mkdir -p .claude/skills/review-pr

チーム共有する場合は、リポジトリに含めるかどうかを決めます。

Step 2: SKILL.mdを作る

.claude/skills/review-pr/SKILL.md を作ります。

---
description: Pull Requestや変更差分をレビューするときに使う
---

## 手順

1. 変更ファイル一覧を確認する
2. 仕様変更と実装修正を分ける
3. セキュリティ、テスト、破壊的変更を確認する
4. 指摘は重要度順に出す

## 出力形式

- Critical:
- Major:
- Minor:
- Test:

Step 3: descriptionを具体化する

description は、Skillが使われるかどうかに関わります。

悪い例です。

description: 便利なレビュー

よい例です。

description: Pull Requestやgit diffの変更差分をレビューするときに使う

descriptionには「どんな作業で使うか」を具体的に書きます。

Step 4: Claude Codeに使わせる

Claude Codeに、作ったSkillを使ってレビューするよう依頼します。

review-pr Skillを使って、現在のgit diffをレビューしてください。

または、自然にレビューを依頼します。

今の変更差分をレビューしてください。重大度順に指摘してください。

Step 5: 結果を見て改善する

出力が粗い場合は、Skillを改善します。

たとえば、テスト観点が弱いなら追加します。

## テスト観点

- 既存テストが壊れていないか
- 変更箇所に対応するテストがあるか
- テストできない場合、理由が説明されているか

よくあるエラー

まとめ

Skillは、繰り返し使う作業手順をまとめる仕組みです。最初はPRレビューのように、目的と出力形式が明確なものから作ると扱いやすいです。description は具体的に書き、結果を見ながら改善します。

参考リソース

• Extend Claude with skills
• Explore the .claude directory
• Create custom subagents

×

PR

×

PR