skills.rest
erwinv2k-TKG
erwinv2k-TKGCOMMUNITY
Explore all skills by this author →
GitHub

finishing-a-development-branch

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

Updated Mar 26, 2026
Search Tags:#git#pull request#worktree#branch management#merge#test verification#github cli
One-click install
npx skills add https://github.com/erwinv2k-TKG/AgentesVSC --skill finishing-a-development-branch-erwinv2k-tkg
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: finishing-a-development-branch
Source: https://github.com/erwinv2k-TKG/AgentesVSC/tree/main/packs/superpowers/skills/finishing-a-development-branch
Command: npx skills add https://github.com/erwinv2k-TKG/AgentesVSC --skill finishing-a-development-branch-erwinv2k-tkg

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 no branch is merged, pushed, or discarded without verification and explicit confirmation. ## Core Features & Use Cases - Test Gate Before Completion: Runs the project's test suite (npm test, cargo test, pytest, go test) and blocks any merge or PR until all tests pass. - Structured Completion Options: Presents exactly four choices—merge locally, push and create a PR, keep the branch as-is, or discard the work—eliminating ambiguous open-ended decisions. - Safe Cleanup and Discard Protection: Cleans up git worktrees only when appropriate and requires typing 'discard' to confirm permanent deletion of branches and commits. - Use Case: After finishing a feature branch in a git worktree, use this Skill to verify tests pass, create a pull request with a summary and test plan via the GitHub CLI, and remove the worktree cleanly. ## 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 safely finish a git feature branch after development?▼

First verify the project's test suite passes, then choose between merging locally into the base branch, pushing and creating a pull request, keeping the branch, or discarding it. This Skill walks through each option with the exact git commands.

How to create a GitHub pull request from the command line?▼

Push the feature branch with git push -u origin, then run gh pr create with a title and body containing a summary and test plan. The Skill generates this PR automatically when you choose the pull request option.

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

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

When should git worktrees be removed after merging?▼

Remove the worktree only after a local merge or a confirmed discard, using git worktree remove. Keep the worktree when creating a PR or keeping the branch as-is, since the work may still be needed.

How do I permanently delete a git branch without losing work accidentally?▼

Require explicit typed confirmation before deletion. This Skill lists the branch, commits, and worktree that will be destroyed and only proceeds after you type 'discard', then runs git branch -D to force delete.

Related Skills

Explore More Software Engineering Skills→
chuangkevinchuangkevin

using-git-worktrees

Create isolated git worktrees for feature branches with automated setup and test verification.

Community
Advanced
TNHoang2708TNHoang2708
1

ck:ship

Automate GitHub release workflows from feature branches to pull requests.

Community
Advanced
JerrylalalaJerrylalala
6

git-worktree

Manages Git worktrees for isolated parallel development with automated environment setup.

Community
Intermediate
modu-aimodu-ai
4

moai-ref-git-workflow

Standardize Git workflows, branch strategies, and PR templates across projects.

Official
Advanced