Content
88%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-engineered operational skill: executable commands for every backend, a validated five-step workflow with error-recovery loops, and a clean reference structure. Its main weaknesses are mild verbosity and contract-level detail (Chat/Perplexity API specifics) that would sit better in the existing references file than in SKILL.md.
Suggestions
Move the beta-Chat and Perplexity contract details (model lists, request field paths like choices[].message.annotations[].url_citation, Responses-API migration history) into references/api-contracts.md, leaving a one-line summary plus the executable command in SKILL.md.
Trim justificatory prose such as the verified_references definition paragraph and the citation-count age/field-bias caveat to single clauses; the reference-quality rules already carry the operative guidance.
Consolidate scattered version/date-sensitive statements (CLI 0.9.3 pins, the 2026-09-30 review date) into the reference file or a single 'compatibility' note so SKILL.md stays stable across CLI releases.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational — routing tables, copy-paste commands, flags, and failure handling — and assumes Claude's competence without explaining basics. Minor over-explanation could be trimmed: the beta-Chat/Responses-API migration history, the paragraph defining "verified_references", and inline API field paths (e.g., "choices[].message.annotations[].url_citation") are detail that belongs in the references file. This fits 'efficient; minor instances of over-explanation' rather than the every-token-earns-its-place top anchor, and is well above the 'several unnecessary explanations' level 2. | 4 / 5 |
Actionability | Every mode has a complete, copy-paste-ready bash command with realistic arguments (--academic, --target-references 60, --context-file, --packet-dir), plus a concrete JSON context example, setup commands, and specific CLI flags for each backend. Guidance covers the common cases and is fully executable, matching the top anchor. | 5 / 5 |
Workflow Clarity | The manuscript workflow is clearly sequenced (capture context → run pipeline → verify with Extract → review packet → use evidence) with explicit validation checkpoints: inspect coverage.json on shortfall, verify retraction/correction status at the publisher, preserve per-URL errors in the ledger, and a Failure handling section with recovery loops (auth errors, shortfall, timeouts, missing CLI). Batch isolation and per-query error envelopes satisfy the batch-operations validation concern. This matches the top anchor's sequence-plus-feedback-loops pattern. | 5 / 5 |
Progressive Disclosure | Structure is good: well-sectioned SKILL.md, both scripts invoked by path rather than inlined, and a single clearly-signaled one-level-deep reference ([reviewed API contracts](references/api-contracts.md), verified to exist and to link only outward to external docs). However, for a ~370-line skill only one reference file exists, and substantial contract detail (Chat model list, Perplexity request fields, API version history) is inlined in SKILL.md where the anchor for 5 expects content appropriately split across references. | 4 / 5 |
Total | 18 / 20 Passed |