What problem does it solve?
Audits and refines a skill repository, a single skill, a workflow framework, or an eval set. It covers design quality, context engineering, purpose fit, evidence discipline, and boundary clarity — the structural dimensions that assertion-based testing does not reach. When a target_repo is provided, it continues into compatibility review, extraction, and integration planning, complementing skill-creator by providing deep design-level judgment after functional tests pass.
Core Features & Use Cases
- Stage 1 Audit & Refine to diagnose structure, boundaries, and context engineering.
- Stage 2 Extract & Integrate when target_repo is provided, including upgrade guidance.
- 12-dimension scorecard measuring positioning, structure, governance, safety, and maintainability.
- Four-way extraction to classify findings as directly adoptable, adoptable after redesign, valuable as pattern, or should-not-adopt.
- Explicit integration planning to fit refined skills into a destination repository or workflow.
- Collaboration pattern with skill-creator and, on finalization, with skills-appreciation for interpretation.
Quick Start
Run skills-refiner on a finished skill to generate a Stage 1 audit and actionable refinement actions.