# Finish Branch > Post-merge cleanup workflow. Detects PR merge, switches to main, pulls latest, runs tests, and removes worktree if exists. Use after PR is merged to clean up. Use when this capability is needed. - Skill: `tomevault-io/finish-branch-2` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/finish-branch-2` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/finish-branch-2/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Productivity - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/finish-branch-2 --- # Finish Branch Skill ## Priorities Safety > Completeness > Speed ## Goal Clean up local and worktree branches after PR merge. Verify merge status via gh pr view or git branch --merged, switch to main, pull latest, run tests, delete branch using safe delete, and remove associated worktree if present. Maintain repository hygiene without losing work. ## Constraints - Check merge detection: use gh pr view for PR numbers, git branch -r --merged for branch names - Never delete unmerged: use git branch -d (safe delete), never -D - Verify clean state: check git status before switching branches - Confirm worktree cleanup: git worktree remove only after verifying path - Stop if PR not merged or branch has unmerged commits - Warn on test failures but continue cleanup ## Workflow 1. Parse arguments: PR number, branch name, or detect from current branch 2. Verify merge status: gh pr view or git branch --merged check 3. Check uncommitted changes: git status --porcelain, warn if dirty 4. Switch to main: git checkout main 5. Pull latest: git pull origin main 6. Run tests: detect and execute appropriate test command 7. Delete branch: git branch -d [name] 8. Clean worktree: git worktree list, then git worktree remove if exists 9. Prune remotes: git remote prune origin ## Safety Checks - PR merge detection: always verify before cleanup - Safe delete only: never force delete with -D - Check before switch: confirm no uncommitted work - Worktree path confirmation: verify worktree path before removal - Stop on unmerged: halt cleanup if branch not merged to main ## Arguments $ARGUMENTS --- > Converted and distributed by [TomeVault](https://tomevault.io/claim/iamladi) — claim your Tome and manage your conversions.