Agent skill

Clean Branches

by kdlbs in kdlbs/kandev

Delete local branches whose remote has been deleted ([gone]), including their worktrees.

AGPL-3.0Auto-check passedDevelopment

Install Clean Branches

skills CLI
$ npx skills add kdlbs/kandev --skill clean-branches -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install kdlbs/kandev clean-branches --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/kdlbs/kandev.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/clean-branches .claude/skills/clean-branches && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
clean-branches
GitHub stars
909
Token cost
~328 tokens
SKILL.md length
75 words
Files
1
Skills in repo
45
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Delete local branches whose remote has been deleted ([gone]), including their worktrees.

  • Works in 5 steps: Fetch and prune remote refs → List branches to identify [gone] status → List worktrees for reference → …
  • Branch cleanup after merging PRs
  • Calls git
  • Tasks that involve Git worktrees

What it does

Clean Branches is an agent skill from kdlbs/kandev. Delete local branches whose remote has been deleted ([gone]), including their worktrees. Use for branch cleanup after merging PRs.

Its SKILL.md is about 330 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Git worktrees. The repository describes itself as: AI Kanban & Development Environment. Orchestrate multiple agents, review changes, open PRs. Multi-provider, self-hostable, no telemetry. The licence is AGPL-3.0.

When your agent uses it

  • Branch cleanup after merging PRs
  • Tasks that involve Git worktrees

Example prompts

  • “/clean-branches”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Fetch and prune remote refs
  2. List branches to identify [gone] status
  3. List worktrees for reference
  4. Remove worktrees and delete [gone] branches
  5. Report which branches and worktrees were removed. If none were [gone], say no cleanup was needed.

What it can do on your machine

Read from SKILL.md and the folder at commit bd63da3. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Clean Branches loads about 328 tokens when it runs. Until then it costs about 36 tokens; SKILL.md has 75 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~36
When it runs · the whole SKILL.md, loaded when a task matches
~328

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from kdlbs/kandev at commit bd63da3, republished under its AGPL-3.0 licence (© kdlbs). 75 words, ~328 tokens.

Download SKILL.mdSave it as .claude/skills/clean-branches/SKILL.md (or your agent's skills folder).
name
clean-branches
description
Delete local branches whose remote has been deleted ([gone]), including their worktrees. Use for branch cleanup after merging PRs.

Clean Branches

Remove local branches that have been deleted on the remote (marked [gone]), including any associated git worktrees.

Steps

  1. Fetch and prune remote refs:

    bash
    git fetch --prune
  2. List branches to identify [gone] status:

    bash
    git branch -v

    Branches with a + prefix have associated worktrees that must be removed before deletion.

  3. List worktrees for reference:

    bash
    git worktree list
  4. Remove worktrees and delete [gone] branches:

    bash
    git branch -v | grep '\[gone\]' | sed 's/^[+* ]//' | awk '{print $1}' | while read branch; do
      echo "Processing branch: $branch"
      worktree=$(git worktree list | grep "\\[$branch\\]" | awk '{print $1}')
      if [ ! -z "$worktree" ] && [ "$worktree" != "$(git rev-parse --show-toplevel)" ]; then
        echo "  Removing worktree: $worktree"
        git worktree remove --force "$worktree"
      fi
      echo "  Deleting branch: $branch"
      git branch -D "$branch"
    done
  5. Report which branches and worktrees were removed. If none were [gone], say no cleanup was needed.

© kdlbs, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/clean-branches of kdlbs/kandev.

Open the folder on GitHubat commit bd63da3

Compare with similar skills

Clean Branches next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Clean Branches compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Clean Branches this skillkdlbs/kandev909—~328Automated safety check: PassAGPL-3.0
Kanvibe Release Deployrookedsysc/kanvibe143—~12kAutomated safety check: NotesAGPL-3.0
Orca CLIaiskillstore/marketplace4301 repos~985Automated safety check: PassNone
Finishing a Development Branchobra/superpowers297k5 repos~1.9kAutomated safety check: PassMIT
Migrate Core Code to Submodulestinyhumansai/openhuman42k—~2.6kAutomated safety check: PassGPL-3.0
Finishing A Development Branchfarm-fe/farm5.6k34 repos~1.8kAutomated safety check: PassMIT

Similar skills

  • Kanvibe Release Deploy

    rookedsysc/kanvibe

    A skill your agent uses whenever releasing or deploying KanVibe desktop from a clean, up-to-date dev checkout: ask only for the target version and release-note approval, then let the AI update…

    143 GitHub stars~12k tokensUpdated today
    DevelopmentAuto-check: notes
  • Orca CLI

    aiskillstore/marketplace

    Use the public orca CLI to operate Orca-managed worktrees, folder contexts, terminals, repos, automations, artifacts, skill sharing, worktree comments, and the browser embedded inside the Orca app.

    430 GitHub starsUsed in 1 repo~985 tokens
    DevelopmentAuto-check passed
  • Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.

    297k GitHub starsUsed in 5 repos~1.9k tokens
    DevelopmentAuto-check passed
  • Migrate Core Code to Submodules

    tinyhumansai/openhuman

    Plans and carries out moving non-host-specific code and its tests from the OpenHuman core into vendored tiny submodule libraries, then releases the submodule and re-pins the host.

    42k GitHub stars~2.6k tokensUpdated today
    DevelopmentAuto-check passed
  • A skill your agent uses when implementation is complete, all tests pass, and you need to decide how to integrate the work - guides completion of development work by presenting structured options for…

    5.6k GitHub starsUsed in 34 repos~1.8k tokens
    DevelopmentAuto-check passed
  • Git Worktree Cleanup

    lobehub/lobehub

    Audits stale Git worktrees and branches with a bundled script, classifies each one, and deletes only after you approve the exact candidates.

    83k GitHub stars~2.8k tokensUpdated today
    DevelopmentAuto-check passed

More from kdlbs/kandev

All 45 skills in this repo
  • PR Walkthrough

    kdlbs/kandev

    Generate a single-file HTML walkthrough that explains a PR's purpose, user impact, interface changes, compatibility risks, and implementation.

    909 GitHub stars~6.3k tokensUpdated today
    Auto-check passed
  • Debug

    kdlbs/kandev

    Diagnose Kandev bugs, running-instance issues, UI/browser failures, and runtime behavior.

    909 GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Improve Kandev's AI harness from session learnings or explicit requests.

    909 GitHub stars~1.3k tokensUpdated today
    Auto-check passed
  • Diagram Design

    kdlbs/kandev

    Create branded architecture, IT current-state, flowchart, sequence, state machine, ER/data model, timeline, swimlane, quadrant, radar/spider, polar chart (polar/radial lollipop), loop/flywheel…

    909 GitHub starsUsed in 1 repo~8k tokens
    Auto-check passed
  • TDD

    kdlbs/kandev

    Implement changes using Test-Driven Development (Red-Green-Refactor).

    909 GitHub stars~4.2k tokensUpdated today
    Auto-check passed
  • Verify

    kdlbs/kandev

    Run a broad local verification audit only when the user explicitly requests it or PR/CI remediation requires it.

    909 GitHub stars~2.7k tokensUpdated today
    Auto-check passed

Questions about Clean Branches

What does Clean Branches do?

Delete local branches whose remote has been deleted ([gone]), including their worktrees. Clean Branches is an agent skill from kdlbs/kandev. Delete local branches whose remote has been deleted ([gone]), including their worktrees.

When should I use Clean Branches?

Clean Branches fits situations like: branch cleanup after merging PRs; tasks that involve Git worktrees.

How do I install Clean Branches in Claude Code?

Run `npx skills add kdlbs/kandev --skill clean-branches -a claude-code`. Or copy the skill folder (.agents/skills/clean-branches in kdlbs/kandev) into .claude/skills/clean-branches in your project. Claude Code loads it when a task matches its description.

How do I install Clean Branches in Codex?

Run `npx skills add kdlbs/kandev --skill clean-branches -a codex`. Or copy the skill folder (.agents/skills/clean-branches in kdlbs/kandev) into .agents/skills/clean-branches in your project. Codex loads it when a task matches its description.

Can I use Clean Branches in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add kdlbs/kandev --skill clean-branches -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/clean-branches, .gemini/skills/clean-branches, .github/skills/clean-branches and .opencode/skills/clean-branches in your project.

What does Clean Branches need to run?

Going by SKILL.md and its folder, Clean Branches needs the command-line tools its instructions call (git).

Does Clean Branches access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Clean Branches safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Clean Branches use?

Clean Branches is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Clean Branches use?

About 328 tokens (SKILL.md is roughly 1.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Clean Branches?

Skills that share tags, products or a category with Clean Branches: Kanvibe Release Deploy (rookedsysc/kanvibe, 143 stars), Orca CLI (aiskillstore/marketplace, 430 stars), Finishing a Development Branch (obra/superpowers, 297k stars) and Migrate Core Code to Submodules (tinyhumansai/openhuman, 42k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Clean Branches?

kdlbs (a GitHub organization) maintains it in kdlbs/kandev, which has 909 GitHub stars. The repository holds 45 skills in this directory. The repository was last updated on October 9, 2026.

Source: kdlbs/kandev on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.