| name | ref-skill-naming-convention |
| description | Skillを命名するとき、改名するときに読む。 |
| disable-model-invocation | false |
| user-invocable | false |
| allowed-tools | ["Read"] |
| kind | ref |
| prefix | ref |
| effect | none |
| owner | team-platform |
| since | "2026-05-17T00:00:00.000Z" |
| version | 0.1.0 |
| source | doc/ClaudeCodeスキルの設計書/ |
| source-tier | internal |
| last-audited | "2026-05-19T00:00:00.000Z" |
| audit-trigger | quarterly |
| responsibility_refs | ["prompts/R1-search-summarize.md"] |
ref-skill-naming-convention
Purpose & Output Contract
Skill 命名規約の正本サマリ(第1〜16条)。
本SKILL.md は要約のみ。条文全文は references/articles-full.md。
Key Rules(条文サマリ)
- 第1条 形式: kebab-case、英小文字+数字+ハイフン。
- 第2条 prefix必須:
run- / ref- / assign- / wrap- / delegate- のいずれか。
- 第3条 role-suffix推奨:
-evaluator / -generator / -runbook 等。
- 第4条 動詞 or 名詞: run/assign系は動詞、ref/wrap/delegate系は名詞。
- 第5条 60文字以下: prefix含む合計。
- 第6条 予約語回避:
skill, claude, anthropic 単独使用禁止。
- 第7条 ディレクトリ名 == frontmatter.name.
- 第8〜13条 構造:
templates/, references/, scripts/, examples/ 配下のファイル命名。
- 第14条 多言語: description は日本語推奨。動詞ベースの2〜3個のトリガー条件を含むこと(本文も日本語可)。
- 第15条 改名は alias 経由:
aliases: [old-name] で猶予期間。
- 第16条 forbidden:
test- / tmp- / wip- prefix は本番投入禁止。
- 第17条 role-suffix 語彙:
-evaluator / -generator / -linter / -auditor / -aggregator / -runbook / -watcher / -dispatcher を正式語彙とする。新設は governance board 承認が必要。詳細: references/role-suffix-vocabulary.md。
5 prefix × 4軸 対応
references/prefix-axis-matrix.md を参照。
4軸 = (発動主体, context, write権限, 評価対象)。
Steps
参照用。命名時のフロー:
- 用途 → prefix選定(matrix 参照)
- role-suffix を付与(第3条)
python3 scripts/lint-skill-name.py SKILL.md で第1〜5,7条検証
Gotchas
- assign- は user-invocable: false が原則: 第2条 + 04章。
- ref- は disable-model-invocation: true 必須: 自動発動を防ぐ。
- 改名は破壊的変更: 第15条 alias を必ず付ける(後方互換)。
Additional Resources
references/articles-full.md — 第1〜16条全文
references/decision-table.md — 主要8ケース裁定表
references/prefix-axis-matrix.md — 5 prefix × 4軸
../run-skill-elicit/SKILL.md#onboarding-mode初学者向け3問 — 初学者向け Onboarding mode(Q1/Q2/Q3 から prefix を自動推定)
- lint:
scripts/lint-skill-name.py