skills.rest
AvaTar-ArTs
AvaTar-ArTsCOMMUNITY
Explore all skills by this author →
GitHub

finishing-a-development-branch

Guides completion of development branches through verified merge, pull request, or cleanup options.

Updated Jul 10, 2026
Search Tags:#git#pull request#worktree#branch management#merge#test verification#github cli
One-click install
npx skills add https://github.com/AvaTar-ArTs/.Agent-skills --skill finishing-a-development-branch-avatar-arts
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: finishing-a-development-branch
Source: https://github.com/AvaTar-ArTs/.Agent-skills/tree/main/skills/finishing-a-development-branch
Command: npx skills add https://github.com/AvaTar-ArTs/.Agent-skills --skill finishing-a-development-branch-avatar-arts

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When implementation work is done, developers often merge broken code, forget to run tests, or leave stale branches and worktrees behind. This Skill enforces a disciplined finish: verify tests first, then choose exactly one of four structured completion paths. ## Core Features & Use Cases - Test Gate Before Completion: Runs the project's test suite (npm test, cargo test, pytest, go test) and blocks any merge or PR until all tests pass. - Four Structured Options: Presents exactly four choices — merge locally, push and create a PR via gh, keep the branch as-is, or discard with typed confirmation. - Worktree Cleanup: Detects and removes git worktrees for merged or discarded branches while preserving them for PR and keep-as-is flows. - Use Case: After finishing a feature branch in a git worktree, invoke this Skill to verify tests pass, create a pull request with a summary and test plan, and clean up the worktree automatically. ## Quick Start Use the finishing-a-development-branch skill to complete my current feature branch now that 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 finish a git feature branch after implementation?▼

Run the project test suite first, 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 it. The Skill blocks completion if any tests fail.

How to 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 of changes and a test plan checklist. The Skill generates this PR body structure automatically.

When should I clean up a git worktree after merging?▼

Remove the worktree only after merging locally or discarding the branch. Keep the worktree when creating a pull request or keeping the branch as-is, since the work may still need follow-up changes.

What happens if tests fail before merging a branch?▼

The process stops immediately and reports the failing tests. No merge, pull request, or cleanup options are presented until all tests pass, preventing broken code from reaching the base branch.

Can I undo discarding a development branch?▼

No, discarding permanently deletes the branch, its commits, and the worktree. The Skill requires typing 'discard' as explicit confirmation before executing git branch -D to prevent accidental deletion.

Related Skills

Explore More Software Engineering Skills→
chuangkevinchuangkevin

using-git-worktrees

Create isolated git worktrees for feature branches with automated setup and test verification.

Community
Advanced
intrusive-memoryintrusive-memory

release

Merge pull requests, create annotated Git tags, and generate GitHub releases.

Official
Advanced
trystan2ktrystan2k
1

agent-ci

Runs GitHub Actions CI pipelines locally to validate code before pushing.

Community
Intermediate
ravenoakravenoak

github-flow

Enforce GitHub Flow with feature branches, atomic commits, and CI-gated PR merges.

Community
Intermediate