What problem does it solve?
Completing development feature branches often involves risky manual steps like skipping test checks, merging broken code, or accidentally deleting work or worktrees. This Skill eliminates those risks by enforcing a structured, safe workflow for branch completion.
Core Features & Use Cases
- Test Verification Guardrail: Automatically checks that all project tests pass before allowing any branch integration actions, preventing broken code from being merged or pushed.
- Environment-Aware Workflows: Detects the current git environment (normal repository, named worktree, detached HEAD) to present only the relevant, safe options for the user's context.
- Safe Integration & Cleanup: Guides users through local merging, pull request creation, branch retention, or discard with mandatory confirmation, plus handles worktree cleanup only when safe to do so.
- Use Case: After finishing a feature implementation, use this Skill to verify tests pass, choose to merge locally or open a PR, and safely clean up the associated worktree without risking lost work.
Quick Start
Use the finishing-a-development-branch skill to complete your current feature branch work by verifying tests and selecting the appropriate merge, PR, or cleanup option.