name: litreview
description: >
Literature review for academic and R&D research: search strategy, source
assessment, synthesis, and citation management. Use when conducting a
systematic literature review, building a bibliography, or preparing a
research-grounded report.
license: MIT + Commons Clause
metadata:
version: 1.0.0
author: borghei
category: research
domain: research
updated: 2026-05-27
tags: [literature-review, research, citation, synthesis, prisma, academic]
Literature Review
A structured literature-review skill grounded in PRISMA-style protocols
(adapted for non-medical fields), source-assessment frameworks, and
thematic synthesis patterns.
When to use this skill
- Conducting a systematic literature review on a specific question
- Building a research bibliography for a paper, report, or grant
- Performing a scoping review to map a field
- Auditing an existing review for gaps, bias, or methodological flaws
- Synthesizing findings from a structured set of sources
- Preparing a research-grounded section of a longer report
Inputs the advisor expects
- Research question(s) — specific, answerable
- Inclusion / exclusion criteria
- Time bound (e.g., past 5 years)
- Geographic / domain bound
- Source types accepted (peer-reviewed, gray literature, conference)
- Existing seed sources (if any)
Clarify First
Before building the review, confirm these inputs. If any is unknown or vague, ASK — do not assume:
Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.
Workflows
Workflow 1 — Plan and execute the search
- Refine the research question (PICO / PEO format works).
- Run
search_strategy_builder.py against the question + criteria to
produce a search strategy (database list, queries, filters).
- Execute searches; capture results.
python3 litreview/scripts/search_strategy_builder.py \
--input question.json --format markdown
Workflow 2 — Score source quality and relevance
- Capture each source with metadata (authors, date, venue, methodology).
- Run
source_quality_scorer.py to grade each on 6 quality dimensions
- Triage: include / exclude / read-in-full.
python3 litreview/scripts/source_quality_scorer.py \
--input sources.json --format markdown
Workflow 3 — Synthesize findings into themes
- Tag each source with themes + key findings.
- Run
thematic_synthesis_builder.py to cluster sources by theme,
surface evidence strength, identify gaps.
python3 litreview/scripts/thematic_synthesis_builder.py \
--input tagged_sources.json --format markdown
Decision frameworks
Search strategy — the PICO frame
- Population / problem
- Intervention / phenomenon of interest
- Comparator (if relevant)
- Outcome
A well-framed question makes search and synthesis tractable.
Inclusion / exclusion criteria
- Year range
- Language
- Source type (peer-reviewed, gray, conference, preprint)
- Methodology (empirical, theoretical, review)
- Geographic scope
- Quality threshold
Publish criteria up front; apply consistently.
Source quality dimensions
| Dimension | Question |
|---|
| Methodology | Is the method sound? |
| Sample / dataset | Is it adequate for the claim? |
| Peer review | Has it been peer-reviewed? |
| Reproducibility | Is data / code available? |
| Recency | Is it current? |
| Citation impact | Has it been cited / accepted? |
A single sub-dimension is rarely fatal; the combination matters.
Synthesis approaches
| Approach | When |
|---|
| Narrative synthesis | Heterogeneous sources; explanatory |
| Thematic synthesis | Multiple sources address common themes |
| Meta-analysis | Quantitative, comparable studies |
| Realist synthesis | Complex interventions; context-mechanism-outcome |
| Scoping review | Mapping a field rather than answering specific question |
For most non-clinical fields, thematic synthesis is the default.
Common engagements
"Help me build the literature review for my paper"
- Frame the research question (PICO).
- Define inclusion criteria.
- Identify search databases / repositories.
- Execute searches; deduplicate.
- Screen titles + abstracts; full-text the candidates.
- Tag and synthesize.
- Write: gaps, themes, my contribution.
"Audit my draft literature review"
- Check the search strategy: reproducible? comprehensive?
- Check inclusion criteria: applied consistently?
- Check synthesis: themes substantiated?
- Check gap identification: real gaps, or convenient?
- Check citation balance: not over-relying on a single source / group.
"Map the landscape of [research area]"
- Conduct a scoping review (different from systematic).
- Less stringent quality criteria; broader scope.
- Goal: map the field, not answer specific question.
- Output: themes, gaps, key authors, key venues.
Anti-patterns to avoid
- Search strategy that's "Google Scholar for keywords." Not reproducible.
- Inclusion criteria written after seeing results. Cherry-picking.
- Synthesizing only confirming sources. Bias.
- Citing without reading. Cite chains repeat errors.
- No quality scoring. All sources weighted equally.
- No gap discussion. Reader can't see what's not known.
- Over-reliance on one author / group / venue. Hidden bias.
- No PRISMA-style flow diagram (for systematic reviews). Process opaque.
References
references/search-strategy-and-prisma.md — search patterns, PRISMA discipline
references/source-quality-assessment.md — quality dimensions, common assessments
references/synthesis-and-citation-management.md — synthesis approaches, citation hygiene
Related skills
research/grants — grant proposals built on literature
research/patent — IP-focused literature search
research/dossier — intelligence research patterns
product-team/research-summarizer — synthesizing qualitative research