Content
100%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 lean, fully executable instruction sheet: exact base URL, a copy-paste invocation, three complete request patterns, an explicit I/O contract, and practical guidance for a fragile upstream API, all verified against the actual bundled script. It is a strong example of a compact, single-purpose skill with no padding.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~37-line body is all operational guidance — base URL, endpoint preferences, stdin JSON contract, output fields, one runnable command — with no explanation of concepts Claude already knows (no "what is a REST API" padding). Every bullet carries non-inferable, fragile-upstream knowledge; anchor 5 fits, and anchor 4's "minor instances of over-explanation" don't apply. | 5 / 5 |
Actionability | The Execution section gives a copy-paste-ready bash command and the Input section lists three complete, executable JSON request objects covering the common cases (list studies, association by gene+rsid, legacy per-gene associations), plus an explicit required/optional field contract. This matches anchor 5; nothing is pseudocode or high-level. | 5 / 5 |
Workflow Clarity | This is a simple single-purpose skill (one action: echo a JSON request into scripts/rest_request.py) and that action is unambiguous with the exact command shown, so the simple-skill exception applies. Checkpoints are also present for the fragile upstream: "surface upstream 400/500 errors verbatim when they occur", "Failure returns ok=false with error.code and error.message", and "Re-run requests in long conversations" as a retry loop. The destructive/batch cap does not apply — the operation is read-only retrieval bounded by max_items. | 5 / 5 |
Progressive Disclosure | Under 50 lines with well-organized sections (Operating rules, Execution behavior, Input, Output, Execution, References) and a single one-level reference to scripts/rest_request.py, which exists in the bundle and whose interface matches the body's claims (variant_id→snp mirroring, filter backfills, save_raw/record_path). The References section explicitly bounds the import package, so the structure guideline for short skills with no external references is fully met. | 5 / 5 |
Total | 20 / 20 Passed |