Literature Review
Overview
Conduct bounded literature reviews following an explicit protocol. Search appropriate scholarly databases, preserve the search and screening trail, synthesize findings without overstating coverage, and verify citations against the underlying records and texts.
Use paper-lookup for scholarly API retrieval, database-lookup for other documented public databases, and citation-management for metadata verification and bibliography output. General web search may supplement these routes when available, but it is never an undocumented substitute for a reproducible database strategy.
Researcher confirmation points
Before retrieval, obtain confirmation for any material choice the request has not already settled: review type, research question, date and language limits, databases, inclusion and exclusion criteria, grey literature or preprint treatment, and stopping rule. Before synthesis, confirm any consequential changes to the protocol and record them as deviations. The accountable researcher owns screening judgments and substantive conclusions.
When to Use This Skill
Use this skill when:
- Conducting a systematic literature review for research or publication
- Synthesizing current knowledge on a specific topic across multiple sources
- Performing meta-analysis or scoping reviews
- Writing the literature review section of a research paper or thesis
- Investigating the state of the art in a research domain
- Identifying research gaps and future directions
- Requiring verified citations and professional formatting
Optional visual artefacts
Add a figure only when it improves auditability or understanding. Use markdown-mermaid-writing for a versionable search or screening flow, and scientific-visualization for data-derived figures. A review is not incomplete merely because it has no decorative illustration.
Core Workflow
A literature review runs in seven phases, documented in full with commands and templates
in references/core_workflow.md:
- Planning and scoping — the question, inclusion and exclusion criteria, and scope.
- Systematic literature search — multi-database searching with recorded queries.
- Screening and selection — title/abstract then full-text screening with counts kept
for the PRISMA flow.
- Data extraction and quality assessment — structured extraction and risk-of-bias
or quality appraisal.
- Synthesis and analysis — thematic or quantitative synthesis across studies.
- Citation verification — every citation checked against the actual source.
- Document generation — assembling the review with a complete bibliography.
Record every search string and date as you go: a review that cannot reproduce its own
search is not systematic. Per-database search guidance and citation styles are in
references/search_and_citation.md, and a full worked
review is in references/example_workflow.md.
Best Practices
Search Strategy
- Start with the protocol: Choose databases because their coverage matches the question, not because an arbitrary minimum is required.
- Use complementary databases when needed: Record why each database earns its place and disclose known coverage gaps.
- Decide preprint treatment explicitly: Include or exclude them according to the protocol and label them clearly.
- Document everything: Preserve exact search strings, dates, filters, result counts, and exported records.
- Test and refine: Run pilot searches, review results, adjust search terms
- Sort by citations: When available, sort search results by citation count to surface influential work first
Screening and Selection
- Use clear criteria: Document inclusion/exclusion criteria before screening
- Screen systematically: Title → Abstract → Full text
- Document exclusions: Record reasons for excluding studies
- Consider dual screening: For systematic reviews, have two reviewers screen independently
Synthesis
- Organize thematically: Group by themes, NOT by individual studies
- Synthesize across studies: Compare, contrast, identify patterns
- Be critical: Evaluate quality and consistency of evidence
- Identify gaps: Note what's missing or understudied
Quality and Reproducibility
- Assess study quality: Use appropriate quality assessment tools
- Verify all citations: Run verify_citations.py script
- Document methodology: Provide enough detail for others to reproduce
- Follow guidelines: Use PRISMA for systematic reviews
Writing
- Be objective: Present evidence fairly, acknowledge limitations
- Be systematic: Follow structured template
- Be specific: Include numbers, statistics, effect sizes where available
- Be clear: Use clear headings, logical flow, thematic organization
Common Pitfalls to Avoid
- Single database search without a coverage rationale: May miss relevant papers; justify the selected database set
- No search documentation: Makes review irreproducible; document all searches
- Study-by-study summary: Lacks synthesis; organize thematically instead
- Unverified citations: Leads to errors; always run verify_citations.py
- Too broad search: Yields thousands of irrelevant results; refine with specific terms
- Too narrow search: Misses relevant papers; include synonyms and related terms
- Silent preprint policy: Decide whether preprints are eligible and label their status
- No quality assessment: Treats all evidence equally; assess and report quality
- Publication bias: Only positive results published; note potential bias
- Outdated search: Field evolves rapidly; clearly state search date
Integration with Other Skills
Use the smallest relevant set of neighboring core skills:
- paper-lookup: scholarly discovery, identifiers, citation graphs, and available full text.
- database-lookup: reproducible retrieval from documented public databases outside the paper index layer.
- citation-management: metadata validation, deduplication, and bibliography output.
- scientific-critical-thinking: claim and evidence-quality appraisal.
- statistical-analysis: only for an agreed quantitative synthesis plan.
- writing-skill: drafting after the evidence table and synthesis boundaries are stable.
Resources
Bundled Resources
Scripts:
scripts/verify_citations.py: Verify DOIs and generate formatted citations
scripts/generate_pdf.py: Convert markdown to professional PDF
scripts/search_databases.py: Process, deduplicate, and format search results
References:
references/citation_styles.md: Detailed citation formatting guide (APA, Nature, Vancouver, Chicago, IEEE)
references/database_strategies.md: Comprehensive database search strategies
Assets:
assets/review_template.md: Complete literature review template with all sections
External Resources
Guidelines:
Tools:
Citation Styles:
Dependencies
Required Python Packages
uv pip install requests # For citation verification
Required System Tools
# For PDF generation
brew install pandoc # macOS
apt-get install pandoc # Linux
# For LaTeX (PDF generation)
brew install --cask mactex # macOS
apt-get install texlive-xetex # Linux
Check dependencies:
python scripts/generate_pdf.py --check-deps
Summary
This literature-review skill provides:
- Systematic methodology following academic best practices
- Reproducible search routing through documented scholarly and public-database interfaces
- Explicit coverage boundaries rather than implied comprehensiveness
- Citation verification ensuring accuracy and credibility
- Professional output in markdown and PDF formats
- Comprehensive guidance covering the entire review process
- Quality assurance with verification and validation tools
- Reproducibility through detailed documentation requirements
Conduct thorough, rigorous literature reviews that meet academic standards and provide comprehensive synthesis of current knowledge in any domain.
1---2name: literature-review3description: Plan and conduct reproducible literature reviews with explicit search boundaries, documented screening decisions, structured evidence extraction, quality appraisal, synthesis, and verified citations. Use for systematic, scoping, rapid, or narrative reviews; use paper-lookup for a bounded paper search and writing-skill only after the evidence set is stable.4license: MIT5---67# Literature Review89## Overview1011Conduct bounded literature reviews following an explicit protocol. Search appropriate scholarly databases, preserve the search and screening trail, synthesize findings without overstating coverage, and verify citations against the underlying records and texts.1213Use `paper-lookup` for scholarly API retrieval, `database-lookup` for other documented public databases, and `citation-management` for metadata verification and bibliography output. General web search may supplement these routes when available, but it is never an undocumented substitute for a reproducible database strategy.1415## Researcher confirmation points1617Before retrieval, obtain confirmation for any material choice the request has not already settled: review type, research question, date and language limits, databases, inclusion and exclusion criteria, grey literature or preprint treatment, and stopping rule. Before synthesis, confirm any consequential changes to the protocol and record them as deviations. The accountable researcher owns screening judgments and substantive conclusions.1819## When to Use This Skill2021Use this skill when:22- Conducting a systematic literature review for research or publication23- Synthesizing current knowledge on a specific topic across multiple sources24- Performing meta-analysis or scoping reviews25- Writing the literature review section of a research paper or thesis26- Investigating the state of the art in a research domain27- Identifying research gaps and future directions28- Requiring verified citations and professional formatting2930## Optional visual artefacts3132Add a figure only when it improves auditability or understanding. Use `markdown-mermaid-writing` for a versionable search or screening flow, and `scientific-visualization` for data-derived figures. A review is not incomplete merely because it has no decorative illustration.3334---3536## Core Workflow3738A literature review runs in seven phases, documented in full with commands and templates39in [references/core_workflow.md](references/core_workflow.md):40411. **Planning and scoping** — the question, inclusion and exclusion criteria, and scope.422. **Systematic literature search** — multi-database searching with recorded queries.433. **Screening and selection** — title/abstract then full-text screening with counts kept44 for the PRISMA flow.454. **Data extraction and quality assessment** — structured extraction and risk-of-bias46 or quality appraisal.475. **Synthesis and analysis** — thematic or quantitative synthesis across studies.486. **Citation verification** — every citation checked against the actual source.497. **Document generation** — assembling the review with a complete bibliography.5051Record every search string and date as you go: a review that cannot reproduce its own52search is not systematic. Per-database search guidance and citation styles are in53[references/search_and_citation.md](references/search_and_citation.md), and a full worked54review is in [references/example_workflow.md](references/example_workflow.md).5556## Best Practices5758### Search Strategy591. **Start with the protocol**: Choose databases because their coverage matches the question, not because an arbitrary minimum is required.602. **Use complementary databases when needed**: Record why each database earns its place and disclose known coverage gaps.613. **Decide preprint treatment explicitly**: Include or exclude them according to the protocol and label them clearly.624. **Document everything**: Preserve exact search strings, dates, filters, result counts, and exported records.635. **Test and refine**: Run pilot searches, review results, adjust search terms646. **Sort by citations**: When available, sort search results by citation count to surface influential work first6566### Screening and Selection671. **Use clear criteria**: Document inclusion/exclusion criteria before screening682. **Screen systematically**: Title → Abstract → Full text693. **Document exclusions**: Record reasons for excluding studies704. **Consider dual screening**: For systematic reviews, have two reviewers screen independently7172### Synthesis731. **Organize thematically**: Group by themes, NOT by individual studies742. **Synthesize across studies**: Compare, contrast, identify patterns753. **Be critical**: Evaluate quality and consistency of evidence764. **Identify gaps**: Note what's missing or understudied7778### Quality and Reproducibility791. **Assess study quality**: Use appropriate quality assessment tools802. **Verify all citations**: Run verify_citations.py script813. **Document methodology**: Provide enough detail for others to reproduce824. **Follow guidelines**: Use PRISMA for systematic reviews8384### Writing851. **Be objective**: Present evidence fairly, acknowledge limitations862. **Be systematic**: Follow structured template873. **Be specific**: Include numbers, statistics, effect sizes where available884. **Be clear**: Use clear headings, logical flow, thematic organization8990## Common Pitfalls to Avoid91921. **Single database search without a coverage rationale**: May miss relevant papers; justify the selected database set932. **No search documentation**: Makes review irreproducible; document all searches943. **Study-by-study summary**: Lacks synthesis; organize thematically instead954. **Unverified citations**: Leads to errors; always run verify_citations.py965. **Too broad search**: Yields thousands of irrelevant results; refine with specific terms976. **Too narrow search**: Misses relevant papers; include synonyms and related terms987. **Silent preprint policy**: Decide whether preprints are eligible and label their status998. **No quality assessment**: Treats all evidence equally; assess and report quality1009. **Publication bias**: Only positive results published; note potential bias10110. **Outdated search**: Field evolves rapidly; clearly state search date102103## Integration with Other Skills104105Use the smallest relevant set of neighboring core skills:106107- **paper-lookup**: scholarly discovery, identifiers, citation graphs, and available full text.108- **database-lookup**: reproducible retrieval from documented public databases outside the paper index layer.109- **citation-management**: metadata validation, deduplication, and bibliography output.110- **scientific-critical-thinking**: claim and evidence-quality appraisal.111- **statistical-analysis**: only for an agreed quantitative synthesis plan.112- **writing-skill**: drafting after the evidence table and synthesis boundaries are stable.113114## Resources115116### Bundled Resources117118**Scripts:**119- `scripts/verify_citations.py`: Verify DOIs and generate formatted citations120- `scripts/generate_pdf.py`: Convert markdown to professional PDF121- `scripts/search_databases.py`: Process, deduplicate, and format search results122123**References:**124- `references/citation_styles.md`: Detailed citation formatting guide (APA, Nature, Vancouver, Chicago, IEEE)125- `references/database_strategies.md`: Comprehensive database search strategies126127**Assets:**128- `assets/review_template.md`: Complete literature review template with all sections129130### External Resources131132**Guidelines:**133- PRISMA (Systematic Reviews): http://www.prisma-statement.org/134- Cochrane Handbook: https://training.cochrane.org/handbook135- AMSTAR 2 (Review Quality): https://amstar.ca/136137**Tools:**138- MeSH Browser: https://meshb.nlm.nih.gov/search139- PubMed Advanced Search: https://pubmed.ncbi.nlm.nih.gov/advanced/140- Boolean Search Guide: https://www.ncbi.nlm.nih.gov/books/NBK3827/141142**Citation Styles:**143- APA Style: https://apastyle.apa.org/144- Nature Portfolio: https://www.nature.com/nature-portfolio/editorial-policies/reporting-standards145- NLM/Vancouver: https://www.nlm.nih.gov/bsd/uniform_requirements.html146147## Dependencies148149### Required Python Packages150```bash151uv pip install requests # For citation verification152```153154### Required System Tools155```bash156# For PDF generation157brew install pandoc # macOS158apt-get install pandoc # Linux159160# For LaTeX (PDF generation)161brew install --cask mactex # macOS162apt-get install texlive-xetex # Linux163```164165Check dependencies:166```bash167python scripts/generate_pdf.py --check-deps168```169170## Summary171172This literature-review skill provides:1731741. **Systematic methodology** following academic best practices1752. **Reproducible search routing** through documented scholarly and public-database interfaces1763. **Explicit coverage boundaries** rather than implied comprehensiveness1774. **Citation verification** ensuring accuracy and credibility1785. **Professional output** in markdown and PDF formats1796. **Comprehensive guidance** covering the entire review process1807. **Quality assurance** with verification and validation tools1818. **Reproducibility** through detailed documentation requirements182183Conduct thorough, rigorous literature reviews that meet academic standards and provide comprehensive synthesis of current knowledge in any domain.