git-branch-cleanup

Original：🇺🇸 English

Translated

Safely clean merged and stale git branches with explicit confirmations.

1installs

Added on2026-02-13

NPX Install

npx skill4agent add tmeister/skills git-branch-cleanup

Use this skill to safely remove merged or stale branches with explicit user confirmation.

Check repository state
- ```
git status --porcelain
```
- If not clean, ask the user to commit or stash first.

Detect default branch

git symbolic-ref refs/remotes/origin/HEAD | sed 's@^refs/remotes/origin/@@'

Define protected branches
- Default:
```
main
```
  ,
```
master
```
  ,
```
develop
```
  ,
```
staging
```
  ,
```
production
```
  ,
```
qa
```
  .
- Ask the user if any additional branches should be protected.
List merged branches
- Local:
```
git branch --merged <default-branch>
```
- Remote:
```
git branch -r --merged <default-branch>
```
- Exclude protected branches and the current branch.
- Present the list and ask for explicit approval to delete.
List stale branches
- Show last commit date for each local branch:
```
git for-each-ref --format='%(refname:short) %(committerdate:short)' refs/heads
```
- Ask user for a cutoff (default 30 days).
- Present the stale list and ask for explicit approval to delete.
Delete with confirmation
- Local delete:
```
git branch -d <branch>
```
- If deletion fails because it is unmerged, ask whether to force delete with
```
-D
```
  .
Remote cleanup
- Prune tracking branches:
```
git remote prune origin
```
- For remote branches approved for deletion:
```
git push origin --delete <branch>
```
Report and recovery
- Summarize what was deleted.
- Provide recovery hint:
```
git reflog --no-merges --since="2 weeks ago"
```
  .

Provide: