Back to Skills

git-hex-conflict-resolution

verified

This skill should be used when the user is stuck in a git-hex-driven rebase, merge, or cherry-pick due to conflicts and wants the agent to inspect, resolve, and then continue or abort safely. Trigger phrases include: "resolve conflicts", "rebase is stuck", "conflict markers", "continue the rebase", "abort the rebase".

View on GitHub

Marketplace

git-hex-marketplace

yaniv-golan/git-hex

Plugin

git-hex

Repository

yaniv-golan/git-hex

skills/git-hex-conflict-resolution/SKILL.md

Last Verified

January 21, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/yaniv-golan/git-hex/blob/main/skills/git-hex-conflict-resolution/SKILL.md -a claude-code --skill git-hex-conflict-resolution

Installation paths:

Claude
.claude/skills/git-hex-conflict-resolution/
Powered by add-skill CLI

Instructions

# Git-hex Conflict Resolution

## When to use this Skill

This skill should be used when:

- A git-hex tool reports that an operation is paused because of conflicts.
- The user says a rebase or cherry-pick is "stuck", "paused", or "in conflict".
- You need to see which files conflict and decide whether to continue or abort.

Trigger phrases include: "rebase conflict", "cherry-pick conflict", "merge conflict",
"stuck on conflicts", "continue the rebase", "abort the cherry-pick".

## Workflow

1. **Inspect conflict state**
   - Call `git-hex-getConflictStatus` to determine:
     - Whether a rebase/merge/cherry-pick/revert is in progress.
     - Which files are conflicting and the overall operation type (`rebase`,
       `merge`, `cherry-pick`, or `revert`).
   - Use `includeContent: true` only when necessary to inspect base/ours/theirs
     content for specific text files.

2. **Resolve conflicts per file**
   - For text files:
     - Propose or apply edits based on `base`, `ours`, and `theirs`.
     - Ensure conflict markers are removed before resolving.
     - Call `git-hex-resolveConflict` with the file path (and `resolution: "delete"`
       for delete conflicts when appropriate).
  - For delete conflicts, use the `resolution` parameter to choose whether
     to keep or remove the file.

3. **Continue or abort the operation**
   - When all conflicts are resolved (or `getConflictStatus` shows no remaining
     conflicting files but the operation is still paused), call `git-hex-continueOperation`.
   - If the user decides to give up on the rebase or cherry-pick, call
     `git-hex-abortOperation` to restore the pre-operation state.

4. **Escalate if needed**
   - If the final result after continuing is not what the user wanted, suggest
     using `git-hex-undoLast` from the branch cleanup Skill to revert.

## Tools to prefer

- Inspection: `git-hex-getConflictStatus`
- Resolution: `git-hex-resolveConflict`
- Control: `git-hex-continueOperation`, `git-hex-abortOperat

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
2698 chars