superpower-finish

Automate Git merge, PR creation, cleanup decisions after passing tests.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/fernandoxavier02/Codex-superpower --skill superpower-finish
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: superpower-finish
Source: https://github.com/fernandoxavier02/Codex-superpower/tree/main/skills/finishing-a-development-branch
Command: npx skills add https://github.com/fernandoxavier02/Codex-superpower --skill superpower-finish

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Guides the finalization of development work by presenting structured options for merge, PR creation, or cleanup after all tests pass.

Core Features & Use Cases

  • Present exactly four finish options:
    1. Merge back to the base branch locally
    2. Push the feature branch and create a Pull Request
    3. Keep the branch as-is for later handling
    4. Discard this work
  • Performs environment checks (Git state, worktrees) and detects the appropriate base branch.
  • Coordinates cleanup steps to tidy up worktrees when a choice requires it.

Quick Start

Activate the skill after tests pass to present four finish options and guide the merge decision.

Frequently Asked Questions about superpower-finish

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

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

To finalize a git branch after tests pass, you can choose between merging locally, pushing to create a pull request, keeping the branch, or discarding the work. The skill automates environment checks and base-branch detection to guide this decision.

What is the best way to merge a feature branch back to its base branch?

The best way to merge a feature branch is to use a guided workflow that detects the appropriate base branch and presents structured options. This ensures a clean local merge while coordinating necessary worktree cleanup steps.

How do I create a pull request after my branch tests pass?

To create a pull request after branch tests pass, select the push-to-PR finish option. The workflow automates pushing the feature branch and initiating the PR creation process for integration.

Can I discard git branch work and clean up the worktree automatically?

Yes, you can discard git branch work and the system will coordinate cleanup steps to tidy up worktrees. This option is explicitly presented when you are ready to abandon the current development branch.

Does this branch management workflow handle keeping a branch for later?

Yes, the branch management workflow includes an option to keep the branch as-is for later handling. This allows you to pause integration without merging or discarding your current git worktree state.

What git states are checked before presenting branch finish options?

Before presenting branch finish options, the workflow checks the git state and worktree environment. These checks ensure the feature branch is ready for integration and that the base branch is correctly detected.