Skill Cleaner

Use this when trimming skill prompt budget, finding duplicate skills, auditing enabled/disabled skill roots, or deciding which skills/plugins to remove.

This is adapted for Joel's system from Peter Steinberger's agent-scripts skill-cleaner skill.

Joel System Contract

Canonical joelclaw skills live in ~/Code/joelhooks/joelclaw/skills/.
Consumer skill dirs should usually symlink into canonical skills:
- ~/.pi/agent/skills/<name>
- ~/.agents/skills/<name>
- ~/.claude/skills/<name>
External skill packs may live under ~/.pi/agent/git/, ~/.pi/agent/npm/node_modules/, or extension directories. Do not copy those into joelclaw unless Joel explicitly wants a curated fork.
Preserve project-local skills and repo policy even when they look redundant. They often encode operational truth.

Workflow

Run the analyzer from this skill directory or the joelclaw repo root: