Skip to content
TakoAPI
Back to skills

skill-refiner

by 1va7

Web & Frontend Development
433Downloads reported by clawskills.sh
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Audit and fix all skills in the workspace for compliance with skill-creator requirements.

Description

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

INPUT

User asks: refine all skills in my workspace

AGENT
  1. 1

    Runs find_skills.sh to locate every SKILL.md across the entire workspace

  2. 2

    Runs audit_skill.py on each discovered skill directory and collects results

  3. 3

    Builds a summary table of issues, warnings, and compliance status per skill

  4. 4

    Applies fixes in priority order: frontmatter, extra fields, weak descriptions, extraneous files, wrong location, naming violations

  5. 5

    Re-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

Installation

clawhub install 1va7/skill-refiner

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links