Skill Self-Refiner
Patch existing skills from runtime failure, not vibes.
When to Use
- A loaded skill gave wrong steps, missing gates, or stale commands
- Fresh-context dry run failed a checklist item
- User corrected the agent mid-skill and the fix should stick
Not for: creating a skill with no prior file → writing-skills or trajectory-to-packaged-skill.
Not for: prose-only polish → punchy-insight-refiner.
Process
- Load current
SKILL.md+ failure evidence (log, user correction, test output). - Name the broken contract line (when_to_use / step N / NEVER / produces).
- Patch minimum text that would have prevented the failure.
- Add or tighten a Verification bullet that catches the same miss.
- Write a 3–5 item regression checklist; run it once in fresh wording.
- Record diff summary (before → after) in the response.
NEVER
- Rewrite the whole skill when one step failed
- Invent new capabilities not proven in the failure run
- Drop
produces/requiresduring polish
Collision parents
trajectory-to-packaged-skill, writing-skills, punchy-insight-refiner