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.
The body is highly actionable with copy-paste-ready commands and clear workflows, and it respects the context budget without over-explaining basics. It could improve by surfacing the unused `citation.bib` reference and adding explicit validation/checkpoints around batch and download operations.
Suggestions
Reference `references/citation.bib` (e.g. in the citations/references subcommands) so the bundle file is discoverable rather than orphaned.
Add explicit validation checkpoints for batch operations — e.g. after `get_citations`/`get_references`, verify `hitCount > 0` and the result array is non-empty before parsing.
Tighten the repeated `uv run scripts/europepmc_api.py search` examples between the search section and Common Workflows to reduce token redundancy.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Efficient and assumes Claude's competence — no padding explaining what Europe PMC or a DOI is. There is minor repetition across the per-subcommand examples and Common Workflows that could be trimmed. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready `uv run` commands with real arguments and flags for every subcommand, plus complete argument tables and output schemas covering the common cases. | 5 / 5 |
Workflow Clarity | Multi-step workflows (DOI→PDF, PMID→full text, citation graph traversal, pagination) are clearly sequenced with shell snippets. Validation is light (only the "check the pdf is not empty or corrupted" note) but the operations are largely non-destructive, so it sits just below the explicit-feedback-loop anchor. | 4 / 5 |
Progressive Disclosure | Well-organized into prerequisites, core rules, per-subcommand sections, and workflows; the referenced `scripts/europepmc_api.py` is a real one-level-deep bundle file. Minor gap: `references/citation.bib` exists but is never referenced from the body. | 4 / 5 |
Total | 17 / 20 Passed |