| name | skill-cleanup |
| description | Archive (not delete) Claude Code and Codex skills that are zero-use or stale (>90 days unused) based on a generated skill-stats.html report. Renames the SKILL.md inside each archived directory so agents stop discovering them, while keeping all content recoverable. Triggers — "clean up skills", "archive unused skills", "스킬 정리", "안 쓰는 스킬 정리", "skill archive". |
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.archived so the harness no longer treats it as an active skill (the harness only auto-discovers SKILL.md).
- Write a
.archived-meta.json next 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
python3 ~/.claude/skills/skill-usage-stats/analyze.py --no-open
python3 ~/.claude/skills/skill-cleanup/archive.py
python3 ~/.claude/skills/skill-cleanup/archive.py --apply
python3 ~/.claude/skills/skill-cleanup/archive.py restore <name>
python3 ~/.claude/skills/skill-cleanup/archive.py list-archive
Safety
- Default mode is dry-run.
- Never deletes; archive is fully reversible.
- Skips any skill not in the stats report (so you can't accidentally archive an unscanned skill).
- Refuses to operate on plugin cache paths (
~/.claude/plugins/cache/...) — those are managed by the plugin marketplace and a rename there would just be re-installed.
