Literature Review
Overview
Conduct systematic, comprehensive literature reviews following rigorous academic methodology. Search or organize literature when synthesis is the deliverable, then synthesize findings thematically and identify research gaps. Use citation-verification for final claim-support verdicts and citation-management for bibliography/BibTeX hygiene.
This skill integrates with multiple scientific skills for database access (gget, bioservices, datacommons-client) and provides specialized tools for citation verification, result aggregation, and document generation.
This is not the fast lookup tool for "find a few recent papers," and it is not the bibliography cleanup tool. Use research-lookup for current paper discovery, citation-verification for DOI/PMID existence or sentence-level support checks, citation-management for BibTeX/metadata cleanup, and pyzotero for Zotero collection operations.
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
- Creating a single-paper deep reading card, evidence card, method map, or paper card
- Extracting a claim-evidence chain, method map, limitations, and research ideas from one supplied paper/PDF/arXiv/DOI
Do not use this skill when the user only asks to find a small set of recent papers, check whether one DOI/PMID is real, decide whether a citation supports one sentence, clean a .bib file, or organize a Zotero library. Route those tasks to research-lookup, citation-verification, citation-management, or pyzotero respectively.
Single-Paper Deep Reading Card
Use this sub-workflow when the user asks to deeply read one difficult paper, build a paper card, reconstruct a method map, analyze one PDF/arXiv/DOI, map an experiment-to-claim chain, or extract research ideas from a single source. Do not use it for full bilingual translation, formal peer review, or batch literature monitoring.
- Establish the source boundary first: full paper with figures/tables, text without layout, abstract-only metadata, or user-provided excerpt. If the source is partial, label unsupported sections as
Not assessable from supplied material.
- Build an evidence inventory before analysis: bibliographic metadata, research question, claimed contribution, method components, assumptions, main figures/tables/equations, experiments, baselines, metrics, reported results, and author-stated limitations.
- Build a claim-evidence matrix linking each central claim to a stable pointer such as page, section, figure, table, equation, paragraph/block id, DOI/arXiv metadata, or user excerpt. Do not invent page numbers when extraction is unreliable.
- Reconstruct the paper's argument as: problem -> prior limitation -> core insight -> design choice -> required evidence -> supplied experiment or analysis -> bounded conclusion.
- Keep author-acknowledged limitations separate from agent analysis. Author limitations contain only what the source states; agent analysis contains alternative explanations, missing controls, failure cases, and validation ideas.
- Produce a concise paper card with these sections when useful: basic information, one-sentence summary, research question, background path, pain points, core idea, method overview, module breakdown, essential formulas, experiment evidence chain, bounded conclusions, author limitations, critical analysis, knowledge learned, connections to existing work, and candidate research ideas.
- Label external context explicitly as
paper-only, targeted external check, or externally verified. Do not present the paper's own related-work framing as independently verified field history.
- Treat generated research ideas as hypotheses. For each idea, include originating limitation or observation, core hypothesis, delta from the paper, initial method, validation plan, failure modes, and novelty status (
unverified, partially checked, or prior-art checked).
Source distilled from Yuan1z0825/nature-skills nature-paper-card at 1562ab71e5ae; see docs/provenance/RESEARCH_SKILL_REPOS_2026_07_28.md.
Visual and Diagram Routing
Do not add diagrams unconditionally. Use a visual only when it helps the requested literature deliverable: PRISMA/search-flow diagrams for systematic reviews, method maps for single-paper deep reading, thematic synthesis maps, citation networks, research-gap maps, or presentation-ready summaries.
Route visual work to markdown-mermaid-writing for text-first diagrams, scientific-visualization for data-driven plots, scientific-schematics for publication-style conceptual figures, and presentation skills for decks or journal-club materials. A summary-only request can remain text-only.
Core Workflow
Literature reviews follow a structured, multi-phase workflow:
Phase 1: Planning and Scoping
Define Research Question: Use PICO framework (Population, Intervention, Comparison, Outcome) for clinical/biomedical reviews
- Example: "What is the efficacy of CRISPR-Cas9 (I) for treating sickle cell disease (P) compared to standard care (C)?"
Establish Scope and Objectives:
- Define clear, specific research questions
- Determine review type (narrative, systematic, scoping, meta-analysis)
- Set boundaries (time period, geographic scope, study types)
Develop Search Strategy:
- Identify 2-4 main concepts from research question
- List synonyms, abbreviations, and related terms for each concept
- Plan Boolean operators (AND, OR, NOT) to combine terms
- Select minimum 3 complementary databases
Set Inclusion/Exclusion Criteria:
- Date range (e.g., last 10 years: 2015-2024)
- Language (typically English, or specify multilingual)
- Publication types (peer-reviewed, preprints, reviews)
- Study designs (RCTs, observational, in vitro, etc.)
- Document all criteria clearly
Phase 2: Systematic Literature Search
Multi-Database Search:
Select databases appropriate for the domain:
Biomedical & Life Sciences:
- Use
gget skill: gget search pubmed "search terms" for PubMed/PMC
- Use
gget skill: gget search biorxiv "search terms" for preprints
- Use
bioservices skill for ChEMBL, KEGG, UniProt, etc.
General Scientific Literature:
- Search arXiv via direct API (preprints in physics, math, CS, q-bio)
- Search Semantic Scholar via API (200M+ papers, cross-disciplinary)
- Use Google Scholar for comprehensive coverage (manual or careful scraping)
Specialized Databases:
- Use
gget alphafold for protein structures
- Use
gget cosmic for cancer genomics
- Use
datacommons-client for demographic/statistical data
- Use specialized databases as appropriate for the domain
Document Search Parameters:
## Search Strategy
### Database: PubMed
- **Date searched**: 2024-10-25
- **Date range**: 2015-01-01 to 2024-10-25
- **Search string**:
("CRISPR"[Title] OR "Cas9"[Title])
AND ("sickle cell"[MeSH] OR "SCD"[Title/Abstract])
AND 2015:2024[Publication Date]
- **Results**: 247 articles
Repeat for each database searched.
Export and Aggregate Results:
Phase 3: Screening and Selection
Deduplication:
python search_databases.py results.json --deduplicate --output unique_results.json
- Removes duplicates by DOI (primary) or title (fallback)
- Document number of duplicates removed
Title Screening:
- Review all titles against inclusion/exclusion criteria
- Exclude obviously irrelevant studies
- Document number excluded at this stage
Abstract Screening:
- Read abstracts of remaining studies
- Apply inclusion/exclusion criteria rigorously
- Document reasons for exclusion
Full-Text Screening:
- Obtain full texts of remaining studies
- Conduct detailed review against all criteria
- Document specific reasons for exclusion
- Record final number of included studies
Create PRISMA Flow Diagram:
Initial search: n = X
├─ After deduplication: n = Y
├─ After title screening: n = Z
├─ After abstract screening: n = A
└─ Included in review: n = B
Phase 4: Data Extraction and Quality Assessment
Extract Key Data from each included study:
- Study metadata (authors, year, journal, DOI)
- Study design and methods
- Sample size and population characteristics
- Key findings and results
- Limitations noted by authors
- Funding sources and conflicts of interest
Assess Study Quality:
- For RCTs: Use Cochrane Risk of Bias tool
- For observational studies: Use Newcastle-Ottawa Scale
- For systematic reviews: Use AMSTAR 2
- Rate each study: High, Moderate, Low, or Very Low quality
- Consider excluding very low-quality studies
Organize by Themes:
- Identify 3-5 major themes across studies
- Group studies by theme (studies may appear in multiple themes)
- Note patterns, consensus, and controversies
Phase 5: Synthesis and Analysis
Create Review Document from template:
cp assets/review_template.md my_literature_review.md
Write Thematic Synthesis (NOT study-by-study summaries):
- Organize Results section by themes or research questions
- Synthesize findings across multiple studies within each theme
- Compare and contrast different approaches and results
- Identify consensus areas and points of controversy
- Highlight the strongest evidence
Example structure:
#### 3.3.1 Theme: CRISPR Delivery Methods
Multiple delivery approaches have been investigated for therapeutic
gene editing. Viral vectors (AAV) were used in 15 studies^1-15^ and
showed high transduction efficiency (65-85%) but raised immunogenicity
concerns^3,7,12^. In contrast, lipid nanoparticles demonstrated lower
efficiency (40-60%) but improved safety profiles^16-23^.
Critical Analysis:
- Evaluate methodological strengths and limitations across studies
- Assess quality and consistency of evidence
- Identify knowledge gaps and methodological gaps
- Note areas requiring future research
Write Discussion:
- Interpret findings in broader context
- Discuss clinical, practical, or research implications
- Acknowledge limitations of the review itself
- Compare with previous reviews if applicable
- Propose specific future research directions
Phase 6: Citation Verification
CRITICAL: All citations must be verified for accuracy before final submission.
Verify All DOIs:
python scripts/verify_citations.py my_literature_review.md
This script:
- Extracts all DOIs from the document
- Verifies each DOI resolves correctly
- Retrieves metadata from CrossRef
- Generates verification report
- Outputs properly formatted citations
Review Verification Report:
- Check for any failed DOIs
- Verify author names, titles, and publication details match
- Correct any errors in the original document
- Re-run verification until all citations pass
Format Citations Consistently:
- Choose one citation style and use throughout (see
references/citation_styles.md)
- Common styles: APA, Nature, Vancouver, Chicago, IEEE
- Use verification script output to format citations correctly
- Ensure in-text citations match reference list format
Phase 7: Document Generation
Generate PDF:
python scripts/generate_pdf.py my_literature_review.md \
--citation-style apa \
--output my_review.pdf
Options:
--citation-style: apa, nature, chicago, vancouver, ieee
--no-toc: Disable table of contents
--no-numbers: Disable section numbering
--check-deps: Check if pandoc/xelatex are installed
Review Final Output:
- Check PDF formatting and layout
- Verify all sections are present
- Ensure citations render correctly
- Check that figures/tables appear properly
- Verify table of contents is accurate
Quality Checklist:
Database-Specific Search Guidance
PubMed / PubMed Central
Access via gget skill:
# Search PubMed
gget search pubmed "CRISPR gene editing" -l 100
# Search with filters
# Use PubMed Advanced Search Builder to construct complex queries
# Then execute via gget or direct Entrez API
Search tips:
- Use MeSH terms:
"sickle cell disease"[MeSH]
- Field tags:
[Title], [Title/Abstract], [Author]
- Date filters:
2020:2024[Publication Date]
- Boolean operators: AND, OR, NOT
- See MeSH browser: https://meshb.nlm.nih.gov/search
bioRxiv / medRxiv
Access via gget skill:
gget search biorxiv "CRISPR sickle cell" -l 50
Important considerations:
- Preprints are not peer-reviewed
- Verify findings with caution
- Check if preprint has been published (CrossRef)
- Note preprint version and date
arXiv
Access via direct API or WebFetch:
# Example search categories:
# q-bio.QM (Quantitative Methods)
# q-bio.GN (Genomics)
# q-bio.MN (Molecular Networks)
# cs.LG (Machine Learning)
# stat.ML (Machine Learning Statistics)
# Search format: category AND terms
search_query = "cat:q-bio.QM AND ti:\"single cell sequencing\""
Semantic Scholar
Access via direct API (requires API key, or use free tier):
- 200M+ papers across all fields
- Excellent for cross-disciplinary searches
- Provides citation graphs and paper recommendations
- Use for finding highly influential papers
Specialized Biomedical Databases
Use appropriate skills:
- ChEMBL:
bioservices skill for chemical bioactivity
- UniProt:
gget or bioservices skill for protein information
- KEGG:
bioservices skill for pathways and genes
- COSMIC:
gget skill for cancer mutations
- AlphaFold:
gget alphafold for protein structures
- PDB:
gget or direct API for experimental structures
Citation Chaining
Expand search via citation networks:
Forward citations (papers citing key papers):
- Use Google Scholar "Cited by"
- Use Semantic Scholar or OpenAlex APIs
- Identifies newer research building on seminal work
Backward citations (references from key papers):
- Extract references from included papers
- Identify highly cited foundational work
- Find papers cited by multiple included studies
Citation Style Guide
Detailed formatting guidelines are in references/citation_styles.md. Quick reference:
APA (7th Edition)
- In-text: (Smith et al., 2023)
- Reference: Smith, J. D., Johnson, M. L., & Williams, K. R. (2023). Title. Journal, 22(4), 301-318. https://doi.org/10.xxx/yyy
Nature
- In-text: Superscript numbers^1,2^
- Reference: Smith, J. D., Johnson, M. L. & Williams, K. R. Title. Nat. Rev. Drug Discov. 22, 301-318 (2023).
Vancouver
- In-text: Superscript numbers^1,2^
- Reference: Smith JD, Johnson ML, Williams KR. Title. Nat Rev Drug Discov. 2023;22(4):301-18.
Always verify citations with verify_citations.py before finalizing.
Prioritizing High-Impact Papers (CRITICAL)
Always prioritize influential, highly-cited papers from reputable authors and top venues. Quality matters more than quantity in literature reviews.
Citation Count Thresholds
Use citation counts to identify the most impactful papers:
| Paper Age |
Citation Threshold |
Classification |
| 0-3 years |
20+ citations |
Noteworthy |
| 0-3 years |
100+ citations |
Highly Influential |
| 3-7 years |
100+ citations |
Significant |
| 3-7 years |
500+ citations |
Landmark Paper |
| 7+ years |
500+ citations |
Seminal Work |
| 7+ years |
1000+ citations |
Foundational |
Journal and Venue Tiers
Prioritize papers from higher-tier venues:
- Tier 1 (Always Prefer): Nature, Science, Cell, NEJM, Lancet, JAMA, PNAS, Nature Medicine, Nature Biotechnology
- Tier 2 (Strong Preference): High-impact specialized journals (IF>10), top conferences (NeurIPS, ICML for ML/AI)
- Tier 3 (Include When Relevant): Respected specialized journals (IF 5-10)
- Tier 4 (Use Sparingly): Lower-impact peer-reviewed venues
Author Reputation Assessment
Prefer papers from:
- Senior researchers with high h-index (>40 in established fields)
- Leading research groups at recognized institutions (Harvard, Stanford, MIT, Oxford, etc.)
- Authors with multiple Tier-1 publications in the relevant field
- Researchers with recognized expertise (awards, editorial positions, society fellows)
Identifying Seminal Papers
For any topic, identify foundational work by:
- High citation count (typically 500+ for papers 5+ years old)
- Frequently cited by other included studies (appears in many reference lists)
- Published in Tier-1 venues (Nature, Science, Cell family)
- Written by field pioneers (often cited as establishing concepts)
Best Practices
Search Strategy
- Use multiple databases (minimum 3): Ensures comprehensive coverage
- Include preprint servers: Captures latest unpublished findings
- Document everything: Search strings, dates, result counts for reproducibility
- 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 multiple databases (minimum 3): Ensures comprehensive coverage
- Include preprint servers: Captures latest unpublished findings
- Document everything: Search strings, dates, result counts for reproducibility
- Test and refine: Run pilot searches, review results, adjust search terms
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: Misses relevant papers; always search multiple databases
- 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
- Ignoring preprints: Misses latest findings; include bioRxiv, medRxiv, arXiv
- 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
Example Workflow
Complete workflow for a biomedical literature review:
# 1. Create review document from template
cp assets/review_template.md crispr_sickle_cell_review.md
# 2. Search multiple databases using appropriate skills
# - Use gget skill for PubMed, bioRxiv
# - Use direct API access for arXiv, Semantic Scholar
# - Export results in JSON format
# 3. Aggregate and process results
python scripts/search_databases.py combined_results.json \
--deduplicate \
--rank citations \
--year-start 2015 \
--year-end 2024 \
--format markdown \
--output search_results.md \
--summary
# 4. Screen results and extract data
# - Manually screen titles, abstracts, full texts
# - Extract key data into the review document
# - Organize by themes
# 5. Write the review following template structure
# - Introduction with clear objectives
# - Detailed methodology section
# - Results organized thematically
# - Critical discussion
# - Clear conclusions
# 6. Verify all citations
python scripts/verify_citations.py crispr_sickle_cell_review.md
# Review the citation report
cat crispr_sickle_cell_review_citation_report.json
# Fix any failed citations and re-verify
python scripts/verify_citations.py crispr_sickle_cell_review.md
# 7. Generate professional PDF
python scripts/generate_pdf.py crispr_sickle_cell_review.md \
--citation-style nature \
--output crispr_sickle_cell_review.pdf
# 8. Review final PDF and markdown outputs
Integration with Other Skills
This skill works seamlessly with other scientific skills:
Database Access Skills
- gget: PubMed, bioRxiv, COSMIC, AlphaFold, Ensembl, UniProt
- bioservices: ChEMBL, KEGG, Reactome, UniProt, PubChem
- datacommons-client: Demographics, economics, health statistics
Analysis Skills
- pydeseq2: RNA-seq differential expression (for methods sections)
- scanpy: Single-cell analysis (for methods sections)
- anndata: Single-cell data (for methods sections)
- biopython: Sequence analysis (for background sections)
Visualization Skills
- matplotlib: Generate figures and plots for review
- seaborn: Statistical visualizations
Writing Skills
- brand-guidelines: Apply institutional branding to PDF
- internal-comms: Adapt review for different audiences
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
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
- Multi-database integration via existing scientific skills
- 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: Synthesize scholarly literature and create single-paper evidence cards. Use for systematic/scoping/narrative reviews, related work, paper精读, paper cards, claim-evidence extraction, method maps, thematic synthesis, and research-gap analysis. Route quick lookup, DOI/claim checks, BibTeX, and Zotero to citation skills.4license: MIT license5---6# Literature Review78## Overview910Conduct systematic, comprehensive literature reviews following rigorous academic methodology. Search or organize literature when synthesis is the deliverable, then synthesize findings thematically and identify research gaps. Use `citation-verification` for final claim-support verdicts and `citation-management` for bibliography/BibTeX hygiene.1112This skill integrates with multiple scientific skills for database access (gget, bioservices, datacommons-client) and provides specialized tools for citation verification, result aggregation, and document generation.1314This is not the fast lookup tool for "find a few recent papers," and it is not the bibliography cleanup tool. Use `research-lookup` for current paper discovery, `citation-verification` for DOI/PMID existence or sentence-level support checks, `citation-management` for BibTeX/metadata cleanup, and `pyzotero` for Zotero collection operations.1516## When to Use This Skill1718Use this skill when:19- Conducting a systematic literature review for research or publication20- Synthesizing current knowledge on a specific topic across multiple sources21- Performing meta-analysis or scoping reviews22- Writing the literature review section of a research paper or thesis23- Investigating the state of the art in a research domain24- Identifying research gaps and future directions25- Requiring verified citations and professional formatting26- Creating a single-paper deep reading card, evidence card, method map, or paper card27- Extracting a claim-evidence chain, method map, limitations, and research ideas from one supplied paper/PDF/arXiv/DOI2829Do not use this skill when the user only asks to find a small set of recent papers, check whether one DOI/PMID is real, decide whether a citation supports one sentence, clean a `.bib` file, or organize a Zotero library. Route those tasks to `research-lookup`, `citation-verification`, `citation-management`, or `pyzotero` respectively.303132## Single-Paper Deep Reading Card3334Use this sub-workflow when the user asks to deeply read one difficult paper, build a paper card, reconstruct a method map, analyze one PDF/arXiv/DOI, map an experiment-to-claim chain, or extract research ideas from a single source. Do not use it for full bilingual translation, formal peer review, or batch literature monitoring.35361. Establish the source boundary first: full paper with figures/tables, text without layout, abstract-only metadata, or user-provided excerpt. If the source is partial, label unsupported sections as `Not assessable from supplied material`.372. Build an evidence inventory before analysis: bibliographic metadata, research question, claimed contribution, method components, assumptions, main figures/tables/equations, experiments, baselines, metrics, reported results, and author-stated limitations.383. Build a claim-evidence matrix linking each central claim to a stable pointer such as page, section, figure, table, equation, paragraph/block id, DOI/arXiv metadata, or user excerpt. Do not invent page numbers when extraction is unreliable.394. Reconstruct the paper's argument as: problem -> prior limitation -> core insight -> design choice -> required evidence -> supplied experiment or analysis -> bounded conclusion.405. Keep author-acknowledged limitations separate from agent analysis. Author limitations contain only what the source states; agent analysis contains alternative explanations, missing controls, failure cases, and validation ideas.416. Produce a concise paper card with these sections when useful: basic information, one-sentence summary, research question, background path, pain points, core idea, method overview, module breakdown, essential formulas, experiment evidence chain, bounded conclusions, author limitations, critical analysis, knowledge learned, connections to existing work, and candidate research ideas.427. Label external context explicitly as `paper-only`, `targeted external check`, or `externally verified`. Do not present the paper's own related-work framing as independently verified field history.438. Treat generated research ideas as hypotheses. For each idea, include originating limitation or observation, core hypothesis, delta from the paper, initial method, validation plan, failure modes, and novelty status (`unverified`, `partially checked`, or `prior-art checked`).4445Source distilled from `Yuan1z0825/nature-skills` `nature-paper-card` at `1562ab71e5ae`; see `docs/provenance/RESEARCH_SKILL_REPOS_2026_07_28.md`.4647## Visual and Diagram Routing4849Do not add diagrams unconditionally. Use a visual only when it helps the requested literature deliverable: PRISMA/search-flow diagrams for systematic reviews, method maps for single-paper deep reading, thematic synthesis maps, citation networks, research-gap maps, or presentation-ready summaries.5051Route visual work to `markdown-mermaid-writing` for text-first diagrams, `scientific-visualization` for data-driven plots, `scientific-schematics` for publication-style conceptual figures, and presentation skills for decks or journal-club materials. A summary-only request can remain text-only.5253---5455## Core Workflow5657Literature reviews follow a structured, multi-phase workflow:5859### Phase 1: Planning and Scoping60611. **Define Research Question**: Use PICO framework (Population, Intervention, Comparison, Outcome) for clinical/biomedical reviews62 - Example: "What is the efficacy of CRISPR-Cas9 (I) for treating sickle cell disease (P) compared to standard care (C)?"63642. **Establish Scope and Objectives**:65 - Define clear, specific research questions66 - Determine review type (narrative, systematic, scoping, meta-analysis)67 - Set boundaries (time period, geographic scope, study types)68693. **Develop Search Strategy**:70 - Identify 2-4 main concepts from research question71 - List synonyms, abbreviations, and related terms for each concept72 - Plan Boolean operators (AND, OR, NOT) to combine terms73 - Select minimum 3 complementary databases74754. **Set Inclusion/Exclusion Criteria**:76 - Date range (e.g., last 10 years: 2015-2024)77 - Language (typically English, or specify multilingual)78 - Publication types (peer-reviewed, preprints, reviews)79 - Study designs (RCTs, observational, in vitro, etc.)80 - Document all criteria clearly8182### Phase 2: Systematic Literature Search83841. **Multi-Database Search**:8586 Select databases appropriate for the domain:8788 **Biomedical & Life Sciences:**89 - Use `gget` skill: `gget search pubmed "search terms"` for PubMed/PMC90 - Use `gget` skill: `gget search biorxiv "search terms"` for preprints91 - Use `bioservices` skill for ChEMBL, KEGG, UniProt, etc.9293 **General Scientific Literature:**94 - Search arXiv via direct API (preprints in physics, math, CS, q-bio)95 - Search Semantic Scholar via API (200M+ papers, cross-disciplinary)96 - Use Google Scholar for comprehensive coverage (manual or careful scraping)9798 **Specialized Databases:**99 - Use `gget alphafold` for protein structures100 - Use `gget cosmic` for cancer genomics101 - Use `datacommons-client` for demographic/statistical data102 - Use specialized databases as appropriate for the domain1031042. **Document Search Parameters**:105 ```markdown106 ## Search Strategy107108 ### Database: PubMed109 - **Date searched**: 2024-10-25110 - **Date range**: 2015-01-01 to 2024-10-25111 - **Search string**:112 ```113 ("CRISPR"[Title] OR "Cas9"[Title])114 AND ("sickle cell"[MeSH] OR "SCD"[Title/Abstract])115 AND 2015:2024[Publication Date]116 ```117 - **Results**: 247 articles118 ```119120 Repeat for each database searched.1211223. **Export and Aggregate Results**:123 - Export results in JSON format from each database124 - Combine all results into a single file125 - Use `scripts/search_databases.py` for post-processing:126 ```bash127 python search_databases.py combined_results.json \128 --deduplicate \129 --format markdown \130 --output aggregated_results.md131 ```132133### Phase 3: Screening and Selection1341351. **Deduplication**:136 ```bash137 python search_databases.py results.json --deduplicate --output unique_results.json138 ```139 - Removes duplicates by DOI (primary) or title (fallback)140 - Document number of duplicates removed1411422. **Title Screening**:143 - Review all titles against inclusion/exclusion criteria144 - Exclude obviously irrelevant studies145 - Document number excluded at this stage1461473. **Abstract Screening**:148 - Read abstracts of remaining studies149 - Apply inclusion/exclusion criteria rigorously150 - Document reasons for exclusion1511524. **Full-Text Screening**:153 - Obtain full texts of remaining studies154 - Conduct detailed review against all criteria155 - Document specific reasons for exclusion156 - Record final number of included studies1571585. **Create PRISMA Flow Diagram**:159 ```160 Initial search: n = X161 ├─ After deduplication: n = Y162 ├─ After title screening: n = Z163 ├─ After abstract screening: n = A164 └─ Included in review: n = B165 ```166167### Phase 4: Data Extraction and Quality Assessment1681691. **Extract Key Data** from each included study:170 - Study metadata (authors, year, journal, DOI)171 - Study design and methods172 - Sample size and population characteristics173 - Key findings and results174 - Limitations noted by authors175 - Funding sources and conflicts of interest1761772. **Assess Study Quality**:178 - **For RCTs**: Use Cochrane Risk of Bias tool179 - **For observational studies**: Use Newcastle-Ottawa Scale180 - **For systematic reviews**: Use AMSTAR 2181 - Rate each study: High, Moderate, Low, or Very Low quality182 - Consider excluding very low-quality studies1831843. **Organize by Themes**:185 - Identify 3-5 major themes across studies186 - Group studies by theme (studies may appear in multiple themes)187 - Note patterns, consensus, and controversies188189### Phase 5: Synthesis and Analysis1901911. **Create Review Document** from template:192 ```bash193 cp assets/review_template.md my_literature_review.md194 ```1951962. **Write Thematic Synthesis** (NOT study-by-study summaries):197 - Organize Results section by themes or research questions198 - Synthesize findings across multiple studies within each theme199 - Compare and contrast different approaches and results200 - Identify consensus areas and points of controversy201 - Highlight the strongest evidence202203 Example structure:204 ```markdown205 #### 3.3.1 Theme: CRISPR Delivery Methods206207 Multiple delivery approaches have been investigated for therapeutic208 gene editing. Viral vectors (AAV) were used in 15 studies^1-15^ and209 showed high transduction efficiency (65-85%) but raised immunogenicity210 concerns^3,7,12^. In contrast, lipid nanoparticles demonstrated lower211 efficiency (40-60%) but improved safety profiles^16-23^.212 ```2132143. **Critical Analysis**:215 - Evaluate methodological strengths and limitations across studies216 - Assess quality and consistency of evidence217 - Identify knowledge gaps and methodological gaps218 - Note areas requiring future research2192204. **Write Discussion**:221 - Interpret findings in broader context222 - Discuss clinical, practical, or research implications223 - Acknowledge limitations of the review itself224 - Compare with previous reviews if applicable225 - Propose specific future research directions226227### Phase 6: Citation Verification228229**CRITICAL**: All citations must be verified for accuracy before final submission.2302311. **Verify All DOIs**:232 ```bash233 python scripts/verify_citations.py my_literature_review.md234 ```235236 This script:237 - Extracts all DOIs from the document238 - Verifies each DOI resolves correctly239 - Retrieves metadata from CrossRef240 - Generates verification report241 - Outputs properly formatted citations2422432. **Review Verification Report**:244 - Check for any failed DOIs245 - Verify author names, titles, and publication details match246 - Correct any errors in the original document247 - Re-run verification until all citations pass2482493. **Format Citations Consistently**:250 - Choose one citation style and use throughout (see `references/citation_styles.md`)251 - Common styles: APA, Nature, Vancouver, Chicago, IEEE252 - Use verification script output to format citations correctly253 - Ensure in-text citations match reference list format254255### Phase 7: Document Generation2562571. **Generate PDF**:258 ```bash259 python scripts/generate_pdf.py my_literature_review.md \260 --citation-style apa \261 --output my_review.pdf262 ```263264 Options:265 - `--citation-style`: apa, nature, chicago, vancouver, ieee266 - `--no-toc`: Disable table of contents267 - `--no-numbers`: Disable section numbering268 - `--check-deps`: Check if pandoc/xelatex are installed2692702. **Review Final Output**:271 - Check PDF formatting and layout272 - Verify all sections are present273 - Ensure citations render correctly274 - Check that figures/tables appear properly275 - Verify table of contents is accurate2762773. **Quality Checklist**:278 - [ ] All DOIs verified with verify_citations.py279 - [ ] Citations formatted consistently280 - [ ] PRISMA flow diagram included (for systematic reviews)281 - [ ] Search methodology fully documented282 - [ ] Inclusion/exclusion criteria clearly stated283 - [ ] Results organized thematically (not study-by-study)284 - [ ] Quality assessment completed285 - [ ] Limitations acknowledged286 - [ ] References complete and accurate287 - [ ] PDF generates without errors288289## Database-Specific Search Guidance290291### PubMed / PubMed Central292293Access via `gget` skill:294```bash295# Search PubMed296gget search pubmed "CRISPR gene editing" -l 100297298# Search with filters299# Use PubMed Advanced Search Builder to construct complex queries300# Then execute via gget or direct Entrez API301```302303**Search tips**:304- Use MeSH terms: `"sickle cell disease"[MeSH]`305- Field tags: `[Title]`, `[Title/Abstract]`, `[Author]`306- Date filters: `2020:2024[Publication Date]`307- Boolean operators: AND, OR, NOT308- See MeSH browser: https://meshb.nlm.nih.gov/search309310### bioRxiv / medRxiv311312Access via `gget` skill:313```bash314gget search biorxiv "CRISPR sickle cell" -l 50315```316317**Important considerations**:318- Preprints are not peer-reviewed319- Verify findings with caution320- Check if preprint has been published (CrossRef)321- Note preprint version and date322323### arXiv324325Access via direct API or WebFetch:326```python327# Example search categories:328# q-bio.QM (Quantitative Methods)329# q-bio.GN (Genomics)330# q-bio.MN (Molecular Networks)331# cs.LG (Machine Learning)332# stat.ML (Machine Learning Statistics)333334# Search format: category AND terms335search_query = "cat:q-bio.QM AND ti:\"single cell sequencing\""336```337338### Semantic Scholar339340Access via direct API (requires API key, or use free tier):341- 200M+ papers across all fields342- Excellent for cross-disciplinary searches343- Provides citation graphs and paper recommendations344- Use for finding highly influential papers345346### Specialized Biomedical Databases347348Use appropriate skills:349- **ChEMBL**: `bioservices` skill for chemical bioactivity350- **UniProt**: `gget` or `bioservices` skill for protein information351- **KEGG**: `bioservices` skill for pathways and genes352- **COSMIC**: `gget` skill for cancer mutations353- **AlphaFold**: `gget alphafold` for protein structures354- **PDB**: `gget` or direct API for experimental structures355356### Citation Chaining357358Expand search via citation networks:3593601. **Forward citations** (papers citing key papers):361 - Use Google Scholar "Cited by"362 - Use Semantic Scholar or OpenAlex APIs363 - Identifies newer research building on seminal work3643652. **Backward citations** (references from key papers):366 - Extract references from included papers367 - Identify highly cited foundational work368 - Find papers cited by multiple included studies369370## Citation Style Guide371372Detailed formatting guidelines are in `references/citation_styles.md`. Quick reference:373374### APA (7th Edition)375- In-text: (Smith et al., 2023)376- Reference: Smith, J. D., Johnson, M. L., & Williams, K. R. (2023). Title. *Journal*, *22*(4), 301-318. https://doi.org/10.xxx/yyy377378### Nature379- In-text: Superscript numbers^1,2^380- Reference: Smith, J. D., Johnson, M. L. & Williams, K. R. Title. *Nat. Rev. Drug Discov.* **22**, 301-318 (2023).381382### Vancouver383- In-text: Superscript numbers^1,2^384- Reference: Smith JD, Johnson ML, Williams KR. Title. Nat Rev Drug Discov. 2023;22(4):301-18.385386**Always verify citations** with verify_citations.py before finalizing.387388### Prioritizing High-Impact Papers (CRITICAL)389390**Always prioritize influential, highly-cited papers from reputable authors and top venues.** Quality matters more than quantity in literature reviews.391392#### Citation Count Thresholds393394Use citation counts to identify the most impactful papers:395396| Paper Age | Citation Threshold | Classification |397|-----------|-------------------|----------------|398| 0-3 years | 20+ citations | Noteworthy |399| 0-3 years | 100+ citations | Highly Influential |400| 3-7 years | 100+ citations | Significant |401| 3-7 years | 500+ citations | Landmark Paper |402| 7+ years | 500+ citations | Seminal Work |403| 7+ years | 1000+ citations | Foundational |404405#### Journal and Venue Tiers406407Prioritize papers from higher-tier venues:408409- **Tier 1 (Always Prefer):** Nature, Science, Cell, NEJM, Lancet, JAMA, PNAS, Nature Medicine, Nature Biotechnology410- **Tier 2 (Strong Preference):** High-impact specialized journals (IF>10), top conferences (NeurIPS, ICML for ML/AI)411- **Tier 3 (Include When Relevant):** Respected specialized journals (IF 5-10)412- **Tier 4 (Use Sparingly):** Lower-impact peer-reviewed venues413414#### Author Reputation Assessment415416Prefer papers from:417- **Senior researchers** with high h-index (>40 in established fields)418- **Leading research groups** at recognized institutions (Harvard, Stanford, MIT, Oxford, etc.)419- **Authors with multiple Tier-1 publications** in the relevant field420- **Researchers with recognized expertise** (awards, editorial positions, society fellows)421422#### Identifying Seminal Papers423424For any topic, identify foundational work by:4251. **High citation count** (typically 500+ for papers 5+ years old)4262. **Frequently cited by other included studies** (appears in many reference lists)4273. **Published in Tier-1 venues** (Nature, Science, Cell family)4284. **Written by field pioneers** (often cited as establishing concepts)429430## Best Practices431432### Search Strategy4331. **Use multiple databases** (minimum 3): Ensures comprehensive coverage4342. **Include preprint servers**: Captures latest unpublished findings4353. **Document everything**: Search strings, dates, result counts for reproducibility4364. **Test and refine**: Run pilot searches, review results, adjust search terms4375. **Sort by citations**: When available, sort search results by citation count to surface influential work first438439### Screening and Selection4401. **Use multiple databases** (minimum 3): Ensures comprehensive coverage4412. **Include preprint servers**: Captures latest unpublished findings4423. **Document everything**: Search strings, dates, result counts for reproducibility4434. **Test and refine**: Run pilot searches, review results, adjust search terms444445### Screening and Selection4461. **Use clear criteria**: Document inclusion/exclusion criteria before screening4472. **Screen systematically**: Title → Abstract → Full text4483. **Document exclusions**: Record reasons for excluding studies4494. **Consider dual screening**: For systematic reviews, have two reviewers screen independently450451### Synthesis4521. **Organize thematically**: Group by themes, NOT by individual studies4532. **Synthesize across studies**: Compare, contrast, identify patterns4543. **Be critical**: Evaluate quality and consistency of evidence4554. **Identify gaps**: Note what's missing or understudied456457### Quality and Reproducibility4581. **Assess study quality**: Use appropriate quality assessment tools4592. **Verify all citations**: Run verify_citations.py script4603. **Document methodology**: Provide enough detail for others to reproduce4614. **Follow guidelines**: Use PRISMA for systematic reviews462463### Writing4641. **Be objective**: Present evidence fairly, acknowledge limitations4652. **Be systematic**: Follow structured template4663. **Be specific**: Include numbers, statistics, effect sizes where available4674. **Be clear**: Use clear headings, logical flow, thematic organization468469## Common Pitfalls to Avoid4704711. **Single database search**: Misses relevant papers; always search multiple databases4722. **No search documentation**: Makes review irreproducible; document all searches4733. **Study-by-study summary**: Lacks synthesis; organize thematically instead4744. **Unverified citations**: Leads to errors; always run verify_citations.py4755. **Too broad search**: Yields thousands of irrelevant results; refine with specific terms4766. **Too narrow search**: Misses relevant papers; include synonyms and related terms4777. **Ignoring preprints**: Misses latest findings; include bioRxiv, medRxiv, arXiv4788. **No quality assessment**: Treats all evidence equally; assess and report quality4799. **Publication bias**: Only positive results published; note potential bias48010. **Outdated search**: Field evolves rapidly; clearly state search date481482## Example Workflow483484Complete workflow for a biomedical literature review:485486```bash487# 1. Create review document from template488cp assets/review_template.md crispr_sickle_cell_review.md489490# 2. Search multiple databases using appropriate skills491# - Use gget skill for PubMed, bioRxiv492# - Use direct API access for arXiv, Semantic Scholar493# - Export results in JSON format494495# 3. Aggregate and process results496python scripts/search_databases.py combined_results.json \497 --deduplicate \498 --rank citations \499 --year-start 2015 \500 --year-end 2024 \501 --format markdown \502 --output search_results.md \503 --summary504505# 4. Screen results and extract data506# - Manually screen titles, abstracts, full texts507# - Extract key data into the review document508# - Organize by themes509510# 5. Write the review following template structure511# - Introduction with clear objectives512# - Detailed methodology section513# - Results organized thematically514# - Critical discussion515# - Clear conclusions516517# 6. Verify all citations518python scripts/verify_citations.py crispr_sickle_cell_review.md519520# Review the citation report521cat crispr_sickle_cell_review_citation_report.json522523# Fix any failed citations and re-verify524python scripts/verify_citations.py crispr_sickle_cell_review.md525526# 7. Generate professional PDF527python scripts/generate_pdf.py crispr_sickle_cell_review.md \528 --citation-style nature \529 --output crispr_sickle_cell_review.pdf530531# 8. Review final PDF and markdown outputs532```533534## Integration with Other Skills535536This skill works seamlessly with other scientific skills:537538### Database Access Skills539- **gget**: PubMed, bioRxiv, COSMIC, AlphaFold, Ensembl, UniProt540- **bioservices**: ChEMBL, KEGG, Reactome, UniProt, PubChem541- **datacommons-client**: Demographics, economics, health statistics542543### Analysis Skills544- **pydeseq2**: RNA-seq differential expression (for methods sections)545- **scanpy**: Single-cell analysis (for methods sections)546- **anndata**: Single-cell data (for methods sections)547- **biopython**: Sequence analysis (for background sections)548549### Visualization Skills550- **matplotlib**: Generate figures and plots for review551- **seaborn**: Statistical visualizations552553### Writing Skills554- **brand-guidelines**: Apply institutional branding to PDF555- **internal-comms**: Adapt review for different audiences556557## Resources558559### Bundled Resources560561**Scripts:**562- `scripts/verify_citations.py`: Verify DOIs and generate formatted citations563- `scripts/generate_pdf.py`: Convert markdown to professional PDF564- `scripts/search_databases.py`: Process, deduplicate, and format search results565566**References:**567- `references/citation_styles.md`: Detailed citation formatting guide (APA, Nature, Vancouver, Chicago, IEEE)568- `references/database_strategies.md`: Comprehensive database search strategies569570**Assets:**571- `assets/review_template.md`: Complete literature review template with all sections572573### External Resources574575**Guidelines:**576- PRISMA (Systematic Reviews): http://www.prisma-statement.org/577- Cochrane Handbook: https://training.cochrane.org/handbook578- AMSTAR 2 (Review Quality): https://amstar.ca/579580**Tools:**581- MeSH Browser: https://meshb.nlm.nih.gov/search582- PubMed Advanced Search: https://pubmed.ncbi.nlm.nih.gov/advanced/583- Boolean Search Guide: https://www.ncbi.nlm.nih.gov/books/NBK3827/584585**Citation Styles:**586- APA Style: https://apastyle.apa.org/587- Nature Portfolio: https://www.nature.com/nature-portfolio/editorial-policies/reporting-standards588- NLM/Vancouver: https://www.nlm.nih.gov/bsd/uniform_requirements.html589590## Dependencies591592### Required Python Packages593```bash594pip install requests # For citation verification595```596597### Required System Tools598```bash599# For PDF generation600brew install pandoc # macOS601apt-get install pandoc # Linux602603# For LaTeX (PDF generation)604brew install --cask mactex # macOS605apt-get install texlive-xetex # Linux606```607608Check dependencies:609```bash610python scripts/generate_pdf.py --check-deps611```612613## Summary614615This literature-review skill provides:6166171. **Systematic methodology** following academic best practices6182. **Multi-database integration** via existing scientific skills6193. **Citation verification** ensuring accuracy and credibility6204. **Professional output** in markdown and PDF formats6215. **Comprehensive guidance** covering the entire review process6226. **Quality assurance** with verification and validation tools6237. **Reproducibility** through detailed documentation requirements624625Conduct thorough, rigorous literature reviews that meet academic standards and provide comprehensive synthesis of current knowledge in any domain.