finishing-a-development-branch

Validate tests and offer merge, PR, keep, or discard options for a development branch.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/lightxue/dotfiles --skill finishing-a-development-branch-lightxue
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: finishing-a-development-branch
Source: https://github.com/lightxue/dotfiles/tree/main/agent/skills/finishing-a-development-branch
Command: npx skills add https://github.com/lightxue/dotfiles --skill finishing-a-development-branch-lightxue

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Use when implementation is complete, all tests pass, and you need to decide how to integrate the work - guides completion of development work by presenting structured options for merge, PR, or cleanup.

Core Features & Use Cases

  • Verify tests pass before offering options to integrate or discard.
  • Determine the base branch to target for merge or PR.
  • Present exactly four options: merge locally, push and create PR, keep the branch as-is, or discard.
  • Execute the chosen action and perform necessary cleanup of worktrees.

Quick Start

Decide how to finish a development branch after tests pass by selecting one of the four options: merge locally, push and create a PR, keep as-is, or discard.

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 automate merging a development branch after tests pass?

Automating a development branch merge involves validating tests, detecting the base branch, and presenting structured options like local merge or PR creation. This workflow ensures deterministic branch completion and clean integration paths before executing the chosen action.

What's the best way to finalize a git workflow with multiple merge options?

Finalizing a git workflow requires presenting structured options after test verification. You can choose to merge locally, push and create a pull request, keep the branch as-is, or discard it entirely, ensuring a clean integration path tailored to your development needs.

How do I clean up git worktrees after completing a development branch?

Cleaning up git worktrees happens automatically after you select a branch completion action. Once you choose to merge, create a PR, or discard the branch, the workflow executes the chosen action and performs necessary cleanup of worktrees to maintain a tidy environment.

When do I need to create a pull request instead of merging locally?

Creating a pull request is ideal when you need code review or remote integration, whereas merging locally suits direct, immediate integration into the base branch. The workflow determines the target base branch and presents both options after tests pass.

Can I keep my development branch as-is instead of merging it?

Yes, you can keep your development branch as-is. When finalizing your work, the workflow presents exactly four options, including keeping the branch unchanged, allowing you to pause integration without discarding your progress or forcing a merge.

Why should I verify tests before integrating a development branch?

Verifying tests before integrating a development branch ensures that only passing code is merged or pushed. The workflow checks test status first, preventing broken code from reaching the base branch and maintaining deterministic branch completion.