Content
92%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a lean, highly actionable runbook: exact git commands for inspection, staged-file examination, resolution, and continuation, plus explicit project-specific resolution policy and a validation feedback loop. Its only flaw is a slightly redundant explanation of conflict-marker syntax that could be trimmed for token efficiency.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense, project-specific policy with no padding — e.g. the terse inspection block 'git status / git ls-files -u' and the rule 'Machine-generated / filtered state files ... keep ours'. However, 'For 3-way markers (`<<<<<<<` / `|||||||` / `=======` / `>>>>>>>`), select the intended side and delete the marker lines' restates conflict-marker syntax Claude already knows and partially duplicates the preceding sentence — a minor instance of over-explanation that could be trimmed, matching anchor 4 rather than 5. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready commands throughout: 'git ls-files -u', 'git show :1:<path>' / ':2:' / ':3:', 'git checkout --ours <path>', 'git add <path>', 'git diff --check', 'git rebase --continue', 'git cherry-pick --continue'. The per-file resolution rules ('keep the higher version; if already upstream, `--skip` the commit'; 'drop duplicates and obviously bogus rows') are concrete policy covering the common cases. Anchor 5. | 5 / 5 |
Workflow Clarity | Eight clearly numbered steps (inspect -> examine stages -> resolve -> stage -> verify -> continue -> commit -> report) with an explicit validation checkpoint and feedback loop: 'Verify no conflict markers remain: git diff --check. If any remain, fix before continuing.' Conditional branches cover each pending operation (merge/rebase/cherry-pick/revert/stash) and the clean-tree case. Anchor 5; the destructive-operation cap does not apply because validation is present. Not 4: the validate-and-fix loop is explicit, not just a bare 'verify' step. | 5 / 5 |
Progressive Disclosure | Single-file skill with no bundle files (no references/, scripts/, or assets/ exist); everything present belongs inline and is well organized under a one-line overview, a numbered 'Workflow' section, and 'Notes'. The only external pointer — '(see `git-commit` skill)' for commit conventions — is clearly signaled and one level deep. Clear overview, trivially easy navigation: anchor 5. | 5 / 5 |
Total | 19 / 20 Passed |