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.
An exemplary instruction skill: a sequenced multi-pass review workflow with real validation and feedback loops, concrete templates and checklists for every pass, and disciplined one-level-deep cross-references. The only weakness is mild verbosity in the lane/evidence and untrack passages, which restate rules the surrounding checklists already enforce.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body assumes competence throughout (no space is spent explaining what refactoring or invariants are) and uses dense, checklist-style txt blocks, but a few passages restate the same rule multiple ways — e.g., "The lane never widens silently... The evidence bar never drops" followed by the separate "Authorship is not the gate" paragraph, and the extended `untrack` discussion in Ownership And Collapse Check. These are trimmable over-explanations, matching anchor 4 rather than anchor 5's every-token-earns-its-place bar. | 4 / 5 |
Actionability | For an instruction-only skill the guidance is fully actionable: literal templates to copy (Files-read ASCII tree, the Output Shape block with severity/file:line findings format), an exact smell checklist, a sample invariant-to-owner table, explicit one-caller guilt criteria, and a concrete prop/untrack design test. This matches anchor 5's specific-examples-cover-the-common-cases standard for guidance (per the code-vs-instruction scoring note). | 5 / 5 |
Workflow Clarity | The Review Order is an explicit 10-step sequence with a validation checkpoint (step 9: run diagnostics/tests against a named baseline, with rules for attributing failures) plus a report-before-fix checkpoint (step 10), and the Output Shape section closes with a genuine feedback loop: "After edits, re-read every touched file and repeat the mental inlining, smell, invariant, and API checks. Report any new finding before fixing it." That is anchor 5 — clear sequence, explicit validation, error-recovery loop, and checklists. | 5 / 5 |
Progressive Disclosure | The skill has no bundle files of its own, so all material belongs in SKILL.md, and the body is cleanly sectioned per pass (first-read, inlining, ownership, smell, invariant, API, naming, output). Its external references are one level deep and each is well signaled with a reason to load it — e.g., "cataloged in [typescript](../typescript/SKILL.md) 'Go-to-Definition Awareness'" and "[rethink's mental-inlining reference](../rethink/references/radical-options.md#mental-inlining)" — matching anchor 5's clear-overview, well-signaled one-level-deep reference pattern. | 5 / 5 |
Total | 19 / 20 Passed |