finishing-a-development-branch

Verify tests and integrate a finished development branch via Git or PR commands.

Updated Oct 22, 2025
One-click install
npx skills add https://github.com/franroa/chezmoi --skill finishing-a-development-branch-franroa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: finishing-a-development-branch
Source: https://github.com/franroa/chezmoi/tree/main/dot_opencode/superpowers/skills/finishing-a-development-branch
Command: npx skills add https://github.com/franroa/chezmoi --skill finishing-a-development-branch-franroa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill streamlines the process of completing development work, ensuring all tests pass and providing clear, structured options for integrating your changes. It prevents common mistakes like merging broken code or accidentally discarding work.

Core Features & Use Cases

  • Mandatory Test Verification: Requires running the full test suite and confirming all tests pass before offering any completion options.
  • Structured Options: Presents exactly four clear choices for completing work: merge locally, create a Pull Request, keep the branch, or discard work.
  • Automated Cleanup: Handles Git branch deletion and worktree removal based on the chosen option.
  • Use Case: After you've finished implementing a feature or bug fix and all your tests are green, use this Skill to guide the final steps. For example, it will verify your tests, then ask if you want to merge to main, create a PR, or keep the branch.

Quick Start

Announce skill usage

I'm using the finishing-a-development-branch skill to complete this work.

The skill will then verify tests and present options for integration.

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 and integrate it with my main codebase?

After tests pass, this Skill verifies your test suite, then presents four concrete options: merge locally to the base branch, create a pull request, keep the branch for later, or discard the work. It handles Git commands and cleanup based on your choice.

What does the Skill check before letting me complete a development branch?

The Skill runs your full test suite and requires confirmation that all tests pass before offering any integration options. This prevents merging broken code into your base branch.

Can this Skill automatically delete my branch after I merge?

Yes. The Skill executes Git branch deletion and worktree removal automatically based on your chosen workflow option, handling cleanup without manual steps.

What integration options does this Skill present for finishing my feature branch?

The Skill offers exactly four options: merge the branch locally to the base branch, create a pull request for review, keep the branch without integrating, or discard the work entirely.

How does this Skill determine which branch to merge into?

The Skill automatically derives your base branch as part of its workflow, then presents your integration options in the context of that resolved base branch.

When should I use this Skill instead of manually running Git commands?

Use this Skill when your feature branch is complete and all tests pass. It enforces test verification first, structures your choices clearly, and automates branch cleanup—reducing mistakes in the final integration step.