Content
52%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 well-structured, methodologically coherent planning skill whose numbered steps and per-step completion criteria give it a clear spine. Its main weakness is that it never descends from abstraction: no worked example, template, or concrete instantiation of an evidence path or verification affordance, leaving a reader to translate philosophy into practice unaided.
Suggestions
Add a short worked example — one claim, its failure modes, the chosen evidence path, and a small resulting verification affordance — so the abstract directives have a concrete instantiation (actionability).
Fold 'Set a verification budget' into the numbered sequence or renumber the steps so the 1-6 flow is not interrupted by an unnumbered section (workflow_clarity).
Tighten ornate passages such as 'The purpose is not to select a familiar technique...' and the two-paragraph affordance introduction to reduce token cost (conciseness).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly disciplined — every section carries guidance and there is no primer on concepts Claude already knows — but passages like "The purpose is not to select a familiar technique. The purpose is to decide how this system can reveal the truth of this particular change" and the two-paragraph introduction of the affordance concept are ornate and could be tightened. This is more than minor trimmable over-explanation (a 4) but well short of padded verbosity (a 2). | 3 / 5 |
Actionability | The guidance is procedural ("State the behavior that needs to become true", "Derive possible evidence paths from the system itself") but operates entirely at a methodological altitude with no worked example, template, command, or concrete instantiation of an evidence path or affordance in a real project. It instructs rather than merely describes (above a 1), but the specific steps a reader would execute against an actual system are missing, matching the 'high-level hints' anchor. | 2 / 5 |
Workflow Clarity | The six numbered steps are clearly sequenced and each carries an explicit "**Complete when:**" checkpoint — genuine validation gates, so this is above anchor 3 (checkpoints missing or implicit). It falls short of a 5 because there are no error-recovery/feedback loops (no 'if the evidence refutes the claim, do X') and the unnumbered "Set a verification budget" section is inserted between steps 2 and 3, disrupting the numbered flow. | 4 / 5 |
Progressive Disclosure | No bundle files exist, and the ~107-line single-file body is well organized with clear section headers and consistent 'Complete when' closure criteria — good structure with content appropriately placed. The under-50-line exception for a 5 does not apply, and some detailed guidance (affordance design criteria, the budget rules) is dense enough that it could live in reference files if the skill grew, keeping this at anchor 4 rather than 5. | 4 / 5 |
Total | 13 / 20 Passed |