Content
92%Weight 40%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a well-organized, action-dense reference: every subcommand has executable examples, a clear retrieval cascade sequences the workflows, and selection guidance is spelled out. The main gap is progressive disclosure — the ten subcommand sections are all inline and the bundled citation.bib is never referenced.
Suggestions
Move detailed per-subcommand usage into a separate reference file (e.g. references/SUBCOMMANDS.md) and keep SKILL.md as a concise overview with one-level-deep links, to improve progressive disclosure.
Either reference references/citation.bib from the body or remove it from the bundle, so no shipped reference file is orphaned.
Fix the patent-search examples so they render as fenced ```bash blocks like the other nine sections, restoring copy-paste-ready actionability.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dominated by lean, executable bash examples and one-line subcommand descriptions, with no padding explaining concepts Claude already knows (e.g., what NCBI or FASTA is); not level 2 because there is little unnecessary explanation, though the API-key guidance is restated across Prerequisites and Core Rules. | 3 / 3 |
Actionability | Each subcommand ships copy-paste-ready `uv run scripts/ncbi_fetch.py ...` commands with real arguments and flags, plus a clear retrieval cascade; not level 2 because the guidance is concrete and executable rather than pseudocode, though the patent-search examples lose their fenced-block formatting ("`bash uv run ...`"). | 3 / 3 |
Workflow Clarity | The "Standard Sequence Retrieval Cascade" lays out a 7-step priority order and "Interpreting Results" gives selection rules, with the cds-translate `is_genomic: true` flag acting as a checkpoint; not capped at 2 because these are read-only fetches (not destructive/batch ops) so the rubric's feedback-loop requirement does not bind. | 3 / 3 |
Progressive Disclosure | Structure and section navigation are clear and `scripts/ncbi_fetch.py` is correctly referenced one level deep, but all ten subcommand details live inline in SKILL.md rather than being split into reference files, and the bundled `references/citation.bib` is never referenced or signaled; not level 3 because content is not appropriately split and there is an orphaned bundle file, not level 1 because the overview does serve as a usable index. | 2 / 3 |
Total | 11 / 12 Passed |