skills-refiner

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.