Content
27%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a monolithic, repetitive reference that ignores its own bundled references and scripts and contradicts its stated canonical-source-first principle by repeatedly routing verification through Google Scholar. It is structured with clear sections and a concrete example, but fails on token efficiency and progressive disclosure.
Suggestions
Collapse the duplicated Verification Principles, Best Practices, Common Pitfalls, and Summary into a single concise section, dropping concepts Claude already knows (what citation errors are, consequences of retraction) to cut the body substantially.
Resolve the Google Scholar contradiction: either make canonical-source verification (DOI/arXiv/CrossRef/Semantic Scholar/Zotero) the actual workflow the example follows, or stop claiming Google Scholar is non-authoritative while instructing readers to copy BibTeX from it.
Turn SKILL.md into an overview that links to the bundle — e.g., point to references/verification-rules.md for the rule list, references/common-errors.md for pitfalls, and scripts/verify-citations.py for programmatic checking — instead of inlining all of that content.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~200-line body restates material Claude already knows ("Citation issues in academic papers seriously impact research integrity", "Paper rejection or retraction", "Damage to academic reputation") and repeats the same points across Verification Principles, Best Practices, Common Pitfalls, and Summary (e.g., the "40% error rate" claim appears twice), matching anchor 1 ("Verbose; explains concepts Claude knows; padded with unnecessary context"). | 1 / 3 |
Actionability | Concrete elements exist — the Transformer example with real queries ("Attention is All You Need Vaswani 2017") and explicit fields to match — but the guidance is incomplete: it never references the bundled scripts (verify-citations.py, api-clients.py, format-checker.py) that would be the most actionable tooling, and it contradicts itself on Google Scholar, fitting anchor 2 ("Some concrete guidance but incomplete... missing key details") rather than fully executable anchor 3. | 2 / 3 |
Workflow Clarity | A sequence exists (the flow diagram from "Need a citation" to "Add to bibliography") plus a failure-handling loop (try alternatives, mark `[CITATION NEEDED]`, notify user), but the stated workflow says to verify via canonical sources (CrossRef/arXiv/Semantic Scholar) while the worked example and Best Practices revert to Google Scholar, creating ambiguity about the actual decision logic per anchor 2 ("sequence present but checkpoints missing or implicit"). | 2 / 3 |
Progressive Disclosure | Eight bundle files exist (references/{verification-rules,common-errors,api-usage}.md and scripts/{verify-citations,api-clients,format-checker}.py plus READMEs), yet the body references none of them and instead inlines ~200 lines of verification rules, common errors, and workflow material, matching anchor 1 ("Monolithic wall of text... poor organization") rather than an overview that signals one-level-deep references. | 1 / 3 |
Total | 6 / 12 Passed |