Content
85%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 highly actionable, well-structured CLI skill reference whose commands, arguments, and workflows are fully executable and include appropriate validation and error-recovery guidance. Its main weaknesses are an orphaned bundle file (references/citation.bib is never referenced) and inline API-reference detail that could live in a separate file.
Suggestions
Reference `references/citation.bib` from the body (e.g., a Sources/Citation section) or remove it, so no bundle file is undiscoverable.
Move the detailed per-command argument lists and the search-syntax quick reference into a references/ file (e.g., API.md), keeping SKILL.md as a lean overview with one example per subcommand.
Deduplicate the OPEN_ACCESS guidance — it appears both in Core Rules and in the note after the search syntax section.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a dense, on-point command reference with no explanations of concepts Claude already knows; only minor trimming is needed (the database stats sentence in the intro, and the OPEN_ACCESS note duplicated in Core Rules and again after the search syntax section). | 4 / 5 |
Actionability | Every subcommand has copy-paste-ready `uv run` examples with real DOIs/PMCIDs, complete argument documentation with defaults, output schema descriptions, and jq-based multi-step recipes — all verified to match the actual script CLI. | 5 / 5 |
Workflow Clarity | Common Workflows are clearly sequenced step-by-step, and the body includes explicit validation ("check the pdf downloaded is not empty or corrupted") plus a feedback loop (check `isOpenAccess` and fall back to the abstract on retrieval failure); operations are read-only so the destructive/batch cap does not apply. | 5 / 5 |
Progressive Disclosure | Sections are well organized and the script is clearly referenced throughout, but the bundle's `references/citation.bib` is never mentioned in the body (an orphaned, undiscoverable reference) and roughly 150 lines of per-command argument and search-syntax reference are fully inlined in SKILL.md rather than split out — matching the anchor where content that should be separate is inline. | 3 / 5 |
Total | 17 / 20 Passed |