Content
77%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.
A thorough, highly actionable CLI skill with excellent executable examples and well-sequenced workflows. It loses points for repeated content across sections and for leaving bundle reference files unlinked from the body.
Suggestions
Dedupe the recurring guidance — keep the search-region-vs-resolve-variant caution, the --full warning, and the X/Y→23/24 rule in one canonical place and reference it elsewhere rather than restating each 2–3 times.
Link references/api-notes.md (and citation.bib) from the body — e.g. add a short '## Reference material' section signaling them — so the one-level-deep bundle is discoverable and the Commands section can stay an overview.
Consider moving the full per-command argument tables into a reference file and keeping SKILL.md as a concise command-selection + quick-start overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Accurate and free of irrelevant background, but ~350 lines with notable repetition — the search-region-vs-resolve-variant caution, the --full payload warning, and the X/Y→23/24 rule each appear two to three times across Core Rules, Commands, and Common Mistakes — so it is not fully lean. | 2 / 3 |
Actionability | Every subcommand ships copy-paste-ready 'uv run scripts/dbsnp_cli.py ...' invocations with positional args, flags, defaults, and concrete output JSON shapes (e.g. {"rsids": [...]}). | 3 / 3 |
Workflow Clarity | Sequenced Typical Workflows with numbered Step 1/Step 2 stages, a command-selection guide for first-try routing, and explicit auto-assembly-fallback plus troubleshooting with 'DO NOT RETRY' guidance; these are read-only queries so the destructive-ops validation cap does not apply. | 3 / 3 |
Progressive Disclosure | The body correctly points to the real scripts/dbsnp_cli.py and the uv/credentials skills, but references/api-notes.md and references/citation.bib are never linked or signaled from the body, and the Commands section is a fairly monolithic inline reference rather than split with clear one-level navigation. | 2 / 3 |
Total | 10 / 12 Passed |