# Skill の提案基準

Skill は、繰り返す作業手順をファイルに固定して、依頼の言い方に応じて自動で呼び出される仕組みです。

## 提案してよい場面

- 同じ説明を毎回 AI にしている（レビュー観点、書式、命名の決まり）
- 手順が5ステップ以上あり、順番を間違えると結果が変わる
- 成果物の形が決まっている（Issue、報告書、テストの書き方）

## 提案を控える場面

- 1回しかやらない作業
- CLAUDE.md に3行書けば済む決まりごと

## 発火条件の書き方

`description` は Skill が選ばれる唯一の手がかりです。次を含めます。

- 何をするものか
- どういう言い方をされたときに使うか（実際に打ちそうな日本語を2つから3つ）

広すぎると誤発火し、狭すぎると発火しません。

## 提案の書き方の例

```
- 提案: Issue 起票 Skill
  何をするか: 症状を伝えると ISSUE_TEMPLATE.md の5見出しを埋めた下書きを作る
  効く理由: kadaiB/issues/ にテンプレートがあり、5見出しの形式が決まっているため
  作るとしたら: .claude/skills/issue-writer/SKILL.md
```
