cm-skill-evolutionlisted
Install: claude install-skill tody-agent/codymaster
# cm-skill-evolution
Use this skill after `cm-skill-health` identifies a degraded or broken skill, or when `cm advisory handoff --for cm-skill-evolution` produces a structured recovery note.
## Modes
### FIX
Use when the skill should exist already but is inaccurate, broken, or partially missing.
Checklist:
- repair broken references
- restore missing support files
- align docs and profiles
- re-run skill validation and test gate
### DERIVED
Use when the original promise was too ambitious, but the repo has enough primitives to ship a truthful MVP.
Checklist:
- keep the same user problem
- reduce claims to what the code can support today
- reuse existing repo building blocks instead of inventing a new subsystem
### CAPTURED
Use when the main value is operational learning rather than a new code path.
Checklist:
- append the lesson with `cm retro --project . --tool skill --note "..."`
- record durable context in `.cm/CONTINUITY.md`
- update the relevant skill so future sessions do not repeat the same failure
## Evolution Loop
1. Start from the health note.
- Preferred source: `cm advisory handoff --for cm-skill-evolution`
2. Pick one mode only.
3. Define the smallest truthful recovery.
4. Patch the skill and its discovery surfaces.
5. Verify:
- `npm run validate:skills`
- `npm run check:skills`
- repo test gate if code or docs wiring changed materially
6. Capture the lesson in retro and continuity.
## Decision guide
- The feature existed and drifted: `FIX`