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 exemplary routing-style skill body: lean, correctly scoped to a topic map, with verified one-level-deep references whose scope lines make file selection straightforward. The residual gap is that the classification directive in the body names its five inputs but defers all decision logic to the references without sequencing how they combine.
Suggestions
Add a compact inline decision sketch (2-4 lines or a short list) showing how the five identification factors — memory initiator, transport, required privilege, isolation boundary, artifacts — resolve into a DMA vs. host-mediated classification, so the body's directive is actionable without loading a reference first.
In the routing list, indicate priority or default order (e.g. start with classification-and-threat-model.md for unknown techniques) so a reader facing a query that matches several bullets knows where to begin.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~20-line body is pure routing: one classification directive ('Identify the memory initiator, transport, required privilege, isolation boundary, and observable artifacts before classifying a technique as DMA') plus per-file pointers, each with a one-line scope. Nothing explains concepts Claude already knows; every token earns its place, matching anchor 5. | 5 / 5 |
Actionability | Guidance is concrete and specific: each routing bullet names the exact subtopics a file covers ('for TLPs, configuration space, programmable endpoints, and emulation limits', 'for separating ACPI advertisement, Windows policy, live unit state, and per-requester coverage'), and all cited files exist with substantive content. It stays below anchor 5 because the central directive names five factors to identify but leaves how they combine into a DMA classification entirely to the references — no decision points or worked example in the body. | 4 / 5 |
Workflow Clarity | There is an explicit ordering rule ('Identify the memory initiator... before classifying a technique as DMA') followed by unambiguous topic-to-file routing, so the navigation workflow is clear; no validation steps are needed since nothing here is destructive or batch. It falls short of anchor 5 because the analytical sequence itself — how the five identification factors resolve into a classification and which reference to consult when several paths apply — is not sequenced in the body. | 4 / 5 |
Progressive Disclosure | This is the anchor-5 pattern: a lean overview in SKILL.md with nine clearly signaled, one-level-deep references, each annotated with a scope line so navigation is trivial. All referenced paths resolve to real, substantive files, and the references only cross-link siblings (still one hop), so there is no nesting or buried content. | 5 / 5 |
Total | 18 / 20 Passed |