Content
82%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.
Highly actionable reference content: executable commands verified against the bundled script, exhaustive parameter documentation, and well-explained gotchas (Assay-group filter logic, bounded `i=`). Weaknesses are mild: duplicated track-predictions example, a mislabeled/oddly numbered section structure, and advanced manual-URL reference material that could be split into a references file.
Suggestions
Rename the "Prerequisites" section to "Usage" or "Quick start" and fix the section numbering so headers run 1-5 consistently, removing the duplicated track-predictions command block between that section and section 5.
Move the advanced manual URL construction detail (full `q`/`lItems` parameter reference, pinned track key schema, `tpRenames`/`tpLegendTitle` options) into a references/ file (e.g. references/url-parameters.md) and keep SKILL.md focused on the script-driven workflow, leaving one-level-deep pointers.
Add a brief decision guide mapping user goals to subcommands (e.g. 'single variant exploration → variant; locus browsing → locus; ref vs alt comparison → track-predictions') and a short validation step (e.g. check the generated URL opens the expected Atlas view before presenting it).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is almost entirely Atlas-specific API detail Claude would not know (query params, filter-boolean gotchas, pinned track key schema) with no padding about known concepts, e.g. "Filters in `f` map to three primary evaluation groups". It is not a 5 because the track-predictions command example appears twice ("Prerequisites" and section 5), the section titled "Prerequisites" actually contains usage examples, and several IMPORTANT callouts are wordy ("leading to severe latency or page hanging") and could be trimmed. | 4 / 5 |
Actionability | Four copy-paste-ready commands ("uv run scripts/alphagenome_atlas_links.py variant \"chr9:128225994:G>A\" --biosample K562 --modalities RNA_SEQ,DNASE,CHIP_TF", plus locus, table, track-predictions) cover the common cases, all of which match the actual script subcommands. The full CLI option table ("--biosample, -b (*string*, default: `Muscle_Skeletal`)") and exact filter/key schemas make guidance fully executable with no gaps. | 5 / 5 |
Workflow Clarity | The single action per task is unambiguous: pick one of four demonstrated subcommands, supply the documented arguments; the motif recipe is a clear numbered sequence ("1. Append entries... 2. Set viewport interval `i`... 3. Configure `f`"). It is not a 5 because there are no validation checkpoints on generated output and no explicit decision guidance mapping user goals to subcommands beyond the examples, and the mislabeled "Prerequisites" header plus numbering starting at "## 2" slightly obscure the entry point. | 4 / 5 |
Progressive Disclosure | Structure is good: clear section headers, and the only bundle file (scripts/alphagenome_atlas_links.py) is well-signaled and repeatedly delegated to ("handled automatically by scripts/alphagenome_atlas_links.py", "Always construct track prediction URLs using scripts/alphagenome_atlas_links.py track-predictions") — one level deep and real. It is not a 5 because ~250 lines of URL parameter reference, pinned-track key schema, and manual-layout detail are inlined in SKILL.md with no references/ files to split advanced material into. | 4 / 5 |
Total | 17 / 20 Passed |