Content
85%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 tight, actionable skill body that gives Claude everything needed to run the script correctly with no concept padding. The only blemish is one duplicated preference rule across two sections.
Suggestions
Consolidate the duplicate targeting guidance: keep a single 'Prefer targeted endpoint calls over broad unfiltered pulls' statement rather than restating it in both Operating rules and Execution behavior.
Consider merging Operating rules and Execution behavior, which overlap in guidance about targeted calls and raw-vs-summary output, to further tighten the body.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence without explaining NCBI or JSON, but 'Prefer targeted metadata paths instead of broad unfiltered pulls' and 'Prefer targeted endpoint calls instead of broad unfiltered dumps' are near-duplicate guidance that could be consolidated. | 2 / 3 |
Actionability | It provides explicit REST path values, named optional fields, three concrete payload patterns, and a copy-paste-ready bash invocation against the real scripts/ncbi_datasets.py. | 3 / 3 |
Workflow Clarity | This is a single-action skill whose invocation is unambiguous (echo JSON | python script), with Input/Output contracts and a documented failure path; per the simple-skill note an unambiguous single action scores 3. | 3 / 3 |
Progressive Disclosure | The body is under 50 lines and organized into clearly labeled sections, with the only bundle file (scripts/ncbi_datasets.py) referenced one level deep and confirmed to exist. | 3 / 3 |
Total | 11 / 12 Passed |