Skill Evolution

Concept of the skill

Skill evolution is the corpus walker around individual skill maintenance. The primitives are: a skill corpus; each skill's SKILL.md teaching/routing contract; each skill's audit-state.json Audit Status sidecar; an analyzer that turns Audit Status, scores, and registry facts into a priority queue; a triage step that selects bounded work; an executor that runs improve/scaffold/eval-generation actions; a verification step that keeps or reverts; and checkpoint logs that let the run resume.

Coverage

Skill evolution is the project-grounded discipline for running Skill Graph's corpus-level evolve operation. It covers:

• The public command: skill-graph evolve
• The bundled implementation: skill-graph/lib/audit/skill-evolution-loop.js
• The action loop: analyze -> triage -> execute -> verify -> checkpoint
• The priority model: Audit Status, application verdicts, scores, registry facts, staleness, and action types
• The keep-or-revert spine for improvement actions
• Standalone workspace flags and the removal of cross-repo path assumptions
• The boundary between walking a corpus and auditing, improving, evaluating, or scaffolding one skill

This skill is project-grounded to Skill Graph. It does not teach generic habit formation, generic evaluation theory, or first-time skill authoring.