Content
70%Weight 40%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a well-structured, actionable command reference with good validation guidance and a clean one-level-deep reference split, but it is held back by a broken custom-query example and minor repetition of the pagination warning.
Suggestions
Fix the custom-query bash block: add the opening quote (`custom-query 'query drugsForDisease...`) and a `\` continuation before `--output` so the example is copy-paste executable.
De-duplicate the incomplete-results warning: keep the detailed version in the L2G section and shorten the Tips entry to a one-line pointer to avoid repeating the same guidance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient and avoids explaining concepts Claude already knows, but the pagination / 'count vs rows' incomplete-results warning is restated in both the L2G section and the Tips section, and 'Quick Reference' overlaps lightly with 'Core Rules'. | 2 / 3 |
Actionability | The subcommand reference is concrete with real IDs and copy-paste-ready invocations, but the flagship 'Advanced GraphQL Queries' custom-query example is broken — it is missing the opening quote before `query` and the line-continuation backslash before `--output` — so it is not executable as written. | 2 / 3 |
Workflow Clarity | Commands are unambiguous and the body gives an explicit validation checkpoint (compare the API `count` field to rows returned) with a feedback loop (increase `--page-size` or inform the user of partial results), plus a sequenced license-notification prerequisite. | 3 / 3 |
Progressive Disclosure | The overview keeps command usage inline while deferring full schema details to a clearly signaled, one-level-deep reference (references/OpenTargets_GraphQL_Guide.md, which exists), and the wrapper script lives in scripts/ — content is appropriately split. | 3 / 3 |
Total | 10 / 12 Passed |