---
title: "git-cleanup"
description: "A Claude Code skill for safely cleaning up accumulated git worktrees and local branches."
type: skill
canonical_url: https://claudary.paisolsolutions.com/skills/readme-623
source: "Claudary"
difficulty: intermediate
author: "Claude Code Knowledge Pack"
date: 2026-07-10T11:36:45.233Z
license: CC-BY-4.0
attribution: "git-cleanup — Claudary (https://claudary.paisolsolutions.com/skills/readme-623)"
---

# git-cleanup
A Claude Code skill for safely cleaning up accumulated git worktrees and local branches.

## Overview

# git-cleanup

A Claude Code skill for safely cleaning up accumulated git worktrees and local branches.

## What It Does

Analyzes your local git repository and categorizes branches/worktrees into:

- **Safe to delete**: Branches fully merged into the default branch
- **Needs review**: Branches with deleted remotes (`[gone]`) that may have local-only work
- **Theme-related**: Groups of branches working on similar functionality
- **Keep**: Active work with unpushed commits or untracked local branches

The skill uses a gated workflow requiring explicit user confirmation before any deletions.

## When to Use

Invoke with `/git-cleanup` when you have accumulated many local branches and worktrees that need cleanup.

**Important**: This skill only runs when explicitly invoked. It will never suggest cleanup proactively or run automatically.

## Safety Features

- Two confirmation gates (analysis review, then deletion confirmation)
- Uses safe delete (`git branch -d`) for merged branches; force delete (`git branch -D`) only for squash-merged branches where git cannot detect the merge
- Blocks removal of worktrees with uncommitted changes
- Never touches protected branches (main, master, develop, release/*)
- Flags `[gone]` branches for review instead of auto-deleting

## Installation

```bash
claude plugins:add trailofbits/skills/git-cleanup
```

## Example

```
User: /git-cleanup

Claude: [Analyzes branches and worktrees]
        [Presents categorized tables]
        "I found 5 branches safe to delete, 2 needing review.
         Which would you like to clean up?"

User: "Delete the merged branches"

Claude: "I will delete these branches:
         - feature/auth
         - bugfix/login
         Confirm? (yes/no)"

User: "yes"

Claude: [Executes and reports results]
```

---

Source: [Claudary](https://claudary.paisolsolutions.com/skills/readme-623) · https://claudary.paisolsolutions.com