finishing-a-development-branch

Automate development branch finalization with merge, pull request, or cleanup options.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

The Skill addresses the complexity of finalizing development branches by providing a structured process to merge, create pull requests, or discard the branch, ensuring code quality and maintainability.

Core Features & Use Cases

  • Test Verification: Ensures all tests pass before presenting merge options.
  • Environment Detection: Identifies the workspace state for appropriate merge options.
  • Merge and PR Options: Offers structured choices for merging to the base branch, pushing for a pull request, or keeping the branch for later.
  • Cleanup: Handles the removal of the branch and cleanup of the worktree.

Quick Start

To finish your development branch and merge it back, run: finish-branch --merge-to main

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 finalize a git development branch and merge it back to the main branch?

To finalize a development branch, you can run the command to merge it directly to your base branch. The automation verifies your test suite passes, detects your workspace environment, and then executes the merge.

What is the best way to automate pull request creation after finishing a development branch?

Automating pull request creation is handled by selecting the push option during the branch finalization workflow. The process detects your environment and provides structured choices to push your code for a pull request.

Does this branch finalization workflow check if my test suite passes before merging?

Yes, test verification is a core feature of the branch finalization workflow. It ensures all tests in your suite pass successfully before presenting any merge, pull request, or cleanup options.

Can I automatically clean up a git worktree and discard a development branch?

Yes, you can automatically clean up a git worktree and discard a development branch using the cleanup options. The workflow removes the branch and handles the worktree cleanup after checking your environment.

Do I need specific version control knowledge to use this branch finalization process?

You need basic Git operations and version control knowledge to use this branch finalization process. The automation handles the structural merge logic, but understanding basic branching concepts is required.