Use when implementation is complete, all tests pass, and you need to decide how to integrate the work
Security grade of this SKILL.md: SAFE · how we grade
How to install finishing-a-development-branch
npx skills add obra/superpowers --skill finishing-a-development-branch -a claude-code
The skills CLI copies this one skill into Claude Code (use -a for another agent). Or read its SKILL.md on GitHub.
What the SKILL.md says
Core principle: Verify tests → Detect environment → Present options → Execute choice → Clean up. Announce at start: "I'm using the finishing-a-development-branch skill to complete this work." Run the project's full test suite (npm test / cargo test / pytest / go test ./...). If tests fail, report the failures and stop — the menu comes after a green suite: If tests pass: continue to Step 2. This determines which menu to show and how cleanup works: State Menu Cleanup GIT_DIR == GIT_COMMON (normal repo) Standard 3 options No worktree to clean up GIT_DIR != GIT_COMMON, named branch Standard 3 options Provenance-based (see Step 6) GIT_DIR != GIT_COMMON, detached HEAD Reduced 2 options (no merge) Externally managed — leave in place The base branch is whatever this work forked from — usually named in the plan, the conversation, or the branch's upstream.
Other skills in obra/superpowers
brainstormingYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning…
diagnosing-superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results,…
dispatching-parallel-agentsUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies
executing-plansUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, o…
receiving-code-reviewUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable…
requesting-code-reviewUse when completing tasks, implementing major features, or before merging to verify work meets requirements
subagent-driven-developmentUse when executing implementation plans with independent tasks in the current session
systematic-debuggingUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes
test-driven-developmentUse when implementing any feature or bugfix, before writing implementation code
using-git-worktreesUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated w…
using-superpowersUse when starting any conversation - establishes how to find and use skills, requiring skill invocation before ANY response including clari…
verification-before-completionUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and…
writing-plansUse when you have a spec or requirements for a multi-step task, before touching code
writing-skillsUse when creating new skills, editing existing skills, or verifying skills work before deployment