Skills の「索引」と全体の流れを CLAUDE.md／AGENTS.md に書いて、選ばれる精度を上げる
skill の説明文（description）だけに頼らず、リポジトリの CLAUDE.md／AGENTS.md に「どの場面でどの skill を使うか」「どの順につなぐか」を短く書いておく。エージェントが skill を使う・正しく選ぶ・続けて使う確率が上がる、という実践報告。
どんな時に使う？
- skill を入れたのに、エージェントが使わない、または似た skill を取り違える
- 「調査 → 計画 → 実装 → レビュー」のように、複数の skill をつなげて使ってほしい
書き方の例（AGENTS.md）
markdown
## Skills の使い分け
| 場面 | skill | 次につなぐ |
| - | - | - |
| 仕様があいまい | `spec-interview` | `plan-writer` |
| 計画ができた | `plan-writer` | `tdd-impl` |
| PR を出す前 | `self-review` | — |
流れ: 仕様確認 → 計画 → テスト先行で実装 → セルフレビュー。各 skill の詳細は SKILL.md を読む。- 索引は1行1skill の短い表にとどめ、手順の中身は SKILL.md に置く
- skill を足したり消したりしたときに索引も直すよう、索引を更新する skill（または手順）も用意しておく
注意点
- 索引が長いと毎回の文脈を圧迫する。ルート CLAUDE.md はコンパクト後も読み直されるので、置き場所としては向いている（Claude Code: コンパクト後も残るもの・消えるもの（大事な指示は SKILL.md の先頭とルート CLAUDE.md に））
- 公式機能をなぞる大がかりな改造は、公式の更新ですぐ不要になりがち。skill と索引のような軽いカスタマイズにとどめる、という意見もある