← Back to the Impact Hub
AI Her Way · Optimise

Skills Health Check

Your skill library drifts. Skills pile up, two start competing for the same request, descriptions go thin, safety gets assumed instead of written. This audits every skill against one standard, shows you a map of how they all connect, and walks you through the fixes one at a time.

Download the skill See a sample report
Runs on your machine. It reads your skills folder where it already lives and builds the report locally. Nothing is uploaded, nothing is sent to us. You own every file.

How it works

1

Install the skill

Download the file and drop it into your skills folder, or save it from Cowork. Five minutes, one time. Setup for every tool is below.

2

Say "audit my skills"

Point it at the folder your skills live in. It scans every file, scores each one, and finds the ones quietly competing for the same prompt.

3

Get your map and fix queue

You get an interactive map of your whole library and a priority list of fixes. It drafts each fix and applies it only when you say yes, backing up first.

What it checks

Two halves, each scored out of 100. A great skill scores high on both. The score is a prompt to act, not a verdict.

Hygiene

Will Claude actually obey it

  • One clear job, described in three sentences
  • A boundary line so it stops competing with its neighbours (the number-one reason Claude picks the wrong skill)
  • Non-negotiable rules pulled to the top
  • Clean structure, no broken body, no em dashes
  • No stale dates, no dead pointers to skills that do not exist
EquiAI

Is it safe, honest and yours

  • Consent and least privilege, human in the loop, a line it will not cross
  • Transparency when AI acts as you (the most-missed one)
  • Honesty, never fabricates facts or numbers
  • Research-led, portable, traceable
  • Scored on the eight pillars it actually writes into the file, not just mentions

Set it up in five minutes

Pick the path that matches where you work. You only need the skill and Python, which almost every Claude environment already has.

Claude Code

  1. Unzip the skill into ~/.claude/skills/skills-health-check (or your project's .claude/skills/).
  2. Start a session in that folder.
  3. Say "audit my skills" and point it at your skills folder.

Claude desktop / Cowork

  1. Open the .skill file and click Save skill to install.
  2. In a new chat, say "audit my skills".
  3. Tell it where your skills folder is. It builds the report as a file you open in your browser.

No Claude, just the report

  1. Unzip the skill. You need Python 3.8 or newer.
  2. Run python3 scripts/audit_skills.py <your_skills_folder>
  3. Then python3 scripts/build_dashboard.py skills_data.json and open the HTML.

The one rule that makes it safe

It never changes a file without showing you the exact edit and getting a clear yes. It never deletes anything. It never reaches outside the skills folder you point it at, and it backs up every file before it touches it. The scores are advisory, you own every file, before and after.

Ready to tidy your library?

Download the skill
A single .skill file (a zip of plain markdown and Python). You own all of it. No lock-in.