skills-refiner

Audit and refine skill repositories using a 12-dimension scorecard.

24|2|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/yknothing/skills-refiner --skill skills-refiner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skills-refiner
Source: https://github.com/yknothing/skills-refiner/tree/main/skills/skills-refiner
Command: npx skills add https://github.com/yknothing/skills-refiner --skill skills-refiner

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

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.

Frequently Asked Questions about skills-refiner

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit the design quality and boundaries of a skill repository?

To audit a skill repository, use a structured 12-dimension scorecard that evaluates positioning, structure, governance, safety, and maintainability. This design audit reveals structural dimensions and boundary clarity that standard assertion-based testing cannot reach.

What is the best way to integrate a new skill into an existing workflow framework?

Integrating a skill into a workflow framework requires explicit integration planning after a compatibility review. You classify extraction findings into four adoption categories, then fit the refined skill into the destination repository or workflow.

When do I need a design audit for my skills instead of functional testing?

You need a design audit when functional tests pass but you still need to evaluate context engineering, purpose fit, evidence discipline, and boundary clarity. It diagnoses structural quality issues that assertion-based testing does not cover.

Can I extract and classify specific skills from a repository for reuse?

Yes, you can extract and classify skills using a four-way extraction method. This classifies findings as directly adoptable, adoptable after redesign, valuable as a pattern, or should-not-adopt, guiding your compatibility planning and upgrade process.

How do I refine a single skill to improve its context engineering and governance?

Refine a single skill by running a Stage 1 audit to generate actionable refinement actions. It diagnoses the skill's structure, boundaries, and context engineering to guide targeted improvements across twelve governance and safety dimensions.