resolving-merge-conflicts

Resolve in-progress git merge and rebase conflicts while preserving both change intents.

28|1|Updated Mar 15, 2026
One-click install
npx skills add https://github.com/NauelG/astro-blocks --skill resolving-merge-conflicts-nauelg
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: resolving-merge-conflicts
Source: https://github.com/NauelG/astro-blocks/tree/main/.agents/skills/resolving-merge-conflicts
Command: npx skills add https://github.com/NauelG/astro-blocks --skill resolving-merge-conflicts-nauelg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Merge and rebase conflicts interrupt development and are often resolved hastily, losing the intent of one side's changes or breaking the build. This Skill provides a disciplined workflow for understanding each conflict's origin and resolving it correctly. ## Core Features & Use Cases - Conflict Investigation: Inspect the current merge/rebase state, git history, and conflicting files before touching anything. - Intent-Preserving Resolution: Trace each change back to its commit messages, PRs, and original issues so both intents are preserved where possible, with trade-offs documented when they are incompatible. - Verification and Completion: Run the project's automated checks (typecheck, tests, format) after resolving, then stage, commit, and continue the rebase to completion. - Use Case: You run git rebase main on a long-lived feature branch and hit conflicts across five files. Use this Skill to understand why each side changed the code, resolve every hunk without inventing new behavior, verify the test suite passes, and finish the rebase cleanly. ## Quick Start Resolve the current git merge conflict in my repository, preserving the intent of both branches, then run the tests and finish the merge.

Frequently Asked Questions about resolving-merge-conflicts

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

FAQPage Schema
How do I resolve a git merge conflict?▼

Start by inspecting the merge state and conflicting files, then trace each change to its commit messages and PRs to understand intent. Resolve each hunk preserving both intents where possible, run the project's typecheck and tests, then stage and commit.

How to resolve conflicts during a git rebase?▼

During a rebase, resolve each conflicted hunk as it appears, stage the resolved files, and continue the rebase until all commits are replayed. Never abort midway; always resolve and verify with the project's automated checks.

Should I use git merge or git rebase for my branch?▼

Both are supported by this workflow. Merge preserves branch history with a merge commit, while rebase replays commits for a linear history; the conflict resolution steps are the same, but rebase requires continuing through each commit.

What should I check after resolving merge conflicts?▼

Run the project's automated checks in order: typecheck first, then tests, then formatting. Fix anything the merge broke before staging everything and committing to finish the merge or rebase.

When should I not resolve a merge conflict myself?▼

Avoid resolving when you cannot determine the original intent of either side from commits, PRs, or issues. In that case, consult the change authors rather than inventing new behavior, since guessing can silently break functionality.