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.
The body is a well-orchestrated overview: dense operational tables, a clear five-step workflow with explicit error-recovery feedback loops, and clean one-level-deep delegation to ten verified reference files. Its only weaknesses are mild — a slightly padded opening step and no inline example call, meaning even trivial lookups require reading a reference file first.
Suggestions
Trim step 1 ('Understand the query -- What is the user looking for? A specific paper by DOI? Papers on a topic?...') to a single line; the query-type breakdown is already fully encoded in the By Use Case and Cross-Database Queries tables.
Add one minimal inline example (e.g., a PubMed eSearch URL like https://eutils.ncbi.nlm.nih.gov/entrez/eutils/esearch.fcgi?db=pubmed&term={query}&retmode=json) so simple lookups are executable without first reading a reference file.
Consider compressing the six-platform 'Making API Calls' fetch-tool table to the most common platforms and a single fallback rule ('use your environment's HTTP fetch tool; fall back to curl'), since most sessions run on one platform.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Quotes: the body is almost entirely operational tables ("max 3 req/sec without key, 10 with key", "Crossref... add mailto param for polite pool", env var names, identifier formats) with no explanation of concepts Claude already knows. Minor trimmable instances remain: step 1 "Understand the query -- What is the user looking for? A specific paper by DOI? Papers on a topic?" restates what the selection tables already encode, and the six-platform HTTP fetch tool table is broader than most sessions need. This matches anchor 4 (efficient, minor over-explanation) rather than 5, where every token earns its place; not 3: there is no padded section or unnecessary explanation. | 4 / 5 |
Actionability | Quotes: concrete guidance throughout — "Cross-referencing IDs: Semantic Scholar accepts DOI, PMID, PMCID, and arXiv ID via prefixes (e.g., DOI:10.1038/nature12373)", "Pass as: &api_key=YOUR_KEY" (in references), "If you get HTTP 429 (rate limit), wait briefly and retry once", a copy-ready output template, and reference files verified to contain fully executable example URLs. The gap: the body itself contains zero inline example API calls, deferring all endpoint detail to the reference files, so a simple lookup requires a file read first. This matches anchor 4 (mostly executable, minor gaps) rather than 5 (specific examples cover the common cases inline); not 3: nothing is pseudocode or high-level hand-waving. | 4 / 5 |
Workflow Clarity | Quotes: a numbered "Core Workflow" (understand → select databases → read reference file → make calls → return results) with explicit output requirements ("If a query returned no results, say so explicitly rather than omitting it"), plus a dedicated Error Recovery section with feedback loops: "Check the identifier format... Try alternative identifiers... Try a different database... Report the failure -- tell the user which database failed, the error, and what you tried", and rate-limit retry guidance. This matches anchor 5 (clear sequence with explicit validation and feedback loops for error recovery); not 4: checkpoints are explicit, not implicit. | 5 / 5 |
Progressive Disclosure | Quotes: "Each database has a reference file in references/ with endpoint details, query formats, and example calls. Read the relevant file(s) before making API calls" and an "Available Databases" section with a Reference File column mapping all ten databases to their files (references/pubmed.md, references/arxiv.md, etc.) — all ten verified to exist on disk, one level deep, with spot-check confirming they contain executable endpoint examples. The split is appropriate: orchestration in SKILL.md, endpoint detail in references. Matches anchor 5 (clear overview with well-signaled one-level-deep references, easy navigation); not 4: no inlined content that belongs in a reference file and no navigation gaps. | 5 / 5 |
Total | 18 / 20 Passed |