Enhance Skill

Review an existing skill and apply improvements in one pass — structure, description, and content quality.

Quick start

/enhance-skill path/to/skill-name/ — enhance a skill by path /enhance-skill skill-name — enhance an installed skill by name

Workflow

1. Locate and read the skill

Find the skill folder and read all files (SKILL.md and any supporting files).

2. Review against guidelines

Evaluate every criterion from the write-a-skill checklist:

Description

• Present and under 1024 chars
• Written in third person
• First sentence states what it does
• Includes "Use when [specific triggers]"
• Triggers specific enough to distinguish from similar skills

SKILL.md structure

• Valid frontmatter (name, description)
• Under 100 lines
• No time-sensitive information
• Consistent terminology throughout
• Concrete examples included
• References one level deep

File structure

• Content split into separate files when SKILL.md > 100 lines
• Scripts only for deterministic, repeated operations
• No unnecessary files

Content quality

• Instructions are clear and unambiguous
• Steps are actionable, not vague
• No redundant or duplicated guidance
• Appropriate level of detail — not too terse, not over-explained
• Examples reflect real use cases

3. Propose improvements

Present a concise summary of all proposed changes grouped by category:

• Must fix — structural or description failures that affect reliability
• Should fix — warnings and content clarity issues
• Optional — style or minor readability improvements

For each item, show a brief before/after or description of the change.

Ask the user: "Would you like a full review report before applying changes?"

• If yes — produce the report using the format in REPORT.md, then ask for approval to proceed.
• If no — ask for approval to apply changes directly.

4. Apply changes

With user approval, rewrite the affected files in place. Do not change anything not listed in the proposal.

5. Confirm

Show a diff summary of what changed. Re-run the checklist and confirm all previously failing criteria now pass.