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 body: every subcommand has executable examples with realistic IDs, and gotchas are surfaced as concrete BAD/GOOD pairs. The main deductions are the duplicated content between Mindset and Anti-Patterns, deferred error-handling guidance, and one broken bundle link (requirements.txt).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes Claude's competence (no explanations of what an API or DOI is), but the three Mindset points ("IDs over titles", "Author IDs, not names", "Rate limits apply without a key") restate three Anti-Patterns entries almost verbatim. Matches anchor 4 — efficient with minor trim opportunities; not 3 since there is no padding or explanation of known concepts. | 4 / 5 |
Actionability | Copy-paste-ready commands for all four subcommands with realistic identifiers ("--paper-id \"arXiv:2005.11401\"", "--author-id \"1741101\"", a real DOI), plus a working python3 one-liner for extracting author IDs. Matches the top anchor: fully executable and covering the common cases. | 5 / 5 |
Workflow Clarity | Five clearly sequenced steps (choose subcommand → setup → run → find author ID → present and hand off) with an explicit guard against batch exhaustion ("NEVER loop subcommands to exhaustion") and a user-confirmation checkpoint at handoff. Not 5: inline error handling (429 recovery, empty results) is absent and deferred wholly to the reference file; the destructive/batch cap does not apply since operations are read-only and the rate-limit guard is explicit. | 4 / 5 |
Progressive Disclosure | The overview keeps SKILL.md lean and correctly defers setup detail to references/setup-and-troubleshooting.md (verified present, one level deep) and the script source. Not 5: the References section links to [requirements.txt](requirements.txt), which does not exist in the bundle — a broken navigation path. | 4 / 5 |
Total | 17 / 20 Passed |