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.
The body is a tight, executable contract for a single-purpose script skill: exact input schemas, worked examples, a runnable command, and defined output/error behavior, all verified against the bundled script. Its only flaw is mild repetition between the Operating rules and Execution behavior sections.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The 38-line body is lean with no concept explanations Claude already knows, but there is minor redundancy — 'Page with offset instead of asking for large pulls' (Operating rules) repeats 'Keep count modest and page with offset instead of pulling large result sets at once' (Execution behavior). Matches anchor 4 ('efficient; minor instances... that could be trimmed'). | 4 / 5 |
Actionability | Fully executable guidance: three exact JSON input patterns and a copy-paste bash command ('echo ... | python scripts/ncbi_gene_clinicaltables.py'), with documented fields verified to match the actual script. Matches anchor 5 ('copy-paste ready code or commands; specific examples cover the common cases'). | 5 / 5 |
Workflow Clarity | A simple single-action skill (pipe one JSON object to the script) whose single action is unambiguous, with clear input, output, and error contracts ('Failure returns ok=false with error.code and error.message'). It is a read-only API query, so the destructive/batch validation cap does not apply, and the simple-skill exception holds. | 5 / 5 |
Progressive Disclosure | Under 50 lines with no need for external references — the References section explicitly states none are required — and the one referenced path, scripts/ncbi_gene_clinicaltables.py, exists in the bundle. Sections (Operating rules, Execution behavior, Input, Output, Execution, References) are well organized, matching the simple-skill guideline for a 5. | 5 / 5 |
Total | 19 / 20 Passed |