---
name: skill-creator
description: 繰り返している作業手順を Skill として書き出します。「Skill を作りたい」「この手順を次から自動で使えるようにして」「自分のレビュー観点を Skill にして」「SKILL.md を作って」のときに使います。対話で3つだけ質問し、.claude/skills/<名前>/SKILL.md を1本作ります。
allowed-tools: Read, Write, Glob, Grep
---

# Skill を作る（軽量版）

依頼者の作業手順を聞き取り、`SKILL.md` を1本書き出します。研修時間内に終わる範囲に絞った軽量版です。評価の自動実行や複数サブエージェントは使いません。

## 手順

### 1. 3つだけ質問する

まとめて1回で聞きます。小分けに何度も聞き返さないでください。

1. この Skill は何をするものですか（一言で）
2. どういうときに使いたいですか（実際に打ちそうな依頼の言い方を2つか3つ）
3. 手順は何ステップありますか（箇条書きで、順番がわかる形で）

答えが曖昧な場合は、直前の会話で実際に行った作業を材料に、こちらから案を出して確認を取ります。ゼロから聞き直さないでください。

### 2. 名前を決める

- 英小文字とハイフンだけを使います（例: `rule-mismatch-hunter`）
- 動詞か、何をするものかがわかる名詞にします
- 既存の Skill と重ならないことを `Glob` で `.claude/skills/*/SKILL.md` を見て確認します

### 3. description を書く

Skill が選ばれる手がかりは `description` の文章だけです。次の2つを必ず1文ずつ入れます。

- 何をするものか
- どういう言い方をされたときに使うか（質問2で聞いた言い方をそのまま入れる）

例です。

```
description: 業務ルールの記述と実装の食い違いを探します。「ルールと実装が合っているか調べて」「仕様と違う挙動を探して」「業務ルールと突き合わせて」のときに使います。
```

書いたら、次の2点を自分で確認してから進みます。

- 依頼者が言いそうな言い方が入っているか
- 関係ない依頼（「このコードを整形して」など）でも発火してしまわないか。広すぎたら対象を絞る語を足す

### 4. SKILL.md を書く

`.claude/skills/<名前>/SKILL.md` を作ります。構成は次のとおりです。

```markdown
---
name: <名前>
description: <上で書いたもの>
---

# <日本語のタイトル>

<何をするものかを2行から3行>

## 手順

1. <具体的な操作。読むファイル、探す語、出す形まで書く>
2. ...

## 出力の形

<何を、どのファイルに、どういう形式で出すか>

## やらないこと

- <この Skill の範囲外のこと>
```

書く内容の決まりです。

- 手順には、読むファイルのパス・探す語・出す形を具体的に書きます。「適切に確認する」のような書き方はしません。
- 200行を超えたら、詳しい判断材料を `references/` に分けて、SKILL.md からは参照だけにします。
- 依頼者の言葉をそのまま使います。こちらの言い換えに寄せないでください。

### 5. 動くか確かめる方法を伝える

作り終えたら、次を伝えて終わります。

> `/clear` で文脈をリセットしてから、`<質問2で聞いた言い方>` と送ってみてください。この Skill が選ばれたかどうかは、実行サマリーの「従った設定」欄で確認できます。選ばれなかった場合は、description に書いた言葉と、実際に打った言葉が離れています。description を直して、もう一度試してください。

## 補助スクリプト（任意）

`scripts/init_skill.py` は、フォルダと SKILL.md の骨組みだけを作る小さなスクリプトです。使わなくても Write ツールで同じものが作れます。使う場合は次のとおりです。

```
python3 .claude/skills/skill-creator/scripts/init_skill.py <名前> "<description>"
```

標準ライブラリだけで動きます。外部への通信はしません。

## 参考資料

- `references/skill-writing.md`: SKILL.md の書き方の細かい決まり
- `references/description-guide.md`: 発火する description の作り方と、誤発火の直し方

## やらないこと

- 依頼されていない Skill を勝手に増やすこと
- 既存の Skill の上書き（同名があれば別名を提案します）
- 評価スクリプトやテストの自動生成（軽量版の範囲外です）

---

ハーネス種別: 生成系 Skill（`.claude/skills/` の下に新しいファイルを1本作ります）
Givery 講師 安田によるセキュリティチェック済み
引用元URL: https://github.com/anthropics/skills （skill-creator、Apache-2.0）。公式版は評価用スクリプトと複数サブエージェントを前提としており、20名の同時実行に耐えないため、対話3問と SKILL.md 1本の生成に絞った軽量版として書き直しています。
