Content
71%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, information-dense skill whose tool guidance is exemplary (real IDs, expected outputs, live-verified failure modes, fallbacks). Its weaknesses are structural: a monolithic 466-line file with no progressive disclosure and significant parameter duplication across the Key Tools, Phase, and Tool Parameter Reference sections.
Suggestions
Split the Key Tools table, Tool Parameter Reference, RegulomeDB rank table, and cCRE type definitions into references/ files (e.g., references/tools.md, references/regulomedb-scores.md), keeping SKILL.md as a concise overview with one-level-deep, clearly signaled pointers.
Eliminate the triplicated parameter information by keeping parameters in exactly one place (the reference file) and having the Phase walkthroughs link to it instead of restating params.
Add explicit validation checkpoints to the workflows (e.g., confirm the JASPAR matrix_id version exists before calling jaspar_get_matrix, and verify an experiment accession's status before depending on its files).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with non-obvious operational knowledge (live-verified latencies, exact vocabularies, failure modes) rather than general-concept padding, but the same tool parameter information appears three times — in the Key Tools table, the Phase walkthroughs, and the Tool Parameter Reference table — and the RegulomeDB rank table plus cCRE type definitions are reference material that could be tightened or split out. This matches 'mostly efficient but could be tightened' better than 'minor instances that could be trimmed' (4) and is clearly above 'several unnecessary explanations' (2). | 3 / 5 |
Actionability | Calls are copy-paste ready with real values (matrix_id "MA0139.1", dataset_id "EXP030726.neural_stem_cells.SMAD3", region "7:140424943-140524564", rsid "rs4994") and annotated expected-response fields, plus concrete fallback strategies and measured operational limits (10-25s motif queries, ≤500bp ISM window). Examples cover the common cases for every tool family. | 5 / 5 |
Workflow Clarity | Phases 1-4 are clearly sequenced and the Patterns, Fallback Strategies table, 'retry once before concluding the call failed' note, and 'relax filters and retry' guidance form explicit error-recovery loops. It falls short of 5 because the main workflows lack explicit validate-before-proceeding checkpoints (e.g., confirming a matrix_id or accession exists before the dependent call); the destructive/batch cap does not apply since all operations are read-only queries. | 4 / 5 |
Progressive Disclosure | There are no bundle files at all — no references/, scripts/, or assets/ — so everything lives in a single 466-line SKILL.md, including ~250 lines of API-reference material (two large tool/parameter tables, the 15-row RegulomeDB rank table, cCRE type definitions) that clearly belongs in separate reference files. Section headers give it real structure (above the 'minimal structure' anchor 2), but the inline reference material matches anchor 3: 'content that should be separate is inline'. | 3 / 5 |
Total | 15 / 20 Passed |