CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

git-conflict-resolver

Resolve git conflicts (rebase, merge, cherry-pick, revert) using mergiraf, deterministic category handling, explicit intent inference, validation, and semantic-conflict auditing. Use when git status shows unmerged paths or an operation is paused with conflicts. Also decomposes an oversized PR or branch into smaller stacked PRs along functional/structural boundaries.

Quality

91%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

88%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is a highly actionable, well-sequenced procedure with executable commands, explicit validation, bounded retry loops, and careful HALT semantics. Its weaknesses are moderate template verbosity and one broken reference (constitution.md) plus several reference files that SKILL.md never links, which slightly undermines navigation.

Suggestions

Fix the broken reference: either add the missing constitution.md file or point the Constitutional Rules section at the existing inline rules (or a real reference file) instead of a non-existent path.

Link the orphaned references (history-mining.md, intent-inference.md, mergiraf-integration.md, semantic-conflicts.md) from the relevant procedure steps so they are discoverable, or fold their key content into the corresponding steps.

Move the full Markdown templates for the Step 6 summary, per-file decision record, and HALT schema into a reference file, keeping only field lists or a compact example inline to reduce token cost.

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence (never explains what a rebase or lockfile is), but the full Markdown templates for the Step 6 summary, per-file decision record, and HALT schema, plus advisory asides like 'These are configurable heuristics, not empirical laws', could be tightened or pushed to a reference. This matches 'efficient; minor instances of over-explanation that could be trimmed' rather than level 5's every-token-earns-its-place.

4 / 5

Actionability

Every step ships an exact executable command with flags ('timeout 30 mergiraf solve -- <file> --compact --keep-backup=false', script invocations with --json/--top/--k), exit-code semantics (124 for timeout, 5 for the reprompt artifact), and complete lockfile-to-regeneration-command and context-to-continue-command tables. Fully copy-paste ready.

5 / 5

Workflow Clarity

Steps 1–6 are clearly sequenced with explicit validation checkpoints (validate-and-reprompt.sh with a bounded retry budget, semantic-audit.sh where 'Any SUSPECT output requires review'), a feedback loop ('Loop to Step 1 if more conflicts appear'), HALT handling for un-inferable intent, and abort criteria. Matches the level-5 anchor including error-recovery loops.

5 / 5

Progressive Disclosure

Good structure overall: the body is an actionable overview, references are one level deep and clearly signaled ('read ... only when needed', 'Full guidance: references/pr-decomposition.md'), and detailed material is split into references/ and scripts/. However, the body instructs 'Read ${CLAUDE_SKILL_DIR}/constitution.md' but no constitution.md exists in the bundle, and four of the eight reference files (history-mining.md, intent-inference.md, mergiraf-integration.md, semantic-conflicts.md) are not navigable from SKILL.md. This lands at level 4 (minor organization gaps) rather than 5 due to the broken/missing navigation targets.

4 / 5

Total

18

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is strong: it names concrete capabilities across two modes, states an explicit and concrete 'Use when' trigger, and stays in third-person imperative voice without fluff. Trigger coverage is good but omits a couple of natural user phrasings that only appear in the separate when_to_use field.

Suggestions

Fold one or two common user phrasings (e.g., 'merge conflict', 'resolve conflicts') directly into the description so the description field is self-sufficient for triggering.

Mention that the split mode applies to oversized branches as well as PRs in a single clause to avoid the appended-feeling last sentence.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'Resolve git conflicts (rebase, merge, cherry-pick, revert) using mergiraf, deterministic category handling, explicit intent inference, validation, and semantic-conflict auditing' plus 'decomposes an oversized PR or branch into smaller stacked PRs' — with comprehensive coverage across both modes. It matches the level-5 anchor (multiple specific concrete actions, comprehensive), not level 4, because there are no notable gaps in capability coverage.

5 / 5

Completeness

Both questions are answered explicitly: what — 'Resolve git conflicts... using mergiraf, deterministic category handling, explicit intent inference, validation, and semantic-conflict auditing'; when — 'Use when git status shows unmerged paths or an operation is paused with conflicts.' This matches the level-5 anchor with a concrete when clause, not level 4 where the when is only present but less specific.

5 / 5

Trigger Term Quality

Good natural-term coverage: 'git conflicts', 'rebase', 'merge', 'cherry-pick', 'revert', 'unmerged paths', 'stacked PRs'. A few phrases users would naturally say are absent from the description itself, such as 'merge conflict', 'resolve conflicts', and 'conflict markers' (these appear in the when_to_use field, not the description), so it sits between the level-4 and level-5 anchors, closer to 4.

4 / 5

Distinctiveness Conflict Risk

Clear niche (git conflict resolution plus oversized-PR decomposition) with distinct triggers ('unmerged paths', 'stacked PRs') and minimal overlap with adjacent skills; it explicitly bounds itself away from general PR review. Matches the level-5 anchor rather than 4 because the trigger surface is narrowly scoped.

5 / 5

Total

19

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository

Raudbjorn/conflict-of-interest

Path

SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.