finishing-a-development-branch

Verify passing tests and present merge, PR, keep, or discard options for Git branches.

Updated May 4, 2026
One-click install
npx skills add https://github.com/xaionaro/.config-codex --skill finishing-a-development-branch-xaionaro
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: finishing-a-development-branch
Source: https://github.com/xaionaro/.config-codex/tree/main/skills/finishing-a-development-branch
Command: npx skills add https://github.com/xaionaro/.config-codex --skill finishing-a-development-branch-xaionaro

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Guides the finalization of development work by presenting structured merge/PR/cleanup options once implementation is complete and tests pass.

Core Features & Use Cases

  • Verifies that tests pass before proposing completion paths.
  • Determines a sensible base branch to merge into.
  • Presents four explicit options: merge locally, push and create PR, keep the branch, or discard.
  • Cleans up worktree and feature branch after completing actions.

Quick Start

After tests pass, select one of the four options to finalize the work and tidy up.

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 safely merge a git feature branch after tests pass?

To safely merge a git feature branch after tests pass, you verify test execution, determine the correct base branch, and choose between a local merge, creating a pull request, keeping, or discarding the branch.

What is the best way to finalize a development branch in a Git workflow?

Finalizing a development branch in a Git workflow involves presenting explicit deterministic options like local merge or pull request creation, ensuring tests pass, selecting the base branch, and cleaning up the workspace afterward.

How do I clean up a worktree after merging a feature branch?

You clean up a worktree after merging a feature branch by selecting a completion option that triggers workspace cleanup, automatically tidying up the worktree and the feature branch once the merge or PR action is finalized.

Can I create a pull request instead of a local merge for my git branch?

Yes, you can create a pull request instead of a local merge for your git branch. When finalizing development work, you are presented with explicit options that include pushing the branch and creating a PR.

What should I do if I want to keep my git branch instead of merging it?

If you want to keep your git branch instead of merging it, you can select the explicit keep option provided during the branch finalization process, which preserves the branch without executing a merge or workspace cleanup.

Does branch finalization require tests to pass before proposing a merge?

Yes, branch finalization requires tests to pass before proposing a merge. The workflow verifies that tests pass successfully before presenting deterministic merge, pull request, keep, or discard options.