skills-audit

npx skills add lobehub/lobehub --skill skills-audit --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

# Skills Audit Periodic review of the project-local skill set under `.agents/skills/`. The goal is to catch drift before the catalog becomes confusing — too many skills, overlapping triggers, descriptions that no longer match the body, references to skills that were renamed/deleted. **Recommended cadence:** weekly, or after any week where >1 skill was added/renamed. ## Procedure ### 1 — Inventory Build a fresh census of all SKILL.md files. Do NOT trust any prior cached list. ```bash find -L .agents/skills -name SKILL.md | wc -l # total count, including symlinked skills find -L .agents/skills -name SKILL.md -exec wc -l {} \; | sort -rn # by body length, including symlinked skills ``` Group by domain in a mental table (DB / state / UI / agent / testing / workflow / docs / etc.). Note new arrivals since last audit (`git log --since="1 week ago" -- .agents/skills/`). ### 2 — Pull frontmatter for all skills ```bash # Extract name + description for each SKILL.md for f in .agents/skills/*/SKILL.md; do echo "=== $(basename $(dirname $f)) ===" awk '/^---$/{c++; next} c==1' "$f" | head -20 done ``` Read the description block of every skill. The body can stay unread unless step 4 flags it. ##

find -L .agents/skills -name SKILL.md | wc -l                      # total count, including symlinked skills
find -L .agents/skills -name SKILL.md -exec wc -l {} \; | sort -rn # by body length, including symlinked skills
Extract name + description for each SKILL.md
for f in .agents/skills/*/SKILL.md; do
echo "=== $(basename $(dirname $f)) ==="
awk '/^---$/{c++; next} c==1' "$f" | head -20
done
Confirm the referenced code surface still exists
rg -l "response-compliance|openresponses" packages/ src/              # adjust per skill
git log --since="3 months ago" -- .agents/skills/ < skill > /SKILL.md # is it being maintained?