How do I install the Worktree Cleanup skill?

Run npx skillmds@latest add enverge-labs/worktree-cleanup 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 Worktree Cleanup 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 Worktree Cleanup?

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 Worktree Cleanup free to use?

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

Who published Worktree Cleanup?

Enverge-Labs (@enverge-labs) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Worktree Cleanup by enverge-labs — Agent Skill

Name: Worktree Cleanup
Author: Enverge-Labs

Worktree Cleanup

Tear down a finished task's git worktree and branch once its PR is merged or closed. Use when a task is done, a PR was merged/closed, or the user asks to clean up / remove / prune worktrees or stale branches. Companion to the `worktree-new` skill; applies to whatever repository Claude is currently in.

Enverge-Labs 2700ef8 2.5 KB Updated Sep 17, 2026

File contents

Worktree cleanup

Remove worktrees and branches whose PR is merged or closed. Destructive — never discard uncommitted or unpushed work.

Find the repo

ROOT="$(git rev-parse --show-toplevel)" || { echo "not a git repo"; exit 1; }

If $ROOT/WORKTREES.md exists, follow its naming/location — the repo's doc is the source of truth. Defaults below: worktrees under .claude/worktrees/<slug>/, branches worktree-<slug>.

Decide what's done

List worktrees and check each branch's PR state (MERGED / CLOSED / OPEN, or no PR):

git -C "$ROOT" fetch --prune origin
git -C "$ROOT" worktree list --porcelain          # path + branch per worktree

# per candidate branch:
gh pr view "$BRANCH" --json state,url --jq '"\(.state)\t\(.url)"'   # no PR ⇒ non-zero exit

A worktree is a cleanup candidate only if its PR is MERGED or CLOSED. Leave OPEN and no-PR worktrees alone.

Verify it's safe (per candidate)

Before removing, confirm nothing would be lost — skip and report any that fail:

git -C "$WORKTREE" status --porcelain            # must be empty (no uncommitted/untracked)
git -C "$WORKTREE" log --oneline "@{u}.." 2>/dev/null   # must be empty (no unpushed commits)

Dirty or unpushed → stop, show the user, do not --force.
Present the full candidate list and get a go-ahead before deleting.

Remove

Run from $ROOT (never from inside the worktree you're removing):

git -C "$ROOT" worktree remove ".claude/worktrees/${SLUG}"   # refuses if dirty — that guard is intentional
git -C "$ROOT" branch -d "worktree-${SLUG}" \
  || git -C "$ROOT" branch -D "worktree-${SLUG}"             # -D only after PR confirmed MERGED/CLOSED (squash-merge leaves -d "not fully merged")
git -C "$ROOT" worktree prune

Notes

Squash/rebase merges make git branch -d report "not fully merged"; the -D fallback is safe because the PR state is already confirmed merged/closed — not as a blanket habit.
Never delete the main checkout or its default branch.
Unreachable ≠ deletable: a failed gh call (network/auth) is not a closed PR. Confirm state before removing.

---name: worktree-cleanupdescription: Tear down a finished task's git worktree and branch once its PR is merged or closed. Use when a task is done, a PR was merged/closed, or the user asks to clean up / remove / prune worktrees or stale branches. Companion to the `worktree-new` skill; applies to whatever repository Claude is currently in.---# Worktree cleanupRemove worktrees and branches whose PR is **merged or closed**. Destructive — never discard uncommitted or unpushed work.## Find the repo```bashROOT="$(git rev-parse --show-toplevel)" || { echo "not a git repo"; exit 1; }```**If `$ROOT/WORKTREES.md` exists, follow its naming/location** — the repo's doc is the source of truth. Defaults below: worktrees under `.claude/worktrees/<slug>/`, branches `worktree-<slug>`.## Decide what's doneList worktrees and check each branch's PR state (`MERGED` / `CLOSED` / `OPEN`, or no PR):```bashgit -C "$ROOT" fetch --prune origingit -C "$ROOT" worktree list --porcelain # path + branch per worktree# per candidate branch:gh pr view "$BRANCH" --json state,url --jq '"\(.state)\t\(.url)"' # no PR ⇒ non-zero exit```A worktree is a **cleanup candidate** only if its PR is `MERGED` or `CLOSED`. Leave `OPEN` and no-PR worktrees alone.## Verify it's safe (per candidate)Before removing, confirm nothing would be lost — skip and report any that fail:```bashgit -C "$WORKTREE" status --porcelain # must be empty (no uncommitted/untracked)git -C "$WORKTREE" log --oneline "@{u}.." 2>/dev/null # must be empty (no unpushed commits)```- Dirty or unpushed → **stop, show the user, do not `--force`.**- Present the full candidate list and get a go-ahead before deleting.## RemoveRun from `$ROOT` (never from inside the worktree you're removing):```bashgit -C "$ROOT" worktree remove ".claude/worktrees/${SLUG}" # refuses if dirty — that guard is intentionalgit -C "$ROOT" branch -d "worktree-${SLUG}" \ || git -C "$ROOT" branch -D "worktree-${SLUG}" # -D only after PR confirmed MERGED/CLOSED (squash-merge leaves -d "not fully merged")git -C "$ROOT" worktree prune```## Notes- Squash/rebase merges make `git branch -d` report "not fully merged"; the `-D` fallback is safe *because the PR state is already confirmed merged/closed* — not as a blanket habit.- Never delete the main checkout or its default branch.- Unreachable ≠ deletable: a failed `gh` call (network/auth) is not a closed PR. Confirm state before removing.

Frequently asked questions