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 well-structured, highly actionable CLI skill: every command is executable as written, guidance on when not to use the skill is explicit, and detailed query syntax is properly deferred to a well-signaled reference file. Remaining gaps are minor: a redundant command-selection section, no explicit ordered resolve-to-query workflow, and one unreferenced bundle file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient: each command section is a purpose line, a runnable example, and its arguments, with no padding or explanations of concepts Claude already knows. Not 5 because the Command Selection Guide restates the purpose of every Commands subsection, and the intro paragraph partially duplicates the description's RNA-vs-protein framing. | 4 / 5 |
Actionability | Every subcommand has a copy-paste-ready `uv run scripts/hpa_cli.py ...` invocation with concrete arguments, the Quick Start covers the common resolve-then-query path, and Common Errors gives specific remediation steps (consult references/search-api.md, search the web for example queries, process output with jq). Fully executable with the common cases covered. | 5 / 5 |
Workflow Clarity | The Ensembl-first dependency is explicit ("HPA endpoints are strictly Ensembl-based"), the Command Selection Guide maps user intent to the right subcommand, and Common Errors supplies recovery guidance for empty or oversized results. Not 5 because there is no explicit ordered resolve-to-query sequence or verification step confirming the symbol resolved before querying. | 4 / 5 |
Progressive Disclosure | The body is a clean overview that appropriately pushes search query syntax into references/search-api.md, signaled clearly at both point of need (the search-hpa --query docs) and in Common Errors, exactly one level deep; scripts/hpa_cli.py is referenced throughout. Not 5 because references/citation.bib exists in the bundle but is never referenced or navigated from SKILL.md, a minor organization gap. | 4 / 5 |
Total | 17 / 20 Passed |