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, opinionated, sequenced, and built around an explicit evidence ladder with validation baked into the output format. The single gap is the absence of a worked example — a sample proof script or a rendered hand-back — that would make the guidance fully concrete.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~44-line body is lean and assumes competence throughout: "Listing the callers is not the job. The agent can grep those in a second" and "Work out when things run: microtasks, unmount and teardown, Solid versus React" pack craft-specific guidance with zero padding. It never explains concepts Claude already knows, so it matches anchor 5 ("every token earns its place"); the deliberate repetition of "the one fact it's safe because of" is a structural through-line, not over-explanation, so it does not drop to 4. | 5 / 5 |
Actionability | As an instruction-only skill it gives concrete, executable direction: the 5-level evidence ladder ("You ran it. A script or test that calls the real code and fails loud if you're wrong"), "check its pinned version and any local patch", and "Write a script or test that runs the real code, run it, and paste what happened". It scores 4 rather than 5 because a worked example is absent — there is no sample proof script or example of the pasted output and what a hand-back actually looks like, which anchor 5 ("specific examples cover the common cases") would require; it is well above anchor 3 because the guidance is real steps, not pseudocode or high-level hints. | 4 / 5 |
Workflow Clarity | Six clearly sequenced steps with an explicit verification protocol woven in: the evidence ladder requires the agent to "say where it stopped", step 5 says to run the proof and "paste what happened", and the hand-back checklist demands "show the proof. If you couldn't prove it, write unproven" — a real error-recovery fallback. This matches anchor 5 (clear sequence, explicit validation, checklist); the destructive/batch cap does not apply since this is a read/verify workflow. | 5 / 5 |
Progressive Disclosure | The body is under 50 lines with no bundle files (no references/, scripts/, or assets/ exist) and no content that needs offloading — well-organized sections (Steps, How sure are you, What to hand back) with clear headers. Per the rubric's simple-skill guidance this earns a 5; references to sibling skills like `why`, `how`, `unslop`, and `arena` are cross-skill pointers, not buried file references, and there is no nested-reference structure to penalize. | 5 / 5 |
Total | 19 / 20 Passed |