finishing-a-development-branch

Guides completion of development branches through merge, pull request, keep, or discard options.

Updated May 22, 2026
One-click install
npx skills add https://github.com/viniciuscs84/sdd-toolkit --skill finishing-a-development-branch-viniciuscs84
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: finishing-a-development-branch
Source: https://github.com/viniciuscs84/sdd-toolkit/tree/main/skills/finishing-a-development-branch
Command: npx skills add https://github.com/viniciuscs84/sdd-toolkit --skill finishing-a-development-branch-viniciuscs84

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When implementation work is done, developers often merge broken code, forget to verify tests, or accidentally delete work. This Skill enforces a safe, structured completion workflow for development branches. ## Core Features & Use Cases - Test Gate Before Completion: Runs the project's test suite first and blocks any merge or PR if tests fail. - Four Structured Options: Presents exactly four choices—merge locally, push and create a PR, keep the branch as-is, or discard the work—then executes the chosen path. - Safe Cleanup: Requires typed confirmation before discarding work and cleans up git worktrees only when appropriate. - Use Case: After finishing a feature branch in a git worktree, use this Skill to verify tests pass, create a pull request with gh pr create, and remove 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 safely finish a git feature branch after implementation?

Verify the test suite passes first, then choose between merging locally into the base branch, pushing and creating a pull request, keeping the branch, or discarding it. The Skill executes the chosen option and handles worktree cleanup.

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

Push the 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.

What happens if tests fail before merging a branch?

The Skill stops immediately and reports the failing tests. It will not present merge or PR options until all tests pass, preventing broken code from being integrated.

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

Remove the worktree only after merging locally or discarding the branch. Keep it when creating a PR or keeping the branch as-is, since the work may still need review or further changes.

Can I undo discarding a development branch?

No, discarding permanently deletes the branch, its commits, and the worktree. The Skill requires typing 'discard' as explicit confirmation before executing this irreversible action.