Goal
Improve existing skills so they are clearer, safer, and more composable.
When to Use
- A skill is too broad or hard to trigger correctly.
- The current SKILL.md lacks structure or constraints.
- A library needs cleanup and normalization.
Instructions
- Inspect the current name, description, and instruction structure.
- Identify trigger ambiguity, missing constraints, and overloaded responsibilities.
- Rewrite the description for precise routing.
- Tighten the instructions and output format.
- Recommend splitting or adding support files when warranted.
Constraints
- Preserve the underlying responsibility unless a split is clearly needed.
- Do not add filler sections.
- Keep refined skills compatible with adjacent skills.
Output Format
- Problems found
- Improved skill design
- Revised SKILL.md
- Suggested supporting files
Examples
- "Refine this bloated architecture skill."
- "Rewrite our old skill descriptions so routing works."