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.
The body is a model of token-efficient skill authoring: an operational contract (input schema, output schema, defaults, rate limits, error fields), a runnable example, and well-signaled one-level references verified against the actual bundle. The only gap is that the submit→poll→fetch sequence and failure-retry behavior are implied by the action definitions rather than stated as an explicit ordered workflow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is entirely operational bullets — "Honor NCBI limits: `>=10s` between requests and `>=60s` between polls for the same RID" — with no explanation of what BLAST is or how the API works conceptually. Every line teaches the model something it could not infer, matching the lean/efficient anchor; there is no padding to trim as in the 4-anchor. | 5 / 5 |
Actionability | It provides a copy-paste-ready command ("echo '{"action":"run",...}' | python scripts/ncbi_blast.py"), the complete stdin JSON contract including all actions ("`action` must be one of `submit`, `status`, `fetch`, or `run`"), every default ("`max_hits` defaults to `5`"), and the exact output/error fields. This is fully executable guidance covering the common cases, matching the 5-anchor rather than the minor-gaps 4-anchor. | 5 / 5 |
Workflow Clarity | The submit→poll(status)→fetch flow is unambiguous and includes real checkpoints: rate-limit guards, RTOE handling, status normalization, and "Failures return `ok=false`, `error.code`, `error.message`" for error recovery. However, the sequence is implied by the action definitions rather than given as an explicit ordered workflow with retry/backoff on failure, which keeps it at "clear sequence with most checkpoints; minor validation gaps" rather than the explicit feedback-loop structure of the 5-anchor. No destructive/batch cap applies since BLAST submissions are non-destructive. | 4 / 5 |
Progressive Disclosure | The body is an overview that delegates cleanly: "Load `references/blast-common-url-api.txt` only for parameter details or uncommon BLAST options" and "Do not load `references/intent-notes.txt` during normal skill execution", and both files plus `scripts/ncbi_blast.py` and its test exist in the bundle. References are one level deep, well signaled with explicit load conditions, and the parameter/API detail genuinely lives in the reference file rather than being inlined — matching the clear-overview anchor exactly. | 5 / 5 |
Total | 19 / 20 Passed |