Content
80%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 lean and highly actionable with executable examples for every command. Its main weaknesses are a workflow that leaves a placeholder unfilled and lacks validation checkpoints, and an orphaned reference file with no in-body navigation.
Suggestions
Replace the '<gencode_id>' placeholder in Typical Workflows step 2 with the actual resolved value and add an explicit validation checkpoint (e.g., verify the JSON from step 1 contains the GENCODE ID before running step 2).
Reference references/citation.bib from the body (e.g., a 'Citation' section linking to it) so the bundled reference file is discoverable and not orphaned.
Deduplicate the resolve-gencode-id example that appears in both Quick Start and section 1, and tighten the overlap between the 'When to Use' bullets and the 'Command Selection Guide' to further improve conciseness.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence, with only minimal expansions (TPM, eQTL) that aid correct command use; minor cross-referenced repetition between Quick Start and the Commands section is light rather than padded. | 3 / 3 |
Actionability | Every subcommand ships fully executable 'uv run scripts/gtex_cli.py ...' examples with concrete positional and optional arguments plus defaults, making the guidance copy-paste ready. | 3 / 3 |
Workflow Clarity | Typical Workflows provides a clear two-step sequence, but step 2 uses a placeholder '<gencode_id>' instead of the resolved value and there are no explicit validation or error-recovery checkpoints, matching the 'steps listed but validation gaps' anchor. | 2 / 3 |
Progressive Disclosure | Sections are well organized, but the bundle's references/citation.bib is never referenced or signaled from the body and there are no one-level-deep detail files to navigate to, matching the 'some structure but references not clearly signaled' anchor. | 2 / 3 |
Total | 10 / 12 Passed |