tidy-up
Installation
SKILL.md
Tidy Up
Reclaim space and remove leftover local clutter without wrecking active work. Parse the first token as a command when it matches the table; otherwise map clear intent. Default with no useful target is scan (inventory + proposed cleanup), not blind delete.
Commands
| Command | What it does |
|---|---|
scan / plan / dry-run |
Inventory clutter; estimate size; propose deletions (no deletes) |
workspaces / worktrees |
Remove dangling / merged / abandoned git worktrees and empty workspace dirs |
artifacts / build |
Remove stale build outputs (dist, build, .next, site, coverage, etc.) |
caches |
Clear regenerable caches (tool/package caches in-repo; ask before global home caches) |
branches |
Prune stale local branches (merged / gone remote); never delete unmerged without approval |
deep |
Broader pass: workspaces + artifacts + caches + safe branch prune (still gated) |
all |
Same as deep for the current repo (or named path); still inventory → approve → delete |
help / library |
List commands |
Aliases: clean / cleanup / prune → map to the narrowest fitting command, or scan if unclear.