run-repo-cleanup
Installation
SKILL.md
Run Repo Cleanup
You ran a project. You spawned branches and parallel worktrees. Now you are done and the repo is a mess: live branches, worktrees, a dirty tree, and AI/dev artifacts scattered around. This skill sweeps all of that into a clean end state:
- Every live branch and worktree is reviewed like a human dev and merged into the main branch — locally, with
git merge --no-ff. No PRs. No fork. No remote review process. - Zero dangling branches afterward — none local, none on the remote.
- Every stale or conflicting branch is reported, never silently dropped.
- Every non-essential file (including hidden ones) is moved to a gitignored
to-delete/trash; docs are consolidated into a gitignoreddocs/. - A trustworthy report tells you exactly what happened — and a re-run on an already-clean repo says "nothing to do."
This is a finishing tool. Run it when the work is done, not mid-feature.
When To Use
Trigger on phrases and git states like: