merge-reconciler

Resolves git merge conflicts between two agent branches as a neutral third party.

Updated Jul 3, 2026
One-click install
npx skills add https://github.com/CHENHUI-X/toolbox --skill merge-reconciler-chenhui-x
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: merge-reconciler
Source: https://github.com/CHENHUI-X/toolbox/tree/main/custom-skills/autonomous-ai-agents/merge-reconciler
Command: npx skills add https://github.com/CHENHUI-X/toolbox --skill merge-reconciler-chenhui-x

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When two AI agents working in parallel produce conflicting git branches, neither agent can fairly resolve the conflict — each lacks the peer's context and is biased toward its own changes. This Skill provides an impartial reconciliation procedure that merges both sides' work based on their stated intents. ## Core Features & Use Cases - Hunk Classification: Categorizes every conflicted hunk as disjoint-intent, same-question-different-answer, or superseded, then applies the matching resolution strategy. - Impartiality Contract: Enforces rules against self-favoring, drive-by edits, and splitting the difference on design decisions, with escalation when intents genuinely tie. - Kanban Integration: Supports spawning a neutral third-profile reconciler agent via kanban cards that carry both sides' completion summaries as parent links. - Use Case: During a parallel multi-agent refactor, two agents' branches collide on the same module. Spawn a reconciler agent with both branch names and intent summaries; it classifies each hunk, merges disjoint changes, picks one answer per design collision, verifies with the build, and hands back a summary listing every decision. ## Quick Start Ask the agent to reconcile the halted merge in this repository between branch-a and branch-b using both sides' kanban completion summaries, following the merge-reconciler procedure.

Frequently Asked Questions about merge-reconciler

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

FAQPage Schema
How do I resolve git merge conflicts between two AI agent branches?

Gather both sides' diffs and stated intents, classify each conflicted hunk as disjoint-intent, same-question-different-answer, or superseded, then resolve per class. Combine disjoint changes, pick one answer for design collisions, and keep the surviving side for superseded hunks.

How to spawn a neutral agent for merge conflict resolution?

Create a kanban reconciliation card assigned to a third profile with both conflicted cards linked as parents, so the reconciler receives both completion summaries automatically. Alternatively, use delegate_task with the repo path, both branch names, and both intent summaries verbatim.

When should I not use a merge reconciler for conflicts?

Do not use it for conflicts within a single agent's own work or for trivial lockfile and generated-file conflicts, which should simply be regenerated. It is designed only for collisions between two distinct agents' branches.

What if both sides' intents are missing during conflict resolution?

Commit messages alone can be too thin to judge intent. Prefer kanban completion summaries or PR bodies; if neither side's intent is recoverable, escalate by blocking the card or reporting back instead of guessing.

Why do repeated conflicts on the same file keep happening?

Repeated conflicts on the same file across rounds signal a hotspot, not routine reconciliation work. Flag it with a kanban comment so the orchestrator decomposes that file rather than serially reconciling every new collision.