skills.rest
HankLiu447
HankLiu447COMMUNITY
Explore all skills by this author →
GitHub

superspec:finish-branch

Present four branch completion options after tests pass.

3|Updated Jan 18, 2026
Search Tags:#git#workflow#verification#cleanup#merge#pull-request#finish-branch
One-click install
npx skills add https://github.com/HankLiu447/SuperSpec --skill superspec-finish-branch
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: superspec:finish-branch
Source: https://github.com/HankLiu447/SuperSpec/tree/main/skills/finish-branch
Command: npx skills add https://github.com/HankLiu447/SuperSpec --skill superspec-finish-branch

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill guides you to safely finalize a development branch by presenting structured completion options once tests pass.

Core Features & Use Cases

  • Guided finishing flow after verification to close branches with options.
  • Enforces pre-checks: all tests pass and verification succeeds before presenting options.
  • Provides exactly four completion options: merge locally, push for PR, keep the branch, or discard.
  • Handles worktree cleanup when applicable to maintain a clean repo state.

Quick Start

Use the /superspec:finish-branch skill after a successful verification to finalize your change.

Frequently Asked Questions about superspec:finish-branch

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

FAQPage Schema
How do I safely finalize a git branch after tests pass?▼

To finalize a git branch after tests pass, you can use a guided workflow that enforces verification checks and presents structured completion options like merging locally, pushing for a pull request, keeping the branch, or discarding it with proper cleanup.

What are the options for finishing a development branch when verification is complete?▼

When verification is complete, finishing a development branch offers four options: merge locally, push for a pull request, keep the branch, or discard it. It also includes optional worktree cleanup steps to maintain a clean repository state.

Do I need to pass all tests before merging or pushing a git branch?▼

Yes, passing all tests is a strict prerequisite before merging or pushing a git branch. The guided flow enforces verification-before-completion, ensuring features are fully integrated and verified before presenting any finalization options.

What's the best way to clean up git worktrees after finishing a branch?▼

The best way to clean up git worktrees after finishing a branch is to use optional worktree cleanup steps included in the branch finalization process, which safely removes worktree artifacts and maintains a clean repository state after your chosen completion option.

Related Skills

Explore More Software Engineering Skills→
chokky-educationchokky-education

finishing-a-development-branch

Verify tests and finalize development branches with merge or pull request options.

Community
Intermediate
pkuppenspkuppens
1

branch-cleanup-after-pr

Synchronize local Git branches and delete merged or obsolete ones.

Community
Intermediate
kangmominkangmomin
1

commit-pr-hd

Automate commit, branch creation, and pull request workflows on repositories.

Community
Advanced
HaemeokHaemeok

finishing-a-development-branch

Verify tests and finalize development branches with merge, PR, and cleanup options.

Official
Advanced