git:20260817.6659473 to git:20260827.f2233af

- description: Clean up all git branches marked as [gone] (branches deleted on the remote but still existing locally), including removing associated worktrees.

- # Clean Gone Branches Skill

-

- Remove stale local branches that have been deleted from the remote repository, along with any associated worktrees.

-

- ## When to Use

-

- - After merging and deleting remote branches, to clean up local tracking branches.

- - When `git branch -v` shows branches marked as `[gone]`.

- - Periodic local repository maintenance.

-

- ## Agent Compatibility

-

- This skill is tool-agnostic and can be executed by Claude Code, Codex CLI, or Cursor CLI.

-

- ## Inputs

-

- - None required. The skill operates on the current git repository.

-

- Before deleting anything, inspect the branch list and worktree list so the user can understand what will be removed.

-

- ## Workflow

-

- 1. **List branches** to identify any with `[gone]` status:

-

- ```bash

- git branch -v

- ```

-

- Branches with a `+` prefix have associated worktrees and must have their worktrees removed before deletion.

-

- 2. **List worktrees** that may need removal for `[gone]` branches:

-

- ```bash

- git worktree list --porcelain

- ```

-

- 3. **Remove worktrees and delete `[gone]` branches**. Strip leading `+`, `*`, or spaces from `git branch -v` output before extracting branch names. Match worktrees by their exact `refs/heads/<branch>` entry instead of parsing the human-readable worktree summary:

-

- ```bash

- current_branch=$(git branch --show-current)

- repo_root=$(git rev-parse --show-toplevel)

-

- git branch -v | grep '\[gone\]' | sed 's/^[+* ]//' | awk '{print $1}' | while IFS= read -r branch; do

- echo "Processing branch: $branch"

-

- if [ "$branch" = "$current_branch" ]; then

- echo " Skipping current branch"

- continue

- fi

-

- worktree=$(

- git worktree list --porcelain |

- awk -v ref="refs/heads/$branch" '

- $1 == "worktree" { path = substr($0, 10) }

- $1 == "branch" && $2 == ref { print path; exit }

- '

- )

-

- if [ -n "$worktree" ] && [ "$worktree" != "$repo_root" ]; then

- echo " Removing worktree: $worktree"

- git worktree remove --force "$worktree"

- fi

-

- echo " Deleting branch: $branch"

- git branch -D -- "$branch"

- done

- ```

-

- 4. **Report results**: List which worktrees and branches were removed or skipped. If no branches are marked as `[gone]`, report that no cleanup was needed.

-

- ## Safety Notes

- - Do not delete the current branch; skip it even if it is marked `[gone]`.

- - Do not remove the repository's main worktree.

- - Only delete branches shown by `git branch -v` as `[gone]`; do not infer stale branches by name.

- - Match associated worktrees through `git worktree list --porcelain` using the exact branch ref.

- ## Outputs

- - Console output listing removed worktrees and deleted or skipped branches.

- - If no `[gone]` branches exist, a message indicating no cleanup was needed.