finishing-a-development-branch

Verify tests pass and merge, open a PR, retain, or delete a Git branch.

1|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/aberrantCode/llm_skills --skill finishing-a-development-branch-aberrantcode
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: finishing-a-development-branch
Source: https://github.com/aberrantCode/llm_skills/tree/main/codex/skills/finishing-a-development-branch
Command: npx skills add https://github.com/aberrantCode/llm_skills --skill finishing-a-development-branch-aberrantcode

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill ensures completed development work is safely integrated, reviewed, or discarded by guiding you through test verification, branch base detection, option selection, and optional cleanup.

Core Features & Use Cases

  • Test verification: Checks that all tests pass before proceeding.
  • Branch base detection: Identifies the appropriate base branch for merging.
  • Structured decision flow: Presents four clear options—merge locally, push and open a PR, keep the branch, or discard it.
  • Automated actions: Executes the chosen option with Git commands and optional worktree cleanup.

Quick Start

Ask the assistant to finish the current development branch after all tests pass.

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 finished git branch after verifying tests pass?

You can safely merge a git branch by running test commands to verify they pass, detecting the base branch, and then selecting to merge locally, push and open a PR, keep the branch, or discard it.

Do I need GitHub CLI to open a pull request from a completed feature branch?

Yes, Git and GitHub CLI access is required to execute pushes, pull request creation, and worktree cleanup when finishing a development branch through this workflow.

Can I automatically delete a git branch after a successful merge?

Yes, the skill provides an option to discard a branch, which executes Git commands to remove it and performs optional worktree cleanup after tests pass.

What is the best way to manage branch cleanup options in a Git repository?

The best way to manage branch cleanup is through a structured decision flow offering four options: merge locally, push and open a PR, retain the branch, or delete it with worktree cleanup.

How does branch base detection work when completing a development branch?

Branch base detection identifies the appropriate target branch for merging, ensuring completed development work integrates safely into the correct part of the Git repository.

Why does my branch finish workflow require passing test commands before merging?

Passing test commands is required before merging to ensure completed development work is safely integrated, reviewed, or discarded without introducing unverified code into the base branch.