merge-pr

Merge feature branches into main with conflict resolution and CI-aware auto-merge.

12|2|Updated Jan 27, 2026
One-click install
npx skills add https://github.com/jikig-ai/soleur --skill merge-pr-jikig-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: merge-pr
Source: https://github.com/jikig-ai/soleur/tree/main/plugins/soleur/skills/merge-pr
Command: npx skills add https://github.com/jikig-ai/soleur --skill merge-pr-jikig-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about merge-pr

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

FAQPage Schema
How do I automate merging a feature branch into main with conflict resolution?

Automating a feature branch merge involves fetching origin/main, routing file conflicts to specific resolution strategies like CHANGELOG reconstruction, creating a PR, and queuing CI-aware auto-merge. This process validates pre-conditions and handles worktree cleanup automatically.

What is the best way to handle CHANGELOG conflicts during a git merge?

Handling CHANGELOG conflicts during a git merge requires routing file-specific conflicts to deterministic reconstruction strategies. The merge process applies dedicated conflict resolution rules for critical artifacts like the CHANGELOG and README before proceeding with CI gating.

How does CI-aware auto-merge queuing work for pull requests?

CI-aware auto-merge queuing works by pushing the feature branch, creating or detecting a PR, and polling CI checks for merge completion. If CI fails, the system reports failures and provides rollback instructions to restore the recorded starting SHA.

Can I rollback a failed git merge and clean up worktrees deterministically?

Yes, you can rollback a failed git merge and clean up worktrees deterministically. The process records the starting SHA before merging, allowing precise rollback if conflicts or CI failures occur, followed by centralized cleanup to remove worktrees and archived specs.

What are the limitations of automated conflict resolution for pull requests?

Automated conflict resolution for pull requests is limited by confidence levels; the process aborts on low confidence during Claude-assisted resolution. It is designed for single-feature branches and requires a clean working tree with archived compound artifacts before merging.

Do I need a clean working tree before automating a pull request merge?

Yes, a clean working tree is required before automating a pull request merge. Pre-condition validation verifies branch cleanliness and ensures compound artifacts are archived, guaranteeing safe merges and enabling deterministic rollback to the starting SHA if needed.