Setup & Installation
openclaw skills install @1va7/skill-refiner
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
npx clawhub install skill-refiner
What This Skill Does
Audits every SKILL.md in a workspace against skill-creator compliance rules and repairs non-compliant skills. It searches the entire workspace, not just the skills/ directory, to catch misplaced skills. Fixes cover frontmatter corrections, description rewrites, extraneous file removal, and directory renaming.
Instead of checking each SKILL.md by hand, it batches discovery, auditing, and repair across the entire workspace in a single run.
When to use it
- Auditing a workspace after bulk-importing skills from external sources
- Catching non-compliant skills before packaging them for distribution
- Fixing frontmatter errors across multiple skills in one pass
- Locating skills stored outside the expected skills/ directory
- Validating skill compliance after restructuring a skill directory
Example Workflow
Here's how your AI assistant might use this skill in practice.
INPUT
User asks: refine all skills in my workspace
AGENT
- 1Runs find_skills.sh to locate every SKILL.md across the entire workspace
- 2Runs audit_skill.py on each discovered skill directory and collects results
- 3Builds a summary table of issues, warnings, and compliance status per skill
- 4Applies fixes in priority order: frontmatter, extra fields, weak descriptions, extraneous files, wrong location, naming violations
- 5Re-runs audit_skill.py on each fixed skill to confirm compliant: true
OUTPUT
All skills pass audit with compliant: true; a summary table lists each skill's location and final status