✓ Verified 💻 Development ✓ Enhanced Data

Skill Refiner

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

Rating
4.9 (171 reviews)
Downloads
11,720 downloads
Version
1.0.0

Overview

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

✨Key Features

1

— Discover all skills

2

— Audit each skill

3

— Report findings

4

— Fix non-compliant skills

5

— Validate fixes

Complete Documentation

View Source →

Skill Refiner

Finds every skill in the workspace, audits each against skill-creator requirements, and fixes non-compliant ones.

Workflow

Step 1 — Discover all skills

bash
bash scripts/find_skills.sh [workspace_dir]

This searches the entire workspace for SKILL.md files (not just skills/). Skills created without following skill-creator conventions may end up anywhere.

Step 2 — Audit each skill

bash
python3 scripts/audit_skill.py <skill-dir>

Returns JSON with:

  • issues — blocking problems that must be fixed
  • warnings — advisory improvements
  • compliant — true only when issues is empty
Run this on every path returned by Step 1. Batch example:

bash
bash scripts/find_skills.sh | while read dir; do
  python3 scripts/audit_skill.py "$dir"
done

Step 3 — Report findings

Summarize results in a table:

SkillLocationIssuesWarningsStatus
my-skillskills/my-skill01⚠️
bad-skilltemp/bad-skill20❌

Step 4 — Fix non-compliant skills

For each skill with issues, fix in this order:

  • Missing/malformed frontmatter — Add or correct the --- block with name and description only
  • Extra frontmatter fields — Remove any fields other than name and description
  • Weak description — Rewrite to include: what the skill does + trigger conditions ("Use when...")
  • Extraneous files — Delete README.md, INSTALLATION_GUIDE.md, CHANGELOG.md, etc.
  • Wrong location — If a skill is outside skills/, move it to ~/.openclaw/workspace/skills//
  • Naming violations — Rename directory to lowercase-hyphen-case
For warnings (advisory):
  • Long SKILL.md (>500 lines): extract detailed content into references/ files and link from SKILL.md
  • Unlinked references: add links in SKILL.md body
  • Weak description: improve trigger language

Step 5 — Validate fixes

Re-run audit_skill.py on each fixed skill to confirm "compliant": true.

Optionally package with:

bash
python3 /opt/homebrew/lib/node_modules/openclaw/skills/skill-creator/scripts/package_skill.py <skill-dir>

Compliance Checklist

A compliant skill must have:

  • [ ] SKILL.md at the root of a named directory
  • [ ] YAML frontmatter with exactly name and description (no other fields)
  • [ ] description includes what the skill does AND when to trigger it
  • [ ] Directory name: lowercase letters, digits, hyphens only; ≤64 chars
  • [ ] No extraneous files (README.md, CHANGELOG.md, etc.)
  • [ ] Resources only in scripts/, references/, or assets/
  • [ ] All references/ files linked from SKILL.md body
  • [ ] SKILL.md body ≤500 lines (split into references/ if longer)

Installation

Terminal bash 

openclaw install skill-refiner
Copied!

💻Code Examples

bash scripts/find_skills.sh [workspace_dir]

bash-scriptsfindskillssh-workspacedir.txt
This searches the **entire workspace** for `SKILL.md` files (not just `skills/`). Skills created without following skill-creator conventions may end up anywhere.

### Step 2 — Audit each skill

python3 scripts/audit_skill.py <skill-dir>

python3-scriptsauditskillpy-skill-dir.txt
Returns JSON with:
- `issues` — blocking problems that must be fixed
- `warnings` — advisory improvements
- `compliant` — true only when issues is empty

Run this on every path returned by Step 1. Batch example:

done

done.txt
### Step 3 — Report findings

Summarize results in a table:

| Skill | Location | Issues | Warnings | Status |
|-------|----------|--------|----------|--------|
| my-skill | skills/my-skill | 0 | 1 | ⚠️ |
| bad-skill | temp/bad-skill | 2 | 0 | ❌ |

### Step 4 — Fix non-compliant skills

For each skill with issues, fix in this order:

1. **Missing/malformed frontmatter** — Add or correct the `---` block with `name` and `description` only
2. **Extra frontmatter fields** — Remove any fields other than `name` and `description`
3. **Weak description** — Rewrite to include: what the skill does + trigger conditions ("Use when...")
4. **Extraneous files** — Delete README.md, INSTALLATION_GUIDE.md, CHANGELOG.md, etc.
5. **Wrong location** — If a skill is outside `skills/`, move it to `~/.openclaw/workspace/skills/<skill-name>/`
6. **Naming violations** — Rename directory to lowercase-hyphen-case

For warnings (advisory):
- Long SKILL.md (>500 lines): extract detailed content into `references/` files and link from SKILL.md
- Unlinked references: add links in SKILL.md body
- Weak description: improve trigger language

### Step 5 — Validate fixes

Re-run `audit_skill.py` on each fixed skill to confirm `"compliant": true`.

Optionally package with:
example.sh
bash scripts/find_skills.sh | while read dir; do
  python3 scripts/audit_skill.py "$dir"
done

Tags

#web_and-frontend-development

Quick Info

Category Development
Model Claude 3.5
Complexity One-Click
Author 1va7
Last Updated 3/10/2026
🚀
Optimized for
Claude 3.5
🧠

Ready to Install?

Get started with this skill in seconds

openclaw install skill-refiner

Resources

📂
OpenClaw Skills
View on OpenClaw GitHub
→

Related Skills

✓ Verified 💻 Development

4claw

4claw — a moderated imageboard for AI agents.

🧠 Claude-Ready #ai_and-llms
)}
★ 4.4 (118)
↓ 4,990
v1.0.0
✓ Verified 💻 Development

Aap Passport

Agent Attestation Protocol - The Reverse Turing Test.

🧠 Claude-Ready #ai_and-llms
)}
★ 4.3 (89)
↓ 4,621
v1.0.0
✓ Verified 💻 Development

Acestep Lyrics Transcription

Transcribe audio to timestamped lyrics using OpenAI Whisper or ElevenLabs Scribe API.

⚡ GPT-Optimized #ai_and-llms #api #script
)}
★ 3.8 (274)
↓ 17,648
v1.0.0
✓ Verified 💻 Development

Adaptive Suite

A continuously adaptive skill suite that empowers Clawdbot.

🧠 Claude-Ready #ai_and-llms #bot
)}
★ 4.7 (88)
↓ 1,625
v1.0.0