What problem does it solve?
This Skill removes the manual friction and risk of merging a feature branch into main by automating pre-checks, conflict resolution, PR creation, CI-aware merging, and cleanup while preserving critical artifacts like the CHANGELOG.
Core Features & Use Cases
- Pre-condition Validation: Verifies branch, working tree cleanliness, and that compound artifacts are archived before merging.
- Merge and Conflict Routing: Fetches and merges origin/main, routes conflicts to file-specific strategies (README, CHANGELOG) or Claude-assisted resolution with abort on low confidence.
- PR Lifecycle & CI-aware Merge: Pushes the branch, creates or detects a PR, queues auto-merge for CI gating, polls for merge completion, and reports failures with rollback instructions.
- Cleanup and Rollback: Runs centralized cleanup to remove worktrees and archived specs and provides deterministic rollback to the recorded starting SHA if anything goes wrong.
Quick Start
Run the merge-pr skill on the current feature branch to merge origin/main, resolve conflicts per project rules, push the branch, create or detect the PR, queue auto-merge, and run cleanup.