skill-audit-router
Your AI agent has hundreds of skills. Most of them can't be found.
This tells you which ones — and fixes them.
Works with Claude Code, OpenClaw, Hermes, or anything that loads SKILL.md files.
The idea, in plain words
Imagine your agent has a toolbox with 200 tools. Every tool has a label on it.
When you ask the agent to do something, it doesn't look inside the tools. It reads the
labels and picks one.
Two things go wrong, and you can't see either of them:
🧰 Half the tools aren't actually in the box.
They're in a drawer, a spare box in the garage, or they're copies of the same hammer.
You think you have 200. You might have 80.
🏷️ Half the labels are unreadable.
A tool labelled "Helper mode" will never be picked for "fix my leaky tap" —
because nothing in the label matches what you asked for.
This tool opens the box, counts what's really there, and tells you which labels
nobody can read. Then it writes you a to-do list for fixing them.
Try it in 30 seconds
No setup. No install. No API key. It ships with four example skills so you can see
exactly what it does before pointing it at anything of yours.
git clone https://github.com/rushindrasinha/skill-audit-router.git
cd skill-audit-router
python3 skill_audit.py --roots examples/fixture-skills --include-workspace
That's the screenshot above. Four example skills, each teaching one lesson:
| Example skill | Score | What it shows you |
|---|
good-example | 86 🟢 | Says what it makes, lists the exact words a user would type, and says what it's not for |
confusable-a | 60 🟡 | Nearly identical to its twin — the tool catches the collision |
confusable-b | 60 🟡 | …the other half of that pair, flagged at margin 0.038 |
weak-example | 21 🔴 | Labelled "Helper mode." — unfindable, and the report says exactly why |
Why --include-workspace? The examples live in this repo, not in your agent's real
skills folder. By default the audit ignores anything your agent can't actually load —
which is the whole point. This flag says "look at them anyway."
The problem, measured
Run it on a