Content
88%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 content is a thorough, executable, well-sequenced workflow with strong validation for destructive merges — its main weakness is conciseness/structure, where a large inline body and tangential 'other skills' guidance could be extracted into reference files.
Suggestions
Move the signal-scoring tables (2a/2b) and the QMD-refresh block into a separate reference file and link to it from the main body, shrinking SKILL.md toward an overview.
Trim or relocate the 'Redirect Stub Handling' section, since it documents behavior for other skills rather than this skill's own procedure.
Consider condensing the per-field merge bullets in 5b into a compact table to reduce line count while preserving actionability.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is information-dense with compact tables and no padding about concepts Claude already knows, but the 'Redirect Stub Handling' section describing other skills' behavior and the inline QMD-refresh section add length tangential to this skill's core purpose. | 4 / 5 |
Actionability | Provides copy-paste-ready bash (git pre-write snapshot, QMD refresh), a concrete audit-report template, field-by-field merge instructions, a redirect-stub template, and explicit grep rewrite patterns covering the common cases. | 5 / 5 |
Workflow Clarity | A destructive/batch skill that satisfies the validation requirement: it has a numbered Step 1-6 sequence, explicit checkpoints (semantic verdict before merge, pre-write snapshot, Step 5f final grep check), and feedback loops (audit report then ask; per-pair yes/skip/review). | 5 / 5 |
Progressive Disclosure | Clear section structure (Before You Start, Modes, Steps 1-6, Tips) and well-organized tables, but the skill is a single ~310-line monolith with inline detail (signal-scoring tables, QMD refresh) that could be split into one-level-deep reference files; no own-skill bundle files exist. | 4 / 5 |
Total | 18 / 20 Passed |