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:

  1. Move it under ~/.claude/skills-archive/<source>/<skill-name>/ (or ~/.codex/skills-archive/...)
  2. 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).
  3. 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

# 1. Generate fresh stats first
python3 ~/.claude/skills/skill-usage-stats/analyze.py --no-open
Installs
1
GitHub Stars
1
First Seen
Sep 17, 2026