Content
70%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 well-structured, highly actionable tool-dispatch skill with an explicitly sequenced workflow and genuine error-recovery loops. Its weaknesses are redundancy — the AlphaGenome 'annotation-silent' narrative is repeated across five sections — and the absence of any reference files, leaving example workflows and tool parameter detail inlined in an overlong single file.
Suggestions
Consolidate the AlphaGenome/annotation-silent narrative, which currently appears in the five-questions section, Phase 0.5, Phase 4.5, Phase 5, and Fallback Strategies — state it once (Phase 4.5) and cross-reference it elsewhere to cut substantial token cost.
Move the four example workflows into a references/ file (e.g., references/examples.md) and the per-tool parameter details into references/tools.md, keeping SKILL.md as a concise phase overview with one-level-deep pointers.
Replace placeholder arguments in the example workflows (chromosome=..., position=...) with one fully specified real call each (e.g., the rs429358 APOE example with concrete coordinates) so the examples are copy-paste executable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient but could be tightened: the 'annotation-silent / AVI_SCORE' narrative is explained at length in five places (the five-questions section, Phase 0.5, Phase 4.5, Phase 5, Fallback Strategies), and lines like 'H3K27ac signals active enhancers and active promoters; H3K4me1 alone marks poised enhancers' re-teach histone-mark basics Claude already knows. It is not 2 because there is no library-installation-style padding and most sections (phase descriptions, fallbacks, limitations) earn their tokens. | 3 / 5 |
Actionability | Guidance is mostly concrete and executable: exact tool names with parameters ('gwas_search_associations ... Use p_value=5e-8'), parameter gotchas ('param is variant_id, not rsid', 'Use assay_title="TF ChIP-seq" (not just "ChIP-seq")'), and window limits ('≤500 bp', 'up to 1 Mb'). It is not 5 because the worked examples use placeholder arguments (chromosome=..., position=...) rather than fully specified calls, leaving minor gaps. | 4 / 5 |
Workflow Clarity | The phased workflow (0 through 6) is clearly sequenced with explicit entry conditions and error-recovery feedback loops: Phase 4.5 runs 'when either condition holds: (a) Phases 1-4 came back empty or weak ... or (b) Phase 0.5's AVI_SCORE was high', and the Fallback Strategies section gives per-tool recovery actions for empty results (e.g., 'GWAS Catalog returns empty: Switch from free-text disease_trait to efo_id'). Not 4 because checkpoints are explicit rather than implicit, and Phase 5 provides a graded decision checklist. | 5 / 5 |
Progressive Disclosure | Sections are clearly headed and navigable, but the skill is a single ~280-line file with no references/ bundle; content that clearly belongs in separate files is inlined (four full example workflows, per-tool parameter details). It is not 2 because the inlined material is well-sectioned, not a monolithic reference dump; it is not 4 because the examples and tool specifics could be split into one-level-deep reference files that do not exist. | 3 / 5 |
Total | 15 / 20 Passed |