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.
An exemplary lean script-wrapper skill: fully executable examples, a complete and accurate input/output contract, sensible guard-endpoint ordering, and honest reference hygiene at ~35 lines. The only meaningful gap is the absence of error-recovery guidance beyond reporting the failure payload.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~35-line body is bullet-terse with no concept explanations Claude already knows (no 'what is an API' padding), and every rule adds non-obvious value, e.g. "Treat displayed `...` in tool previews as UI truncation, not literal request content". This matches anchor 5 ('lean and efficient; assumes Claude's competence; every token earns its place') — nothing reads as trimmable padding. | 5 / 5 |
Actionability | The body gives a copy-paste-ready executable command (echo '{...}' | python scripts/rest_request.py), three concrete JSON request patterns, exact endpoint paths (`ontology/gwas-efo`, `gene/drugs`, `mr`, `literature/gwas`), and a complete field-by-field input/output contract that matches the actual script. This matches anchor 5 ('fully executable; copy-paste ready; specific examples cover the common cases'). | 5 / 5 |
Workflow Clarity | The single action (format JSON, pipe to the script, summarize) is unambiguous, and sequencing guidance exists ("Prefer the connectivity guard endpoints first ... `ping`, `builds`, and `meta/api-endpoints`"); the skill is read-only, so no destructive/batch validation cap applies. Held at anchor 4 rather than 5 because the documented failure output ("`ok=false` with `error.code` and `error.message`") has no recovery guidance, e.g. what to change before retrying. | 4 / 5 |
Progressive Disclosure | Per the rubric's simple-skill guideline (under 50 lines, no external references needed), the well-organized sections (Operating rules, Execution behavior, Input, Output, Execution, References) merit a 5: the body is a compact overview, the single referenced bundle file `scripts/rest_request.py` exists and matches the documented contract, and the References section explicitly states "No additional runtime references are required" instead of dangling pointers. | 5 / 5 |
Total | 19 / 20 Passed |