branch-cleaner_skill

This skill helps you safely prune stale git branches locally and remotely with reversible steps and explicit delete commands.

JavaScript

105

GitHub Stars

1

Bundled Files

2 months ago

Catalog Refreshed

4 months ago

First Indexed

Readme & install

Copy the install command, review bundled files from the catalogue, and read any extended description pulled from the listing source.

Installation

Preview and clipboard use veilstrat where the catalogue uses aiagentskills.

npx veilstrat add skill jmerta/codex-skills --skill branch-cleaner

SKILL.md1.5 KB

Overview

This skill identifies stale Git branches and helps you safely prune them locally and on remotes with reversible, explicit commands. It groups candidates, explains why each branch is flagged, and only performs destructive actions after confirmation. Use it to audit branch hygiene and generate safe delete/prune commands rather than forcing automatic removals.

How this skill works

The skill first syncs with remotes (git fetch --prune) and inspects local status for uncommitted changes. It builds candidate lists: local merged, local unmerged, remote merged, and branches stale by last commit date. Protected branches (default branch, current branch, and user-specified patterns) are excluded. It presents grouped candidates, flags risks (unmerged or recent activity), and outputs explicit git and gh commands for approved deletions or pruning.

When to use it

Pruning branches after a release or sprint to reduce clutter
Auditing repository branch hygiene before cleanup work
Preparing a pull-request-based cleanup using gh to verify merged status
Generating safe, reviewable delete commands for local and remote branches
Enforcing retention rules (age, merged-only, keep patterns) across a repo

Best practices

Confirm the default base branch (main/master/develop) and current branch before actions
Specify keep patterns (e.g., release/*, hotfix/*) to protect important branches
Prefer listing and reviewing candidates first; only delete after explicit approval
Avoid remote deletions unless the user explicitly approves and understands consequences
Use gh CLI checks to correlate merged PRs when available for extra safety

Example use cases

List branches merged into main and produce local delete commands for approved ones
Detect branches with no recent commits older than X days and recommend pruning
Show remote branches merged into base and prepare git push --delete commands after approval
Audit branches that are not merged so you can decide whether to rebase, archive, or delete
Generate a step-by-step cleanup plan that includes fetching, status checks, candidate grouping, and delete commands

FAQ

No. It only generates and shows explicit delete/prune commands and performs deletions only after you confirm each action.

How does it decide which branches are stale?

It uses merged status, committer date sorting, and user-provided minimum age; protected patterns and the default/current branch are always excluded.

Can it remove remote branches?

Yes, but only if you explicitly approve remote deletion. It will warn about consequences and provide git push --delete or gh commands for review.