skill-description-generator
Generate skill description fields that trigger correctly with specific phrases. Use when creating new skills and need description copy following trigger rules.
SKILL.mdskills/skill-description-generator/SKILL.md
GitHubSkill Description Generator
Create skill description fields that trigger on exact user phrases and avoid overlap with other skills.
Steps
| # | Step | Action | Output / Gate |
|---|---|---|---|
| 1 | Gather details | Collect: (1) one-sentence purpose, (2) 2-3 concrete use cases w/ phrases | structured input ready for generation |
| 2 | Generate description | Apply pattern [What] + [When with phrases], enforcing rules below |
one complete description line |
| 3 | Validate | Check validation list below; regenerate if any fail | valid description, ready for frontmatter |
Generation rules (Step 2)
| Rule | Requirement |
|---|---|
| Length | Under 1024 characters — count strictly |
| Brackets | No < > (XML) allowed |
| Line breaks | Single line — no YAML multiline > or ` |
| Trigger phrases | Real words user would say, English only, comma-separated |
| File types | Mention if relevant (.md, .json, etc.) |
| Tone | "Use for X" not "Can be used for" |
Validation checklist (Step 3)
- Starts with action verb (Convert, Generate, Create, etc.)
- 3+ trigger phrases, English only
- No
< >brackets - Under 1024 chars
- Single line
Reference files
- references/examples.md — two worked examples (input → generated description)
- references/troubleshooting.md — common failure causes + fixes