Content
86%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.
An exceptionally lean and actionable prose standard whose rules each carry concrete micro-examples and a full worked example. Its weaknesses are structural: the sole external reference (TEMPLATES.md) points to a missing file, and the write-then-review workflow has an explicit final checklist but no stated fix-and-recheck loop.
Suggestions
Ship the referenced TEMPLATES.md (ADR, changelog entry, known issue, Mermaid) in the bundle or remove the reference — currently the link is broken and the templates promised in both the description and body are unavailable.
State the full workflow order explicitly as steps (apply layers 1-4, run unslop, review with the checklist, fix and re-check) so the validation loop is a sequence rather than implied.
Guard the unslop dependency: if the unslop skill may not be present, add a one-line fallback for the word-level cuts it currently delegates.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with rules and free of padding: no explaining what Diataxis or style guides are beyond one operational line each ("Tutorial. You are the teacher and the learner's success is your job"). Every line is an instruction, a micro-example ("'Remove backup file' reads two ways"), or the single worked example — nothing explains concepts Claude already knows. Fits 'lean and efficient; every token earns its place'. | 5 / 5 |
Actionability | For an instruction-only skill the guidance is fully concrete: each rule carries a quoted before/after micro-example ("'the proto import budget check script' becomes 'the script that checks the proto-import budget'"), plus a full worked example with Before/After text and a layer-by-layer explanation. This matches the top anchor's 'specific examples cover the common cases' for a non-code skill. | 5 / 5 |
Workflow Clarity | The process is sequenced ("Apply all four, then run the unslop skill over the result") and closes with an explicit 7-item review checklist, which is genuine validation. But it sits between anchors: there is no per-layer checkpoint and the fix-and-recheck loop is only implied (only two checklist items state a remediation, e.g., "Split it"), so it lacks the full feedback-loop structure of the top anchor. | 4 / 5 |
Progressive Disclosure | Sectioning is good (four layers, worked example, checklist, sources) and the single external reference is clearly signaled ("Templates for an ADR, a changelog entry, a known issue and a Mermaid diagram: TEMPLATES.md"), but TEMPLATES.md does not exist in the bundle — there is no references/ directory at all, so the link is broken and the advertised templates are unreachable. A dangling reference is a navigation failure beyond the 'minor organization gaps' of anchor 4, landing it at anchor 3. | 3 / 5 |
Total | 17 / 20 Passed |