skills.rest
HarmAalbers
HarmAalbersCOMMUNITY
Explore all skills by this author →
GitHub

finishing-a-development-branch

Guides branch completion by verifying tests and executing merge, PR, keep, or discard options.

1|Updated Dec 11, 2025
Search Tags:#git#workflow#testing#pull request#worktree#merge#branch
One-click install
npx skills add https://github.com/HarmAalbers/claude-requirements-framework --skill finishing-a-development-branch-harmaalbers
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: finishing-a-development-branch
Source: https://github.com/HarmAalbers/claude-requirements-framework/tree/main/plugins/requirements-framework/skills/finishing-a-development-branch
Command: npx skills add https://github.com/HarmAalbers/claude-requirements-framework --skill finishing-a-development-branch-harmaalbers

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When implementation work on a feature branch is done, developers often skip verification or fumble the final integration steps. This Skill enforces a disciplined finish: it verifies tests pass, then walks you through exactly four integration options and executes your choice safely. ## Core Features & Use Cases - Test Gate Before Completion: Runs the project's test suite (pytest, npm test, cargo test, go test) and blocks any merge or PR until all tests pass. - Four Structured Options: Presents merge locally, push and create a Pull Request via gh pr create, keep the branch as-is, or discard the work with typed confirmation. - Worktree Cleanup: Automatically removes git worktrees after merging, PR creation, or discarding, keeping your workspace clean. - Use Case: After finishing all tasks in a feature branch, invoke this Skill to verify tests, run /deep-review, create a pull request with a summary and test plan, and clean up the worktree in one guided flow. ## Quick Start Ask the assistant to finish the current development branch and it will verify tests, present the four integration options, and execute your choice.

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 finish a feature branch after implementation is complete?▼

First verify all tests pass, then choose one of four options: merge locally into the base branch, push and create a pull request, keep the branch as-is, or discard the work. The skill executes the chosen option and cleans up the worktree.

How do I create a GitHub pull request from a feature branch?▼

Push the branch with git push -u origin, then run gh pr create with a title and body containing a summary and test plan. The skill requires running /deep-review first to satisfy the pr_reviewed requirement before creating the PR.

What happens if tests fail before merging a branch?▼

The skill stops immediately and reports the number of failing tests. It will not proceed to merging, PR creation, or any other option until the failures are fixed and the test suite passes.

Can I delete a feature branch and its worktree safely?▼

Yes, but deletion requires explicit typed confirmation of 'discard' after showing the branch name, commit list, and worktree path. Once confirmed, it force-deletes the branch with git branch -D and removes the worktree.

Does this work with git worktrees?▼

Yes, the skill detects whether the branch is checked out in a worktree using git worktree list and removes it after merging, PR creation, or discarding. It pairs with the using-git-worktrees skill that created the worktree.

Related Skills

Explore More Software Engineering Skills→
SeanChenRSeanChenR

subagent-driven-development

Dispatch fresh subagents per task with isolated context and two-stage reviews.

Community
Advanced
az9713az9713
2

land-and-deploy

Merge pull requests, deploy code, and verify production health.

Community
Advanced
withmartian-sandbox-darksidewithmartian-sandbox-darkside

finishing-a-development-branch

Verify tests and execute merge, pull request, keep, or discard actions on Git feature branches.

Official
Intermediate
wahidyankfwahidyankf
3

repo-practicing-trunk-based-development

Enforce small, frequent commits to the main branch for Trunk Based Development workflows.

Community
Advanced