Content
86%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.
A well-structured, highly actionable command catalog with appropriate progressive disclosure to real reference files. Could tighten the duplicated parsing warning and add an explicit query-failure validation step.
Suggestions
De-duplicate the cat/jq parsing guidance — state it once and reference it, instead of repeating the full warning in both 'Core Rules' and 'Parsing Output (CRITICAL)'.
Add an explicit validation checkpoint for query results (e.g., check the output JSON for empty results or error fields before parsing with jq, and retry or report on failure).
Slightly tighten the 'Type A' biosample explanation to assume domain familiarity, since the four core markers are already enumerated.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and action-oriented, but the cat/jq parsing warning is repeated in both 'Core Rules' and the 'Parsing Output (CRITICAL)' section, and the 'Type A' biosample explanation could be trimmed slightly. | 4 / 5 |
Actionability | Provides copy-paste-ready, fully executable `uv run scripts/...` commands with real flags and concrete accessions across search, details, biosamples, gwas, entex, and more, covering the common cases comprehensively. | 5 / 5 |
Workflow Clarity | Clear, consistent sequence (run wrapper → save to /tmp → parse with jq) and sequenced prerequisites, with built-in resilience noted (rate limiting, mm10 fallback), but no explicit validation/error-recovery checkpoint for failed or empty queries. | 4 / 5 |
Progressive Disclosure | Keeps the body as an overview with bulk reference material (JSON output structure, GraphQL schema) split into well-signaled, one-level-deep files in references/ that genuinely exist. | 5 / 5 |
Total | 18 / 20 Passed |