Content
93%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.
A lean, invariant-dense reference that documents the findings-to-issues mapping with exact markers, labels, key formats, and lifecycle semantics, and correctly delegates operations to the fragility-common scripts. Workflow clarity stops just short of the top anchor only because the mapping-change path lacks an explicit step sequence.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line states an invariant or rule ("The scripts rewrite only the marked sections, so people can edit the rest of the body", "It is never re-filed") with no padding and no explanation of concepts Claude already knows, such as what GitHub issues are. This matches anchor 5 (lean, assumes competence, every token earns its place) rather than anchor 4's "minor instances of over-explanation". | 5 / 5 |
Actionability | The guidance is fully concrete for an instruction-only skill: exact markers ("<!-- fragility-plan:start ... -->", "<!-- fragility-finding {json} -->"), the exact label, three accepted key formats ("#<n>", bare number, issue URL), precise close-state reasons ("closed as not planned or duplicate"), and the named commands to use (findings-doctor, findings-match, findings-upsert). Specific rules cover all the common lifecycle cases, matching anchor 5; there are no missing key details that would drop it to anchor 4. | 5 / 5 |
Workflow Clarity | The lifecycle semantics are coherent (sighting to comment with cooldown, new plan replaces the marked section, fixed closes as completed with a recurrence issue, declined is never re-filed) and validation tooling is named via findings-doctor and the auth/access prerequisites. However, for the description's second trigger, "changing that mapping", there is no explicit step sequence or checkpoint, which fits anchor 4 (clear with minor validation gaps) rather than anchor 5's explicit feedback loops. | 4 / 5 |
Progressive Disclosure | The body is under 50 lines, self-contained, and well organized into settings and a per-state mapping section, with the one cross-skill reference (factory-run) clearly signaled by name. The bundle's scripts/ (github.ts, tracker.ts) are implementation loaded by fragility-common's machinery rather than documentation to disclose, so inlining or referencing them would add tokens without value; this matches the simple-skill case for anchor 5. | 5 / 5 |
Total | 19 / 20 Passed |