skill-cleanup
Installation
SKILL.md
Skill Cleanup
Companion to skill-usage-stats. Reads the same HTML report and archives skills marked DELETE (or matching user-chosen criteria) without deleting any files.
How archiving works
For each chosen skill directory:
- Move it under
~/.claude/skills-archive/<source>/<skill-name>/(or~/.codex/skills-archive/...) - Inside the archived directory, rename
SKILL.md→SKILL.md.archivedso the harness no longer treats it as an active skill (the harness only auto-discoversSKILL.md). - Write a
.archived-meta.jsonnext to it recording original path, archive date, and the reason from the stats report.
Reverse: restore <name> moves it back and renames SKILL.md.archived → SKILL.md.
How to run
# 1. Generate fresh stats first
python3 ~/.claude/skills/skill-usage-stats/analyze.py --no-open