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-only skill body: lean token use, a verification-gated evidence workflow, and a well-signaled one-level reference routing table whose targets all exist. The single improvement space is providing a short example of an emitted finding in the required output format.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The 46-line body is dense, directive prose with no explanations of concepts Claude already knows; even the ownership sentence ("its references route to canonical rules without activating another skill's implementation workflow") does real boundary work. Every token earns its place, matching the lean anchor. | 5 / 5 |
Actionability | Concrete executable directives throughout: exact scope rules ("establish its actual base and head; do not assume the tracking branch"), a change-type-to-file routing table, a four-level severity ladder with criteria, and explicit output requirements ("a tight file and line reference, the triggering scenario or applicable project rule, and a concrete fix direction"). It sits at 4 rather than 5 only because no worked example of a formatted finding is given. | 4 / 5 |
Workflow Clarity | "Evidence First" gives a clear 4-step sequence whose step 4 is explicit verification ("Verify candidates against actual defaults, guards, reachable states, and documented exceptions"), with an error-recovery discipline for the unverified case ("State material verification gaps separately; lack of verification is not itself a defect"). Read-only review work, so the destructive/batch cap does not apply. | 5 / 5 |
Progressive Disclosure | The body is a concise overview that routes to seven real reference files (all verified to exist in references/) via a change-type-to-file table, with one-level-deep links clearly signaled both inline and in a link-definition block. References point outward to project docs rather than nesting further skill content, so navigation is easy and complete. | 5 / 5 |
Total | 19 / 20 Passed |