literature-review-planner — Claude Code skill: what it does
literature-review-planner plans an academic literature review: picks the review type, builds the search string, screens sources and lays out a PRISMA flow.
MIT 160 installs ★ 114 updated 2026-10-25
npx skills add travisjneuman/.claude --skill literature-review-planner -a claude-codeWhat literature-review-planner does
The skill is a set of tables and decision trees, not a search tool. A branching questionnaire narrows the review type (narrative, systematic, scoping, meta-analysis, rapid, umbrella, integrative) by asking whether the question is focused, whether effect sizes need pooling, and whether the timeline is under 3 months.
Search planning covers PICO and PEO, a database table running from PubMed and Scopus to IEEE Xplore, CINAHL and Cochrane Library, and a step-by-step recipe for combining concepts with OR and AND, truncation, MeSH terms and proximity operators. Each search gets logged with database, date, full string, filters and post-deduplication counts.
Screening rests on the PRISMA diagram plus an inclusion and exclusion table across population, design, date range and publication type. Appraisal is matched to design: RoB 2 for trials, Newcastle-Ottawa for cohort and case-control work, CASP, JBI, QUADAS-2, MMAT. The counts in the PRISMA boxes come from your search log, so open the log at the first query or the diagram gets rebuilt by hand later.
What it helps with
- pick a review type that matches the research question
- build a Boolean string from PICO concepts
- record databases, filters and hit counts in a search log
- fill the PRISMA boxes from screening numbers
- match a risk-of-bias tool to the study design
Example prompts for the agent
- Plan a systematic review on telemedicine for type 2 diabetes and draft the PubMed search string.
- Draft inclusion and exclusion criteria for a scoping review, plus a search log template.
- Which appraisal tool should I use for cohort studies?
How to install literature-review-planner
1Skills CLI (Vercel)
npx skills add travisjneuman/.claude --skill literature-review-planner -a claude-code2Manually: put the files in place
~/.claude/skills/literature-review-planner/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/literature-review-planner/
1Skills CLI (Vercel)
npx skills add travisjneuman/.claude --skill literature-review-planner -a codex2Manually: put the files in place
.agents/skills/literature-review-planner/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add travisjneuman/.claude --skill literature-review-planner -a cursor2Manually: put the files in place
.cursor/skills/literature-review-planner/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install travisjneuman/.claude skills/literature-review-planner2Manually: put the files in place
.github/skills/literature-review-planner/SKILL.md1Skills CLI (Vercel)
npx skills add travisjneuman/.claude --skill literature-review-planner -a gemini-cli2Platform CLI
gemini skills install https://github.com/travisjneuman/.claude --path skills/literature-review-plannerManually: put the files in place
.devin/skills/literature-review-planner/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add travisjneuman/.claude --skill literature-review-planner -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about literature-review-planner
How do I install literature-review-planner in Claude Code?
Run npx skills add travisjneuman/.claude --skill literature-review-planner -a claude-code. The skill file lands at ~/.claude/skills/literature-review-planner/SKILL.md.
What does literature-review-planner do?
It helps you plan a literature review: choose the review type, frame the question with PICO or PEO, assemble the search string and structure screening around PRISMA.
Systematic or scoping review — which one does the skill recommend?
A focused question answered with high methodological rigor points to a systematic review. Mapping the breadth of evidence in an emerging field points to a scoping review.
Source text
SKILL.md · MIT
---
name: literature-review-planner
description: Structured literature review planning with systematic methodology, source evaluation, and synthesis frameworks. Use when planning academic literature reviews, research surveys, systematic reviews, or scoping reviews.
---
# Literature Review Planner
Comprehensive frameworks for planning, conducting, and synthesizing literature reviews across academic and professional research contexts.
## Review Types
| Type | Purpose | Scope | Methodology Rigor | Best For |
|------|---------|-------|-------------------|----------|
| **Narrative** | Broad overview of a topic | Wide, flexible | Low-Medium | Background sections, introductions |
| **Systematic** | Answer a specific research question | Narrow, predefined | High | Evidence-based decisions, clinical practice |
| **Scoping** | Map available evidence on a topic | Wide, structured | Medium | Emerging fields, identifying gaps |
| **Meta-Analysis** | Quantitative synthesis of findings | Narrow, statistical | Highest | Combining effect sizes, treatment efficacy |
| **Rapid** | Timely evidence synthesis | Focused, abbreviated | Medium | Policy decisions, time-constrained contexts |
| **Umbrella** | Review of existing reviews | Reviews only | High | Overarching evidence synthesis |
| **Integrative** | Synthesize diverse methodologies | Wide, mixed methods | Medium | Combining qualitative and quantitative |
### Choosing the Right Review Type
```
Do you need to answer a specific, focused question?
YES --> Is quantitative synthesis of effect sizes needed?
YES --> Meta-Analysis
NO --> Systematic Review
NO --> Do you need to map the breadth of evidence?
YES --> Is the field well-established?
YES --> Umbrella Review (review of reviews)
NO --> Scoping Review
NO --> Do you need to combine qualitative and quantitative?
YES --> Integrative Review
NO --> Is time constrained (< 3 months)?
YES --> Rapid Review
NO --> Narrative Review
```
## Search Strategy Development
### PICO/PEO Framework
Use structured frameworks to define your research question:
| Framework | Element | Description | Example |
|-----------|---------|-------------|---------|
| **PICO** | Population | Who is being studied | Adults with Type 2 diabetes |
| | Intervention | What treatment/exposure | Telemedicine consultations |
| | Comparison | Alternative to intervention | In-person consultations |
| | Outcome | What is measured | HbA1c levels, patient satisfaction |
| **PEO** | Population | Who is being studied | Software engineering teams |
| | Exposure | Phenomenon of interest | Agile methodology adoption |
| | Outcome | What is measured | Productivity, code quality |
### Database Selection
| Database | Coverage | Best For |
|----------|----------|----------|
| **PubMed/MEDLINE** | Biomedical, life sciences | Clinical, medical, health research |
| **Scopus** | Multidisciplinary, broadest | Cross-disciplinary reviews |
| **Web of Science** | Multidisciplinary, citation data | Citation analysis, impact tracking |
| **IEEE Xplore** | Engineering, computer science | Technical and computing research |
| **PsycINFO** | Psychology, behavioral science | Mental health, cognition research |
| **ERIC** | Education | Teaching, learning, education policy |
| **CINAHL** | Nursing, allied health | Nursing and health professions |
| **Cochrane Library** | Systematic reviews, trials | Clinical intervention evidence |
| **Google Scholar** | Broad, grey literature | Supplementary searching, snowballing |
| **Preprint servers** | arXiv, bioRxiv, SSRN | Cutting-edge, unpublished work |
### Keyword and Boolean Strategy
```
BUILDING A SEARCH STRING:
Step 1: Identify key concepts from PICO/PEO
Concept 1: "telemedicine" OR "telehealth" OR "remote consultation" OR "virtual care"
Concept 2: "diabetes" OR "type 2 diabetes" OR "T2DM" OR "diabetes mellitus"
Concept 3: "glycemic control" OR "HbA1c" OR "blood glucose" OR "patient outcomes"
Step 2: Combine with Boolean operators
(Concept 1) AND (Concept 2) AND (Concept 3)
Step 3: Apply filters
- Date range: 2015-2025
- Language: English
- Study type: RCT, cohort, systematic review
- Peer-reviewed only
ADVANCED OPERATORS:
"exact phrase" - Exact match
* - Truncation (therap* = therapy, therapies, therapeutic)
MeSH terms - Controlled vocabulary (PubMed)
NEAR/3 - Proximity (terms within 3 words)
ti,ab - Title and abstract search
```
### Search Documentation Template
```
SEARCH LOG:
Database: [Name]
Date Searched: [Date]
Search String: [Full query]
Filters Applied: [Date, language, study type]
Results Retrieved: [Count]
Results After Deduplication: [Count]
Notes: [Any issues, modifications needed]
```
## PRISMA Flow Diagram
```
IDENTIFICATION
Records identified through database searching: n = ___
Records identified through other sources: n = ___
|
v
Records after duplicates removed: n = ___
|
SCREENING
v
Records screened (title/abstract): n = ___
Records excluded: n = ___
|
v
Full-text articles assessed for eligibility: n = ___
Full-text articles excluded (with reasons): n = ___
- Reason 1: n = ___
- Reason 2: n = ___
- Reason 3: n = ___
|
INCLUDED
v
Studies included in qualitative synthesis: n = ___
Studies included in quantitative synthesis (meta-analysis): n = ___
```
### Inclusion/Exclusion Criteria
| Criterion | Include | Exclude |
|-----------|---------|---------|
| **Population** | [Define target population] | [Define excluded populations] |
| **Intervention/Exposure** | [Define relevant interventions] | [Define excluded interventions] |
| **Outcome** | [Define relevant outcomes] | [Outcomes not of interest] |
| **Study Design** | [Accepted study types] | [Excluded study types] |
| **Date Range** | [Start year] to [End year] | Outside date range |
| **Language** | [Accepted languages] | Other languages |
| **Publication Type** | Peer-reviewed journals | Editorials, letters, conference abstracts |
## Source Evaluation
### Critical Appraisal Tools by Study Design
| Study Design | Appraisal Tool | Key Domains |
|-------------|---------------|-------------|
| **RCTs** | Cochrane Risk of Bias (RoB 2) | Randomization, blinding, attrition, reporting |
| **Cohort Studies** | Newcastle-Ottawa Scale (NOS) | Selection, comparability, outcome assessment |
| **Case-Control** | Newcastle-Ottawa Scale (NOS) | Selection, comparability, exposure assessment |
| **Qualitative** | CASP Qualitative Checklist | Aims, methodology, recruitment, data, analysis, ethics |
| **Cross-Sectional** | JBI Critical Appraisal | Inclusion, measurement, confounders, analysis |
| **Diagnostic** | QUADAS-2 | Patient selection, index test, reference standard, flow |
| **Mixed Methods** | MMAT | Qualitative, quantitative, mixed methods criteria |
### Source Quality Assessment Framework
```
QUALITY SCORING (rate each 1-5):
RELEVANCE:
- Directly addresses research question? ___
- Population matches target? ___
- Outcomes align with review objectives? ___
METHODOLOGICAL RIGOR:
- Study design appropriate? ___
- Sample size adequate? ___
- Bias minimized? ___
- Statistical analysis appropriate? ___
CREDIBILITY:
- Published in peer-reviewed journal? ___
- Authors have relevant expertise? ___
- Funding sources declared? ___
- Conflicts of interest addressed? ___
RECENCY:
- Published within target date range? ___
- Findings still applicable? ___
- Not superseded by newer evidence? ___
TOTAL SCORE: ___ / 60
High quality: 48-60
Medium quality: 36-47
Low quality: < 36
```
### Hierarchy of Evidence
```
EVIDENCE PYRAMID (highest to lowest):
Level 1: Systematic Reviews & Meta-Analyses
Level 2: Randomized Controlled Trials (RCTs)
Level 3: Cohort Studies (prospective)
Level 4: Case-Control Studies
Level 5: Cross-Sectional Studies / Case Series
Level 6: Expert Opinion / Editorials
Level 7: Anecdotal / Narrative Reports
```
## Citation Management
### Workflow
```
CITATION MANAGEMENT PROCESS:
1. COLLECT
- Export references from databases (RIS, BibTeX, EndNote XML)
- Import into reference manager (Zotero, Mendeley, EndNote)
- Attach PDFs where available
2. ORGANIZE
- Create folder structure mirroring review themes
- Tag with inclusion/exclusion status
- Tag with quality rating
- Add notes and annotations
3. DEDUPLICATE
- Run automatic deduplication
- Manual review of near-duplicates
- Document count removed
4. SCREEN
- Title/abstract screening (tag: include/exclude/maybe)
- Full-text screening (tag: include/exclude with reason)
- Track screening decisions
5. EXTRACT
- Populate data extraction form
- Link to source reference
- Note discrepancies
```
### Data Extraction Template
```
EXTRACTION FORM:
Study ID: ___
Authors: ___
Year: ___
Title: ___
Journal: ___
Study Design: ___
Country/Setting: ___
Population:
- Sample size: ___
- Demographics: ___
- Inclusion criteria: ___
Intervention/Exposure: ___
Comparison/Control: ___
Outcomes:
- Primary: ___
- Secondary: ___
- Measurement tools: ___
Key Findings: ___
Effect Size (if applicable): ___
Confidence Interval: ___
Quality Rating: ___
Reviewer Notes: ___
```
## Synthesis Frameworks
### Thematic Synthesis
```
THEMATIC SYNTHESIS STEPS:
1. CODE: Read included studies and assign descriptive codes
2. ORGANIZE: Group related codes into descriptive themes
3. DEVELOP: Generate analytical themes that go beyond the primary studies
4. MAP: Create a thematic map showing relationships between themes
5. WRITE: Narrate findings organized by analytical themes
THEMATIC MAP STRUCTURE:
Overarching Theme
|-- Sub-theme 1
| |-- Code A (Studies 1, 3, 7)
| |-- Code B (Studies 2, 5)
|-- Sub-theme 2
| |-- Code C (Studies 1, 4, 6)
| |-- Code D (Studies 3, 8)
```
### Chronological Synthesis
Best for showing how understanding of a topic has evolved over time.
```
CHRONOLOGICAL STRUCTURE:
Era 1 (e.g., 2000-2010): Foundational Work
- Key studies and their contributions
- Prevailing theories and methods
Era 2 (e.g., 2010-2018): Methodological Advances
- New approaches introduced
- Challenges to earlier findings
Era 3 (e.g., 2018-Present): Current State
- Latest findings and debates
- Emerging directions
```
### Methodological Synthesis
Group studies by methodology to compare how different approaches yield different insights.
| Methodology | Studies | Key Findings | Strengths | Limitations |
|-------------|---------|-------------|-----------|-------------|
| **RCTs** | [list] | [summary] | Causal inference | Generalizability |
| **Qualitative** | [list] | [summary] | Rich context | Subjectivity |
| **Mixed Methods** | [list] | [summary] | Comprehensive | Complexity |
| **Observational** | [list] | [summary] | Real-world validity | Confounding |
## Gap Identification
### Gap Analysis Framework
```
GAP CATEGORIES:
KNOWLEDGE GAPS:
- What questions remain unanswered?
- Where do findings conflict?
- What populations are understudied?
METHODOLOGICAL GAPS:
- What study designs are missing?
- Are sample sizes consistently too small?
- Are measurement tools validated?
CONTEXTUAL GAPS:
- What geographic regions are underrepresented?
- What settings haven't been studied?
- Are there temporal gaps in the literature?
PRACTICAL GAPS:
- What interventions haven't been tested?
- Where does evidence fail to translate to practice?
- What implementation barriers are unaddressed?
```
### Gap Documentation Template
```
GAP: [Brief description]
EVIDENCE: [What the current literature shows / doesn't show]
SIGNIFICANCE: [Why this gap matters]
SUGGESTED RESEARCH: [What future studies could address this]
PRIORITY: [High / Medium / Low]
```
## Writing Structure
### Literature Review Sections
```
STRUCTURE:
1. INTRODUCTION (10-15% of word count)
- Context and importance of the topic
- Scope and objectives of the review
- Research question(s)
- Brief overview of structure
2. METHODOLOGY (15-20% for systematic; shorter for narrative)
- Search strategy and databases
- Inclusion/exclusion criteria
- Screening process (PRISMA for systematic)
- Quality assessment approach
- Data extraction method
- Synthesis approach
3. FINDINGS / RESULTS (40-50%)
- Organized by themes, chronology, or methodology
- Summary tables of included studies
- Critical analysis (not just description)
- Comparison and contrast across studies
- Quality assessment results
4. DISCUSSION (15-20%)
- Synthesis of key findings
- Comparison with existing reviews
- Implications for theory and practice
- Strengths and limitations of the review
5. GAPS AND FUTURE DIRECTIONS (5-10%)
- Identified gaps in knowledge
- Recommended research priorities
- Methodological recommendations
6. CONCLUSION (5%)
- Summary of main findings
- Answer to research question
- Key implications
```
## Common Pitfalls
| Pitfall | Description | Prevention |
|---------|-------------|------------|
| **Cherry-picking** | Selecting only studies that support a hypothesis | Pre-register protocol, follow PRISMA |
| **Narrative bias** | Describing studies without critical analysis | Use appraisal tools, compare across studies |
| **Scope creep** | Expanding focus beyond original question | Stick to predefined inclusion criteria |
| **Recency bias** | Over-weighting recent studies | Include full date range, weight by quality |
| **Publication bias** | Missing grey literature and null results | Search preprints, dissertations, trial registries |
| **Inadequate search** | Too few databases or narrow search terms | Minimum 3 databases, iterative search refinement |
| **Poor synthesis** | Listing studies instead of integrating findings | Use synthesis frameworks, identify patterns |
| **Missing protocol** | No pre-registered review protocol | Register on PROSPERO or OSF before starting |
## Review Protocol Template
```
PROTOCOL:
Title: [Review title]
Registration: [PROSPERO/OSF ID]
Authors: [Names and roles]
Date: [Protocol date]
Background: [Why this review is needed]
Objectives: [What the review aims to achieve]
Research Question: [PICO/PEO formatted question]
Eligibility Criteria:
Inclusion: [List]
Exclusion: [List]
Information Sources: [Databases and other sources]
Search Strategy: [Full search string per database]
Study Selection:
- Stage 1: Title/abstract screening (2 independent reviewers)
- Stage 2: Full-text screening (2 independent reviewers)
- Disagreement resolution: [Process]
Data Extraction: [What data will be extracted]
Quality Assessment: [Which tool(s) will be used]
Synthesis Method: [Narrative, thematic, meta-analysis]
Timeline: [Planned completion date]
```
## See Also
- [Data Science](../data-science/SKILL.md)
- [Grant Proposal Builder](../grant-proposal-builder/SKILL.md)
© travisjneuman · MIT · travisjneuman/.claude