Content
65%Reviews 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 but is verbose with redundant download blocks, lacks validation checkpoints in its download workflow, and references bundle files (scripts/download_cosmic.py, references/cosmic_data_reference.md) that are not present.
Suggestions
Trim the marketing prose in the Overview and collapse the repeated download_cosmic_file blocks into one parameterized example plus a table of data-type file paths.
Add an explicit post-download verification checkpoint (e.g., confirm file is non-empty / gz is valid before reading with pandas) to lift workflow_clarity above 2.
Either ship the referenced references/cosmic_data_reference.md and scripts/download_cosmic.py or remove the dangling references so progressive disclosure reflects the actual bundle.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly actionable, but includes padded marketing prose ('world's largest and most comprehensive database... millions of mutations across thousands of cancer types') and repeats the same download_cosmic_file block with placeholder email/password many times; not score 3 because the redundancy and fluff could be tightened, and not score 1 because it does not lecture on concepts Claude already knows. | 2 / 3 |
Actionability | Provides copy-paste-ready Python (download_cosmic_file, pandas filtering, pysam VCF fetch) and concrete CLI commands with real flags and file paths; not score 2 because the examples are executable and complete rather than pseudocode. | 3 / 3 |
Workflow Clarity | Sequenced quick-start steps exist, but the download-then-analyze workflow has no validation/verification checkpoints and the script's success is never confirmed before downstream pandas use; per the rubric, missing validation in batch/download workflows caps this at 2, and it is not 1 because a sequence is present. | 2 / 3 |
Progressive Disclosure | The body signals a one-level reference ('see references/cosmic_data_reference.md') and a script, but those bundle files do not exist in references/ or scripts/, and the long data-types/file-format catalog is inlined in SKILL.md rather than split out; not score 3 because references are broken and content that should be separate is inline, not score 1 because there is section structure and the reference is only one level deep. | 2 / 3 |
Total | 9 / 12 Passed |