Skip to main content
skill CX Codex

branch-finalization — Claude Code skill: what it does, how to install

branch-finalization verifies tests, presents four clear next steps, and handles merging, pull requests, or branch cleanup.

LicenseRef-Proprietary 131 installs ★ 50 updated 2026-01-05

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add qodex-ai/ai-agent-skills --skill branch-finalization -a claude-code
Open on GitHub

What branch-finalization does

This skill establishes a strict protocol for closing out feature branches. It starts by running project tests with npm test, pytest, cargo test, or go test. If any test fails, execution halts immediately. Merging or opening a PR on broken code is blocked.

Once tests pass, it locates the base branch and offers exactly four choices: merge locally, push and submit a PR via gh, retain the branch, or discard changes. Discarding requires typing an exact confirmation word to prevent accidental loss. Without that confirmation, nothing is deleted.

Depending on the chosen path, the skill checks for an active git worktree and removes it when merging locally or discarding the branch.

What it helps with

  • merging untested commits into the base branch
  • creating structured pull requests via gh CLI
  • cleaning up temporary git worktrees after integration
  • safely discarding abandoned feature branches with explicit confirmation

Example prompts for the agent

  • Finalize this branch and verify tests.
  • Wrap up work on the current feature branch.
  • Prepare this branch for merging into main.

How to install branch-finalization

1Skills CLI (Vercel)

npx skills add qodex-ai/ai-agent-skills --skill branch-finalization -a claude-code

2Manually: put the files in place

~/.claude/skills/branch-finalization/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/branch-finalization/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about branch-finalization

How to install branch-finalization in Claude Code?

Run npx skills add qodex-ai/ai-agent-skills --skill branch-finalization -a claude-code in your terminal.

What does branch-finalization do?

It checks test results, detects the base branch, and guides you through local merging, opening a PR, keeping changes, or discarding the branch.

What happens if tests fail?

The workflow stops right away. It displays test failures and refuses to show merge or PR options until the issues are fixed.

Similar skills

All skills for Git and GitHub →

From the same set42

The whole set →
cloud-expense-management cloud-expense-management tracks AWS expenses, calculates resource costs before deployment, and inspects CloudWatch telemetry. Useful for budget tracking and detecting billing spikes. CX Codex +1 134installs capability-activation The capability-activation skill makes an agent check for applicable skills before responding and sets an order for using them. It fits workflows that depend on explicit process rules. CX Codex +1 134installs peer-review-initiator peer-review-initiator builds a review request for your agent: commit SHAs, what changed, what it should do. Then hands it to a reviewer subagent. CX Codex +1 133installs selection-randomizer selection-randomizer is a Claude Code skill that randomly picks winners and participants from lists. It can apply weights and exclude past winners. CX Codex +1 133installs autonomous-cloud-orchestration autonomous-cloud-orchestration walks your agent through AWS Bedrock AgentCore: picking the right service and wiring the deployment with the AWS CLI. CX Codex +1 131installs capability-documentation The capability-documentation skill helps document other skills with clear structure, examples, and behavior checks. It fits reusable agent guidance that needs verification. CX Codex +1 130installs workspace-isolation workspace-isolation creates separate Git worktrees for parallel branch work. Use it when changes need their own working directories and a verified starting state. CX Codex +1 130installs deployment-automation deployment-automation — a skill that automates Vercel deployments with build error fixes. The agent runs vercel --prod, reads logs via MCP tool, and patches code until deployment succeeds. CX Codex +1 129installs

Project sponsors

Companies that keep this analytics open