finishing-a-development-branch

Guides completion of development branches through test verification, merge, PR, or cleanup options.

1|Updated Apr 3, 2026
One-click install
npx skills add https://github.com/Pgooone/oh-pgone-claudecode --skill finishing-a-development-branch-pgooone
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: finishing-a-development-branch
Source: https://github.com/Pgooone/oh-pgone-claudecode/tree/main/.claude/plugins/cache/superpowers-marketplace/superpowers/5.0.6/skills/finishing-a-development-branch
Command: npx skills add https://github.com/Pgooone/oh-pgone-claudecode --skill finishing-a-development-branch-pgooone

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When implementation work is done, developers often merge broken code, forget to verify tests, or leave stale branches and worktrees behind. This Skill enforces a disciplined completion workflow so every finished branch is integrated, kept, or discarded deliberately. ## Core Features & Use Cases - Test Gate Before Completion: Runs the project's test suite first and blocks any merge or PR if tests fail. - Structured Completion Options: Presents exactly four choices—merge locally, push and create a PR, keep the branch as-is, or discard the work with typed confirmation. - Worktree Cleanup: Detects and removes git worktrees after merges or discards, keeping the workspace clean. - Use Case: After finishing a feature branch in a git worktree, use this Skill to verify tests pass, create a pull request via gh pr create, and clean up the worktree in one guided flow. ## Quick Start Use the finishing-a-development-branch skill to complete my current feature branch now that all tests pass.

Frequently Asked Questions about finishing-a-development-branch

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I finish a development branch after implementation is complete?▼

First run the project's test suite to confirm everything passes, then choose one of four options: merge locally into the base branch, push and create a pull request, keep the branch as-is, or discard the work. The Skill blocks completion if tests fail.

How to create a pull request from a feature branch with gh CLI?▼

Push the branch with git push -u origin <branch>, then run gh pr create with a title and body containing a summary of changes and a test plan checklist. The Skill generates this PR structure automatically when you choose the PR option.

Can I merge a branch if some tests are failing?▼

No. The Skill stops immediately when tests fail and reports the failures, refusing to proceed with any merge or PR until the test suite passes. This prevents broken code from reaching the base branch.

When should I clean up a git worktree after finishing a branch?▼

Clean up the worktree only after merging locally or discarding the branch. If you created a pull request or chose to keep the branch, the worktree is preserved so the work remains accessible for review or later changes.

How do I safely discard a development branch without losing work accidentally?▼

The Skill requires explicit typed confirmation of the word 'discard' before deleting anything, and first shows exactly what will be removed: the branch name, all its commits, and the worktree path. This prevents accidental deletion of unmerged work.