Finishing a Development Branch
obra/superpowers
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.
Agent skill
by christopherarter in christopherarter/superpowers-reasonix
Branch finished, tests green?. An agent skill from christopherarter/superpowers-reasonix.
$ npx skills add christopherarter/superpowers-reasonix --skill superpowers-finishing-a-development-branch -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install christopherarter/superpowers-reasonix superpowers-finishing-a-development-branch --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/christopherarter/superpowers-reasonix.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/superpowers-finishing-a-development-branch .claude/skills/superpowers-finishing-a-development-branch && rm -rf skills-srcUse ~/.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/
Install the "superpowers-finishing-a-development-branch" agent skill from https://github.com/christopherarter/superpowers-reasonix/tree/main/skills/superpowers-finishing-a-development-branch into .claude/skills/superpowers-finishing-a-development-branch/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "superpowers-finishing-a-development-branch", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/christopherarter/superpowers-reasonix/tree/main/skills/superpowers-finishing-a-development-branchType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add christopherarter/superpowers-reasonix --skill superpowers-finishing-a-development-branch -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install christopherarter/superpowers-reasonix superpowers-finishing-a-development-branch --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/christopherarter/superpowers-reasonix.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/superpowers-finishing-a-development-branch .agents/skills/superpowers-finishing-a-development-branch && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "superpowers-finishing-a-development-branch" agent skill from https://github.com/christopherarter/superpowers-reasonix/tree/main/skills/superpowers-finishing-a-development-branch into .agents/skills/superpowers-finishing-a-development-branch/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "superpowers-finishing-a-development-branch", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add christopherarter/superpowers-reasonix --skill superpowers-finishing-a-development-branch -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install christopherarter/superpowers-reasonix superpowers-finishing-a-development-branch --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/christopherarter/superpowers-reasonix.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/superpowers-finishing-a-development-branch .cursor/skills/superpowers-finishing-a-development-branch && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "superpowers-finishing-a-development-branch" agent skill from https://github.com/christopherarter/superpowers-reasonix/tree/main/skills/superpowers-finishing-a-development-branch into .cursor/skills/superpowers-finishing-a-development-branch/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "superpowers-finishing-a-development-branch", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/christopherarter/superpowers-reasonix.git --path skills/superpowers-finishing-a-development-branch--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add christopherarter/superpowers-reasonix --skill superpowers-finishing-a-development-branch -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install christopherarter/superpowers-reasonix superpowers-finishing-a-development-branch --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/christopherarter/superpowers-reasonix.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/superpowers-finishing-a-development-branch .gemini/skills/superpowers-finishing-a-development-branch && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "superpowers-finishing-a-development-branch" agent skill from https://github.com/christopherarter/superpowers-reasonix/tree/main/skills/superpowers-finishing-a-development-branch into .gemini/skills/superpowers-finishing-a-development-branch/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "superpowers-finishing-a-development-branch", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install christopherarter/superpowers-reasonix superpowers-finishing-a-development-branchInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add christopherarter/superpowers-reasonix --skill superpowers-finishing-a-development-branch -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/christopherarter/superpowers-reasonix.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/superpowers-finishing-a-development-branch .github/skills/superpowers-finishing-a-development-branch && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "superpowers-finishing-a-development-branch" agent skill from https://github.com/christopherarter/superpowers-reasonix/tree/main/skills/superpowers-finishing-a-development-branch into .github/skills/superpowers-finishing-a-development-branch/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "superpowers-finishing-a-development-branch", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add christopherarter/superpowers-reasonix --skill superpowers-finishing-a-development-branch -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install christopherarter/superpowers-reasonix superpowers-finishing-a-development-branch --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/christopherarter/superpowers-reasonix.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/superpowers-finishing-a-development-branch .opencode/skills/superpowers-finishing-a-development-branch && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "superpowers-finishing-a-development-branch" agent skill from https://github.com/christopherarter/superpowers-reasonix/tree/main/skills/superpowers-finishing-a-development-branch into .opencode/skills/superpowers-finishing-a-development-branch/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "superpowers-finishing-a-development-branch", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
superpowers-finishing-a-development-branchBranch finished, tests green?. An agent skill from christopherarter/superpowers-reasonix.
Superpowers Finishing A Development Branch is an agent skill from christopherarter/superpowers-reasonix. Branch finished, tests green? Load first to merge, PR, or clean up.
Its SKILL.md is about 1.3k 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. It works with Git. The repository describes itself as: Superpowers skill port to Reasonix coding harness. The licence is MIT.
6 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit d202ba4. It shows what the files ask for, not the result of running them.
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.
Shell commands in SKILL.md call:
gitnpmghFrom the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md. Its commands use git, npm and gh, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Superpowers Finishing A Development Branch loads about 1.3k tokens when it runs. Until then it costs about 28 tokens; SKILL.md has 463 words of instructions outside code blocks.
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.
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.
The full file from christopherarter/superpowers-reasonix at commit d202ba4, republished under its MIT licence (© christopherarter). 463 words, ~1,261 tokens.
.claude/skills/superpowers-finishing-a-development-branch/SKILL.md (or your agent's skills folder).Present clear options. Handle chosen workflow.
Core principle: Verify tests → detect environment → present options → execute choice → clean up.
Announce at start: "I'm using the superpowers-finishing-a-development-branch skill to complete this work."
Verify tests pass before options (use superpowers-verification-before-completion):
npm test / cargo test / pytest / go test ./...Tests fail: report failures. Cannot merge/PR until they pass. Stop. Tests pass: continue.
Capture all three up front, before any later step changes directory — WORKTREE_PATH must reflect where you are now, not after Step 5 has cd'd to the main repo root:
GIT_DIR=$(cd "$(git rev-parse --git-dir)" 2>/dev/null && pwd -P)
GIT_COMMON=$(cd "$(git rev-parse --git-common-dir)" 2>/dev/null && pwd -P)
WORKTREE_PATH=$(git rev-parse --show-toplevel)| State | Menu | Cleanup |
|---|---|---|
GIT_DIR == GIT_COMMON (normal repo) | Standard 4 options | No worktree to clean up |
GIT_DIR != GIT_COMMON, named branch | Standard 4 options | Provenance-based (Step 6) |
GIT_DIR != GIT_COMMON, detached HEAD | Reduced 3 options (no merge) | No cleanup (externally managed) |
git merge-base HEAD main 2>/dev/null || git merge-base HEAD master 2>/dev/nullOr ask: "Branch split from main — correct?"
Normal repo or named-branch worktree — present exactly these 4 options:
Implementation complete. What would you like to do?
1. Merge back to <base-branch> locally
2. Push and create a Pull Request
3. Keep the branch as-is (I'll handle it later)
4. Discard this work
Which option?Detached HEAD — present exactly these 3 options:
Implementation complete. You're on a detached HEAD (externally managed workspace).
1. Push as new branch and create a Pull Request
2. Keep as-is (I'll handle it later)
3. Discard this work
Which option?Don't add explanation. Keep options concise.
MAIN_ROOT=$(git -C "$(git rev-parse --git-common-dir)/.." rev-parse --show-toplevel)
cd "$MAIN_ROOT"
git checkout <base-branch>
git pull
git merge <feature-branch>
<test command> # Verify tests on merged resultAfter merge succeeds: cleanup worktree (Step 6), then git branch -d <feature-branch>.
git push -u origin <feature-branch>
gh pr create --title "<title>" --body "$(cat <<'EOF'
## Summary
<2-3 bullets of what changed>
## Test Plan
- [ ] <verification steps>
EOF
)"Do NOT clean up the worktree — needed alive for PR feedback.
Report: "Keeping branch <name>. Worktree preserved at <path>." No cleanup.
Confirm first — require typed discard:
This will permanently delete:
- Branch <name>
- All commits: <commit-list>
- Worktree at <path>
Type 'discard' to confirm.Confirmed: cd to main repo root, cleanup worktree (Step 6), then git branch -D <feature-branch>.
Runs for Options 1 and 4 only. Options 2 and 3 preserve worktree.
Reuse the GIT_DIR, GIT_COMMON, and WORKTREE_PATH captured in Step 2 — do NOT recompute them here. Step 5 (Options 1 and 4) has already cd'd to the main repo root, so a fresh git rev-parse --show-toplevel would return the main repo, not the worktree, and remove the wrong path. Removal must run from outside the worktree.
If GIT_DIR == GIT_COMMON: normal repo, nothing to clean up.
If WORKTREE_PATH under .worktrees/, worktrees/, or ~/.config/reasonix/worktrees/: we created it — we own cleanup:
git worktree remove "$WORKTREE_PATH"
git worktree pruneOtherwise: harness owns workspace. Do NOT remove it. Workspace-exit tool available? Use it. Else leave in place.
| Option | Merge | Push | Keep Worktree | Cleanup Branch |
|---|---|---|---|---|
| 1. Merge locally | yes | - | - | yes |
| 2. Create PR | - | yes | yes | - |
| 3. Keep as-is | - | - | yes | - |
| 4. Discard | - | - | - | yes (force) |
Never: proceed on failing tests; merge without verifying tests on result; delete work without typed confirmation; force-push without explicit request; remove worktree before merge confirmed; clean up worktrees you didn't create; git worktree remove from inside the worktree.
Always: verify tests before options; detect environment before menu; present exactly 4 options (3 detached HEAD); typed confirmation for Option 4; clean up worktree for Options 1 & 4 only; cd to main repo root before removal; git worktree prune after.
© christopherarter, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Just SKILL.md in skills/superpowers-finishing-a-development-branch of christopherarter/superpowers-reasonix.
Open the folder on GitHubat commit d202ba4
Superpowers Finishing A Development Branch 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Superpowers Finishing A Development Branch this skillchristopherarter/superpowers-reasonix | 102 | — | ~1.3k | Automated safety check: Pass | MIT | |
| Finishing a Development Branchobra/superpowers | 297k | 5 repos | ~1.9k | Automated safety check: Pass | MIT | |
| Finishing A Development Branchfarm-fe/farm | 5.6k | 34 repos | ~1.8k | Automated safety check: Pass | MIT | |
| Git Worktree Cleanuplobehub/lobehub | 83k | — | ~2.8k | Automated safety check: Pass | Custom licence | |
| Pre-Release PR Triagejamiepine/voicebox | 57k | — | ~3.1k | Automated safety check: Pass | MIT | |
| Ccmanager Configkbwo/ccmanager | 1.3k | — | ~1.5k | Automated safety check: Pass | MIT |
obra/superpowers
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.
farm-fe/farm
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…
lobehub/lobehub
Audits stale Git worktrees and branches with a bundled script, classifies each one, and deletes only after you approve the exact candidates.
jamiepine/voicebox
Sorts a backlog of open pull requests into must-merge, candidate, superseded and deferred, writes a triage doc and works the merge loop before a release.
kbwo/ccmanager
Set up, review, or repair a CCManager config — .ccmanager.json at a git repository root, or the global ~/.config/ccmanager/config.json.
CapSoftware/Cap
Builds a Cap feature in an isolated Git worktree with disposable dev resources, verification, a recorded demo and a neutral pull request, started with /building.
christopherarter/superpowers-reasonix
Any bug, failing or flaky test, or surprise behavior?. An agent skill from christopherarter/superpowers-reasonix.
christopherarter/superpowers-reasonix
Writing or fixing any code?. An agent skill from christopherarter/superpowers-reasonix.
christopherarter/superpowers-reasonix
Creating, editing, or testing a Reasonix skill?. An agent skill from christopherarter/superpowers-reasonix.
christopherarter/superpowers-reasonix
Building a feature or starting from an idea?. An agent skill from christopherarter/superpowers-reasonix.
christopherarter/superpowers-reasonix
Got review feedback?. An agent skill from christopherarter/superpowers-reasonix.
christopherarter/superpowers-reasonix
Feature work needing an isolated workspace, or executing a plan?
Works with
Categories
Branch finished, tests green?. An agent skill from christopherarter/superpowers-reasonix. Superpowers Finishing A Development Branch is an agent skill from christopherarter/superpowers-reasonix. Branch finished, tests green?
Superpowers Finishing A Development Branch fits situations like: tasks that involve Git worktrees.
Run `npx skills add christopherarter/superpowers-reasonix --skill superpowers-finishing-a-development-branch -a claude-code`. Or copy the skill folder (skills/superpowers-finishing-a-development-branch in christopherarter/superpowers-reasonix) into .claude/skills/superpowers-finishing-a-development-branch in your project. Claude Code loads it when a task matches its description.
Run `npx skills add christopherarter/superpowers-reasonix --skill superpowers-finishing-a-development-branch -a codex`. Or copy the skill folder (skills/superpowers-finishing-a-development-branch in christopherarter/superpowers-reasonix) into .agents/skills/superpowers-finishing-a-development-branch in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add christopherarter/superpowers-reasonix --skill superpowers-finishing-a-development-branch -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/superpowers-finishing-a-development-branch, .gemini/skills/superpowers-finishing-a-development-branch, .github/skills/superpowers-finishing-a-development-branch and .opencode/skills/superpowers-finishing-a-development-branch in your project.
Going by SKILL.md and its folder, Superpowers Finishing A Development Branch needs the command-line tools its instructions call (git, npm and gh).
SKILL.md contains no URLs. Its commands use git, npm and gh, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
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.
Superpowers Finishing A Development Branch is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 1.3k tokens (SKILL.md is roughly 5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with Superpowers Finishing A Development Branch: Finishing a Development Branch (obra/superpowers, 297k stars), Finishing A Development Branch (farm-fe/farm, 5.6k stars), Git Worktree Cleanup (lobehub/lobehub, 83k stars) and Pre-Release PR Triage (jamiepine/voicebox, 57k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
christopherarter (a GitHub user) maintains it in christopherarter/superpowers-reasonix, which has 102 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on August 20, 2026.
Source: christopherarter/superpowers-reasonix on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.