Content
75%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 well-structured, highly actionable, and includes a real validation feedback loop for incomplete/large results, with most content appropriately split into a single one-level-deep reference. The main gaps are a broken custom-query code example and a slightly malformed reference link.
Suggestions
Fix the custom-query example: add the missing opening quote for the GraphQL query string and a `\` line continuation before the `--output` line so the snippet is copy-paste executable.
Correct the reference link to include the `.md` extension ([references/OpenTargets_GraphQL_Guide.md](references/OpenTargets_GraphQL_Guide.md)) so navigation resolves.
Tighten the Overview and L2G sections to remove phrasing that reiterates the description, pushing conciseness toward 5.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean, assumes Claude's competence (no basic PDF/library-style padding), but the Overview mildly reiterates the description and the L2G and Tips sections could be tightened, fitting the 'efficient with minor over-explanation' anchor. | 4 / 5 |
Actionability | Concrete, copy-pasteable `uv run` commands with real IDs (e.g. MONDO_0008383, ENSG00000156515) cover common cases, but the custom-query example is not executable as written (missing opening quote for the query string and a missing `\` line-continuation before `--output`), leaving a minor gap. | 4 / 5 |
Workflow Clarity | Subcommand workflows are clearly sequenced and there is an explicit feedback loop for the main batch risk (compare `count` to returned `rows`, then increase `--page-size` or inform the user), but checkpoints are scattered rather than presented as a clean checklist. | 4 / 5 |
Progressive Disclosure | Good structure with the bulk schema detail split into a one-level-deep reference (OpenTargets_GraphQL_Guide.md) and clearly signaled; the reference link drops the `.md` extension and some inline command reference could arguably live in the reference, leaving a minor organization gap. | 4 / 5 |
Total | 16 / 20 Passed |