plugin-dev skill-development: document hyphenated naming requirement for skill names
Resolved 💬 3 comments Opened Feb 10, 2026 by c2keesey Closed Mar 29, 2026
Summary
The skill-development skill in the official plugin-dev plugin shows examples with space-separated title case names in YAML frontmatter (e.g., name: Skill Name), but slash command triggering requires hyphenated lowercase names (e.g., name: skill-name).
Problem
The guide's examples use:
name: Skill Name
But in practice, /skill-name only works when the frontmatter uses:
name: skill-name
Using name: Skill Name causes /skill-name to fail with "Unknown skill" because only the first word matches.
Suggested Fix
- Update the SKILL.md frontmatter examples to use hyphenated lowercase names
- Add a note in the "Metadata Quality" section explaining that the
namefield should use lowercase-hyphenated format since it's used as the slash command trigger (e.g.,name: my-skilltriggers via/my-skill)
Affected File
plugin-dev/skills/skill-development/SKILL.md — multiple example blocks showing name: in frontmatter
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗