Content
72%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 highly actionable with executable examples and good progressive disclosure via a real reference file and script, but it carries some explanatory padding and time-sensitive version info that hurt conciseness, and the download workflow lacks explicit validation checkpoints.
Suggestions
Trim or move concept explanations (COSMIC overview, "Integration with Other Tools") that Claude already knows, and relocate the v102/May 2025 version info into a versioning or deprecated section.
Add explicit validation checkpoints to the download workflow (e.g., verify authentication succeeded before bulk download, confirm file integrity/size after download).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient with executable code, but padded sections (Overview explaining what COSMIC is, "Integration with Other Tools") and time-sensitive info ("v102, May 2025") outside a deprecated section add unnecessary tokens. | 3 / 5 |
Actionability | Fully executable, copy-paste-ready code across download, CLI, pandas filtering, and pysam VCF examples covers the common cases comprehensively. | 5 / 5 |
Workflow Clarity | Quick Start provides a numbered sequence, but this batch/large-download workflow lacks explicit validation checkpoints (auth success, download integrity) before proceeding, capping clarity at 3. | 3 / 5 |
Progressive Disclosure | Clear overview with a well-signaled one-level-deep reference (references/cosmic_data_reference.md, a real file) and a real script, both clearly navigated and appropriately split. | 5 / 5 |
Total | 16 / 20 Passed |