Content
96%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.
The body is exemplary instruction-only skill content: a memorable one-rule framing, a cost-ordered lookup ladder with explicit stop conditions and error recovery, a question-to-source map, and honest limits. Its only structural question is whether ~108 lines in a single file is the right split, since nothing is offloaded to reference files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line carries instance-specific knowledge Claude cannot have otherwise — block semantics ('It is a set of pointers, not contents'), the 20-entry expand cap, entry pruning, retention windows — with no padding and no explanation of known concepts. This is the anchor 5 case: lean, assuming competence, every token earning its place. | 5 / 5 |
Actionability | Exact tool signatures with parameters are given ('activity(action="expand", id=N)', 'get_workflow(workflowId, full=true)'), plus a worked example utterance ('picking up the stale-issue nudge workflow, which failed twice this morning') and a question-to-source table. Per the rubric's instruction-skill note, the absence of code is not penalized when guidance is this executable — not anchor 4 because there are no gaps in the common cases. | 5 / 5 |
Workflow Clarity | The read ladder is explicitly ordered ('Read in this order — cheapest first', 'Stop at the first one that answers yours') with an error-recovery loop ('An id that no longer resolves is ordinary — entries are pruned — so carry on rather than treating it as an error') and explicit boundary limits in 'Where this stops'. The skill is read-only, so the destructive/batch validation cap does not apply. | 5 / 5 |
Progressive Disclosure | Sections are well organized with no dead references (verified: no references/, scripts/, or assets/ directories exist), but the ~108-line body exceeds the under-50-line simple-skill exception and material such as the surface table or limits could plausibly live in a reference file. Anchor 4 fits: good structure, appropriately placed content, minor organization gaps; anchor 5 requires well-signaled one-level-deep references that are not present. | 4 / 5 |
Total | 19 / 20 Passed |