finishing-a-development-branch

Validates tests and presents four options for merging, PR, or discarding a branch.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/MacroMan5/claude-code-workflow-plugins --skill finishing-a-development-branch-macroman5
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: finishing-a-development-branch
Source: https://github.com/MacroMan5/claude-code-workflow-plugins/tree/main/.claude/skills/finishing-a-development-branch
Command: npx skills add https://github.com/MacroMan5/claude-code-workflow-plugins --skill finishing-a-development-branch-macroman5

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires git, gh CLI.

What problem does it solve?

Integrating completed development work can be error-prone, with forgotten test runs, unclear merge strategies, or accidental work deletion. This Skill ensures a smooth, verified completion.

Core Features & Use Cases

  • Test Verification: Automatically runs your project's test suite to ensure all changes are stable before proceeding.
  • Structured Integration Options: Presents clear choices: merge locally, push and create a Pull Request, keep the branch as-is, or discard the work.
  • Use Case: When you've finished a feature branch, use this skill to verify all tests pass, then choose to merge locally, create a PR, or manage your branch with confidence, knowing cleanup is handled.

Quick Start

I've completed the feature branch 'feature/new-dashboard'. 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 verify tests pass before merging a development branch?

Test verification runs your project's test suite automatically to ensure all changes are stable before integration. This Skill executes the full test suite and detects pass/fail status, preventing untested code from merging into your base branch.

What are the merge options when finishing a development branch?

When tests pass, this Skill presents four structured integration paths: merge locally into your base branch, push and create a Pull Request via gh CLI, keep the branch as-is for later, or discard the work entirely. You select the option that fits your workflow.

How do I clean up branches and worktrees after completing development work?

After choosing your merge path, the Skill handles optional cleanup of your worktree and branch automatically. This prevents dangling branches and orphaned worktrees that clutter your git repository.

Can I use this Skill with different version control workflows?

This Skill detects your base branch automatically and works with standard git workflows. It requires git and gh CLI as dependencies, supporting common integration patterns across different project structures and team setups.

What happens if tests fail during branch completion?

If your test suite fails, the Skill halts before presenting merge options, preventing broken code from integrating. You must resolve test failures before proceeding to merge, ensuring only validated changes reach your base branch.

Do I need to manually choose a base branch for merging?

No—this Skill automatically detects your base branch as part of its integration logic. Base-branch detection eliminates manual specification, reducing the risk of merging into the wrong target branch.