Content
92%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 an action-dense operational manual with an explicit, validated workflow (count-first, reconciliation, fail-visible) and excellent progressive disclosure across 82 verified reference files. Its only weakness is minor padding: a few generalized statements and identifier-format rows that restate knowledge Claude already has.
Suggestions
Trim generalized statements Claude already knows (e.g., 'Many APIs return paginated results — if you only read the first page, you may miss data') and keep only the per-database pagination quirks.
Move widely-known identifier formats (e.g., ENSG and rsID patterns) out of the inline table into references/retrieval-contract.md, keeping only the non-obvious mappings like 'GENCODE ID requires version suffix for GTEx' and 'URL-encode HP colons'.
Consider consolidating the POST/custom-header and restricted-access tables into the per-database reference files or the selection guide to reduce inline duplication with references/*.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with non-obvious operational data (rate limits like "NCBI APIs at 3 req/sec without key, 10 with key", per-database pagination parameter names, credential tables), but contains minor trims: "Many APIs return paginated results — if you only read the first page, you may miss data" restates what Claude already knows, and several identifier-table rows (e.g., "ENSG###########", "rs########") restate common knowledge. It is not 5 because of these small padded spots, and not 3 because the padding is minor against overwhelmingly task-specific content. | 4 / 5 |
Actionability | Guidance is fully executable: a copy-paste curl example with --fail-with-body flags, concrete endpoint patterns ("PubChem /compound/name/{name}/cids/JSON", "Ensembl /xrefs/symbol/homo_sapiens/{symbol}"), exact thresholds ("10,000 records, 100 API calls", "at most 5 independent API requests in flight"), and a per-database error-recovery ladder. Specific examples cover the common cases (identifier resolution, rate limits, pagination), matching the top anchor. | 5 / 5 |
Workflow Clarity | The 7-step Core Workflow is clearly sequenced with explicit validation checkpoints: "count first when the API supports it", "reconcile counts", and "fail visibly if the final dataset is incomplete", plus confirmation gates before large retrievals. A dedicated Error recovery section provides the feedback loop (check identifier format → try alternatives → try different database → report), and the Completeness and Reproducibility section is an explicit 6-step checklist — matching the anchor with validation steps, feedback loops, and checklists. | 5 / 5 |
Progressive Disclosure | The hub-and-spoke structure is exemplary: per-database detail lives in one-level-deep reference files (all 82 referenced paths verified to exist, e.g., references/alphafold.md, references/database_selection_guide.md, references/retrieval-contract.md), navigation is well-signaled via the Database Selection Guide and the Available Databases tables mapping each database to its file, and only cross-cutting quick-reference material (identifier formats, credentials) is kept inline. This matches the 'clear overview with well-signaled one-level-deep references' anchor. | 5 / 5 |
Total | 19 / 20 Passed |