Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The skill body is highly actionable with executable scripts, clear sequenced phases, validation feedback loops, and well-organized one-level-deep bundle references. Its main weakness is conciseness: duplicated sections (Screening and Selection appears twice) and restated boilerplate about basic search methodology add tokens without new information.
Suggestions
Remove the duplicated '### Screening and Selection' block (lines 414-418 repeat the Search Strategy list verbatim) and the duplicate search-strategy bullets to eliminate redundancy.
Tighten the database-specific guidance by removing explanations of concepts Claude already knows (e.g., what Boolean operators are, that preprints are not peer-reviewed) and linking to references/database_strategies.md instead.
Consolidate the 'Best Practices' section with the corresponding phase descriptions to avoid re-stating the same methodology twice.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Largely actionable and well-structured, but the body repeats material verbatim — '### Screening and Selection' appears twice (lines 414-418 and 420-424) with identical content, and the 'Best Practices' search-strategy block duplicates Phase 1/2 guidance — adding tokens that restate what Claude already knows about Boolean operators and multi-database search. | 2 / 3 |
Actionability | Provides fully executable commands throughout: 'python scripts/search_databases.py combined_results.json --deduplicate', 'python scripts/verify_citations.py my_literature_review.md', 'cp assets/review_template.md my_literature_review.md', with concrete flags and a complete worked end-to-end example workflow. | 3 / 3 |
Workflow Clarity | A clearly sequenced seven-phase workflow with explicit validation checkpoints and a feedback loop — 'Re-run verification until all citations pass' (line 219), a PRISMA flow diagram, and a closing Quality Checklist (lines 249-259) that functions as a verification gate before submission. | 3 / 3 |
Progressive Disclosure | The body acts as an overview pointing one level deep to real, verified bundle files: scripts/verify_citations.py, scripts/generate_pdf.py, scripts/search_databases.py, references/citation_styles.md, references/database_strategies.md, and assets/review_template.md — all confirmed to exist and clearly signaled in the Resources section. | 3 / 3 |
Total | 11 / 12 Passed |