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 strong, lean single-file skill body: executable CLI and Python examples throughout, a sensible small-query-first workflow with a review checklist, and clean section structure. The only real upside is offloading per-module detail to a references/ file and making workflow checkpoints more explicit.
Suggestions
Move per-module detail (the 'Common Modules' list) into a references/modules.md file and keep one-line summaries inline, shortening SKILL.md.
Make the small-query-first checkpoint an explicit validate step, e.g. 'If the small query errors or returns nothing, check the module docs before retrying'.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean with no explanations of concepts Claude already knows (no 'what is BLAST' padding) and every section carries actionable content, but a few spots ('Before relying on an older environment...', 'Do not assume every module supports...') could be tightened further, matching 'efficient; minor instances of over-explanation'. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready commands cover the common cases: `gget search -s human brca1 dna repair -o brca1-search.json`, `gget info ENSG00000012048 -o brca1-info.json`, `gget seq ENSG00000012048 -o brca1-seq.fa`, `gget blast "MEEPQ..." -l 10`, plus runnable Python (`gget.search(["BRCA1"], species="human")`), matching the anchor for copy-paste ready examples across common cases. | 5 / 5 |
Workflow Clarity | The numbered 'Common workflow' (identify species/assembly -> check docs -> run a small query first -> save with explicit filename -> record metadata) plus the closing 'Review Checklist' give a clear sequence with checkpoints; it stops short of 5 because checkpoints are partly implicit rather than explicit validate-fix-retry loops. The destructive/batch cap does not apply since queries are read-only lookups. | 4 / 5 |
Progressive Disclosure | A single-file, well-sectioned skill (When to Use / Installation / Basic Patterns / Common Modules / Quick Examples / Reproducibility Log / Review Checklist / References) with clearly signaled external links; at ~160 lines the under-50-line exception doesn't apply and per-module details could be offloaded to a reference file, so 'good structure; minor organization gaps' fits. | 4 / 5 |
Total | 17 / 20 Passed |