Content
60%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 skill has a genuinely clear seven-phase workflow with real, well-organized bundle files and mostly concrete commands. Its main weakness is token efficiency: duplicated sections, a redundant summary, and long inline catalogs that belong in the references directory dilute an otherwise strong body.
Suggestions
Delete the duplicated first 'Screening and Selection' section (which repeats the Search Strategy items verbatim) and merge the overlapping 'How to generate figures' / 'How to generate schematics' subsections into one.
Cut the closing 'Summary' section and the 'The AI will automatically:' bullet list — both restate content already covered — and trim the mandatory-figures preamble to a single sentence plus the command.
Move the External Resources link dump and the Integration-with-Other-Skills catalog into a reference file (e.g., references/resources_and_integrations.md), keeping only the primary parallel-web and database-access entries inline.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body has several padded or duplicated sections: the 'Screening and Selection' heading appears twice and the first instance (lines 104-108) repeats the Search Strategy list verbatim; 'How to generate figures' and 'How to generate schematics' cover the same command; the closing 'Summary' section recaps every earlier section; and lines like 'This is not optional. Literature reviews without visual elements are incomplete' plus lists of tools Claude already knows (matplotlib, seaborn) add tokens without new information. This is noticeably verbose with several unnecessary sections (anchor 2), though not the pervasive concept-explanation padding of anchor 1. | 2 / 5 |
Actionability | Concrete executable commands appear throughout: 'python scripts/generate_schematic.py "your diagram description" -o figures/output.png', 'python scripts/verify_citations.py', 'python scripts/generate_pdf.py --check-deps', and install snippets for parallel-cli, uv, and pandoc/texlive. Minor gaps keep it below 5: no worked example of an actual 'parallel-cli search' invocation with arguments inline, and database-specific query commands are deferred to references rather than shown. | 4 / 5 |
Workflow Clarity | The seven-phase workflow is clearly sequenced with per-phase purposes and pointers to the full reference, and validation checkpoints are present ('Verify all citations: Run verify_citations.py', '--check-deps', 'Record every search string and date'). It is not a 5 because explicit fix-and-retry feedback loops (e.g., what to do when citation verification or dependency checks fail) are not described, and there is a literal copy-paste duplication of the Screening and Selection list that muddies that step. | 4 / 5 |
Progressive Disclosure | References are well signaled and all real: links to references/core_workflow.md, search_and_citation.md, and example_workflow.md in the workflow section, plus a Bundled Resources inventory whose files all exist on disk, one level deep with no nesting. It falls short of 5 because substantial content that belongs in reference files is inlined in SKILL.md (the full Best Practices lists, the Integration-with-Other-Skills catalog, and the External Resources link dump). | 4 / 5 |
Total | 14 / 20 Passed |