branch-complete

Verify tests and finalize a feature branch with four options.

Updated Mar 27, 2026
One-click install
npx skills add https://github.com/heymishy/2x2-v3-28-03-20216 --skill branch-complete
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: branch-complete
Source: https://github.com/heymishy/2x2-v3-28-03-20216/tree/main/.github/skills/branch-complete
Command: npx skills add https://github.com/heymishy/2x2-v3-28-03-20216 --skill branch-complete

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Completes a development branch by running final test verification, then presents four options (merge locally, open a draft PR, keep the branch, discard), executes the chosen option, and cleans up the worktree. PRs are always opened as drafts - never mark ready for review. Use when implementation is done and /verify-completion has passed in this session.

Core Features & Use Cases

  • Executes final test verification to validate branch readiness.
  • Presents four deterministic options: merge locally, push a draft PR, keep the branch as-is, or discard the work.
  • Cleans up the worktree after the chosen action and resolves the base branch for subsequent steps.
  • Works when /verify-completion has passed in the current session, ensuring safe transitions between states.

Quick Start

Run /verify-completion to confirm tests pass, then choose an option (1-4) to complete the branch.

Frequently Asked Questions about branch-complete

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate git branch finalization and worktree cleanup?

Git branch finalization is automated by verifying tests, presenting four actionable options (merge, draft PR, keep, or discard), and cleaning up the worktree automatically. It requires passing test verification in the current session first.

Can I open a draft PR automatically when a feature branch is complete?

Draft PR creation is supported as one of the four finalization options. When tests pass, selecting the draft PR option pushes the branch and opens a draft, never marking it ready for review automatically.

What's the best way to merge a feature branch locally after tests pass?

Merging a feature branch locally is one of the four options presented after test verification passes. Selecting the merge option executes the local merge and automatically cleans up the worktree afterwards.

Do I need to run test verification before completing a git workflow?

Test verification is required before branch completion. The workflow depends on running and passing test verification in the current session to ensure the branch is ready before presenting the finalization options.

What happens if I choose to discard a feature branch during finalization?

Discarding a feature branch is one of the four options presented after tests pass. Selecting discard removes the work and cleans up the worktree, resolving the base branch for subsequent steps in the process.

How does base-branch detection work when finalizing a git branch?

Base-branch detection runs deterministically as part of the branch finalization process. It identifies the correct base branch to use for operations like merging or creating draft PRs, ensuring safe state transitions.