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.
A highly actionable, domain-rich reference with executable commands and useful guardrail callouts. Its main weaknesses are structural: inconsistent section labeling/numbering and heavy inline reference material that would benefit from being split into a separate file.
Suggestions
Fix the section structure: rename 'Prerequisites' to a usage/quick-start heading and correct the numbering (sections jump from an unnumbered section straight to '2. URL Query Parameters').
Move the full URL query-parameter reference and the pinned-track key schema into a references/ file, keeping SKILL.md as a lean overview with pointers.
Add a verification step to the workflow, e.g. generate with '--format url' and sanity-check the assembled query string before presenting links to the user.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with domain-specific facts Claude would not know (filter boolean logic, pinned-track key schema, latency gotchas) rather than padding, but a few passages over-explain rationale — e.g. the NMD/cryptic-junction justification in the splicing co-plotting callout — and could be trimmed. | 4 / 5 |
Actionability | Commands are copy-paste ready ('uv run scripts/alphagenome_atlas_links.py variant "chr9:128225994:G>A" --biosample K562 ...'), CLI options are documented with types and defaults, and exact URL formats (including percent-encoded examples) cover the common cases. | 5 / 5 |
Workflow Clarity | The motif recipe is a clear numbered sequence and mandatory callouts act as guardrails, but the 'Prerequisites' section is actually a usage quick-start, section numbering begins at '2' with no '1', and there is no step to verify generated links (e.g. --format url) — though operations are non-destructive so the validation cap does not apply. | 4 / 5 |
Progressive Disclosure | The bundle script (scripts/alphagenome_atlas_links.py, which exists) is well-signaled and repeatedly cross-referenced, and sections are clearly headed; however ~250 lines of URL-parameter and pinned-track-key reference material are inlined in SKILL.md where a references/ file would keep the overview leaner. | 4 / 5 |
Total | 17 / 20 Passed |