diff --git a/.claude/skills/create-skill/SKILL.md b/.claude/skills/create-skill/SKILL.md index ac94cbc14..6341428af 100644 --- a/.claude/skills/create-skill/SKILL.md +++ b/.claude/skills/create-skill/SKILL.md @@ -178,7 +178,11 @@ For design patterns, consult: **Writing guidelines:** Always use imperative/infinitive form. **Frontmatter:** -- `name`: The skill name +- `name`: The skill name — use **domain-action** naming: `{domain}-{action}`. + The domain is the system/area the skill operates on, the action is what it does. + Examples: `pr-review`, `sprint-plan`, `docs-search`, `git-commit`, `debt-scan`. + Multi-action wrappers (like `ticket`) can use the domain name alone. + The directory name must match the `name` field. - `description`: Primary triggering mechanism. Include what the skill does AND specific triggers/contexts. All "when to use" info goes here (not in body).