How do I install the Cleanup To Main skill?

Run npx skillmds@latest add egermano/cleanup-to-main in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Cleanup To Main safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Cleanup To Main?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Cleanup To Main free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Cleanup To Main?

egermano (@egermano) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Cleanup To Main by egermano — Agent Skill

Name: Cleanup To Main
Author: egermano

Cleanup To Main

Clean up local git branches that have been removed from the remote repository. Use when the user wants to tidy up their local git branches, remove stale branches, clean up after merging PRs, or mentions 'cleanup branches', 'remove old branches', 'prune local branches', 'git branch cleanup'. Safely handles uncommitted changes, preserves local-only branches, and provides a detailed report.

egermano Updated Sep 17, 2026

File contents

Cleanup to Main

Cleans up local git branches that have been deleted from the remote repository, with safety checks and detailed reporting.

Workflow

Pre-flight safety checks → Abort if uncommitted changes or branch not synced
Switch to default branch → Detect and checkout main or master
Fetch and prune → Update remote references with git fetch -p
Identify deletion candidates → Local branches whose remote no longer exists
Safe delete → Use git branch -d for each candidate
Generate report → Summarize deleted, skipped, and kept branches

Execution

Run the cleanup script directly:

./scripts/cleanup_branches.sh

Or execute step-by-step using git commands following the workflow above.

Safety Guarantees

Aborts on uncommitted changes - Working directory must be clean
Aborts on unsynced branch - Current branch must match origin
Preserves local-only branches - Branches never pushed are kept
Safe delete only - Uses git branch -d (fails if not merged)
Never deletes main/master - Protected branches always kept

Branch Categories

Category	Action	Reason
Deleted from remote	Delete	Tracking branch gone, safe to remove
Not fully merged	Skip	May contain unmerged work
Local-only (never pushed)	Skip	User's local work in progress
main/master	Keep	Protected default branches

Exit Codes

0 - Success (branches cleaned or nothing to clean)
1 - Safety abort (uncommitted changes or unsynced branch)
2 - Partial failure (some branches couldn't be deleted)

---name: cleanup-to-maindescription: Clean up local git branches that have been removed from the remote repository. Use when the user wants to tidy up their local git branches, remove stale branches, clean up after merging PRs, or mentions 'cleanup branches', 'remove old branches', 'prune local branches', 'git branch cleanup'. Safely handles uncommitted changes, preserves local-only branches, and provides a detailed report.---# Cleanup to MainCleans up local git branches that have been deleted from the remote repository, with safety checks and detailed reporting.## Workflow1. **Pre-flight safety checks** → Abort if uncommitted changes or branch not synced2. **Switch to default branch** → Detect and checkout `main` or `master`3. **Fetch and prune** → Update remote references with `git fetch -p`4. **Identify deletion candidates** → Local branches whose remote no longer exists5. **Safe delete** → Use `git branch -d` for each candidate6. **Generate report** → Summarize deleted, skipped, and kept branches## ExecutionRun the cleanup script directly:```bash./scripts/cleanup_branches.sh```Or execute step-by-step using git commands following the workflow above.## Safety Guarantees- **Aborts on uncommitted changes** - Working directory must be clean- **Aborts on unsynced branch** - Current branch must match origin- **Preserves local-only branches** - Branches never pushed are kept- **Safe delete only** - Uses `git branch -d` (fails if not merged)- **Never deletes main/master** - Protected branches always kept## Branch Categories| Category | Action | Reason ||----------|--------|--------|| Deleted from remote | Delete | Tracking branch gone, safe to remove || Not fully merged | Skip | May contain unmerged work || Local-only (never pushed) | Skip | User's local work in progress || main/master | Keep | Protected default branches |## Exit Codes- `0` - Success (branches cleaned or nothing to clean)- `1` - Safety abort (uncommitted changes or unsynced branch)- `2` - Partial failure (some branches couldn't be deleted)

Frequently asked questions