Literature Review
Conduct a structured literature search and synthesis on the given topic.
Input: $ARGUMENTS — a topic, paper title, research question, or phenomenon to investigate.
Steps
Parse the topic from $ARGUMENTS. If a specific paper is named, use it as the anchor.
Search for related work using available tools:
- Check
master_supporting_docs/supporting_papers/ for uploaded papers
- Use
WebSearch to find recent publications (if available)
- Use
WebFetch to access working paper repositories (if available)
- Read any existing
.bib file for papers already in the project
Organize findings into these categories:
- Theoretical contributions — models, frameworks, mechanisms
- Empirical findings — key results, effect sizes, data sources
- Methodological innovations — new estimators, identification strategies, inference methods
- Open debates — unresolved disagreements in the literature
Identify gaps and opportunities:
- What questions remain unanswered?
- What data or methods could address them?
- Where do findings conflict?
Extract citations in BibTeX format for all papers discussed.
Save the report to quality_reports/lit_review_[sanitized_topic].md
Output Format
# Literature Review: [Topic]
**Date:** [YYYY-MM-DD]
**Query:** [Original query from user]
## Summary
[2-3 paragraph overview of the state of the literature]
## Key Papers
### [Author (Year)] — [Short Title]
- **Main contribution:** [1-2 sentences]
- **Method:** [Identification strategy / data]
- **Key finding:** [Result with effect size if available]
- **Relevance:** [Why it matters for our research]
[Repeat for 5-15 papers, ordered by relevance]
## Thematic Organization
### Theoretical Contributions
[Grouped discussion]
### Empirical Findings
[Grouped discussion with comparison across studies]
### Methodological Innovations
[Methods relevant to the topic]
## Gaps and Opportunities
1. [Gap 1 — what's missing and why it matters]
2. [Gap 2]
3. [Gap 3]
## Suggested Next Steps
- [Concrete actions: papers to read, data to obtain, methods to consider]
## BibTeX Entries
```bibtex
@article{...}
---
## Post-Flight Verification (mandatory, CoVe)
Before returning the draft literature review to the user, run the Post-Flight Verification protocol from [`.claude/rules/post-flight-verification.md`](../../rules/post-flight-verification.md). Literature reviews are **very high** hallucination risk because WebSearch can return plausible-sounding fabricated citations. CoVe catches this architecturally.
### Steps
1. **Extract claims** from the draft. Each cited paper, each paraphrased finding ("Smith 2019 shows X"), each negative-literature assertion ("no prior work studies Y") is a claim.
2. **Generate verification questions** per claim. Specific ones: "Does Smith (2019, *JEL*) Section 3 actually report the finding that X implies Y? Is the venue correct?"
3. **Spawn `claim-verifier`** via the `Agent` tool with `subagent_type=claim-verifier` and `context=fork`. Pass: the claims table, the verification questions, the source-material pointers (paper URLs, DOIs, `master_supporting_docs/` paths). **Do NOT pass the draft text itself** — the fresh-context independence is what makes CoVe work.
4. **Reconcile:** if the verifier reports PASS, attach a green Post-Flight block to the output. If PARTIAL, mark the unverifiable claims with uncertainty flags in the BibTeX block. If FAIL, **remove or rewrite the contradicted citations** using the verifier's evidence before returning.
### Skip conditions
- `--no-verify` flag — user opts out for speed.
- User hands you ≤3 papers they already have read and confirmed; CoVe is overhead for content they've personally verified.
### Output contract
Append a Post-Flight block to the report (collapsed by default). See rule doc for the format.
---
## Important
- **Be honest about uncertainty.** If you cannot verify a citation, say so.
- **Prioritize recent work** (last 5-10 years) unless seminal papers are older.
- **Note working papers vs published papers** — working papers may change.
- **Do NOT fabricate citations.** If you're unsure about a paper's details, flag it for the user to verify. Post-Flight Verification catches most fabrications automatically; this rule is the backup.
1---2name: lit-review3description: Structured literature search + synthesis with citation extraction, thematic clustering, and gap identification. Use when user says "find papers on X", "do a lit review", "what's the literature on...", "summarize what we know about...", "where's the gap in this field", "review recent work on Y". Produces a written review with BibTeX-ready citations. Uses WebSearch/WebFetch for recent work.4argument-hint: "[topic, paper title, or research question] [--no-verify]"5allowed-tools: ["Read", "Grep", "Glob", "Write", "WebSearch", "WebFetch", "Agent", "Task"]6metadata:7 source: https://skillmd.com/skills/pedrohcgs/lit-review8---910# Literature Review1112Conduct a structured literature search and synthesis on the given topic.1314**Input:** `$ARGUMENTS` — a topic, paper title, research question, or phenomenon to investigate.1516---1718## Steps19201. **Parse the topic** from `$ARGUMENTS`. If a specific paper is named, use it as the anchor.21222. **Search for related work** using available tools:23 - Check `master_supporting_docs/supporting_papers/` for uploaded papers24 - Use `WebSearch` to find recent publications (if available)25 - Use `WebFetch` to access working paper repositories (if available)26 - Read any existing `.bib` file for papers already in the project27283. **Organize findings** into these categories:29 - **Theoretical contributions** — models, frameworks, mechanisms30 - **Empirical findings** — key results, effect sizes, data sources31 - **Methodological innovations** — new estimators, identification strategies, inference methods32 - **Open debates** — unresolved disagreements in the literature33344. **Identify gaps and opportunities:**35 - What questions remain unanswered?36 - What data or methods could address them?37 - Where do findings conflict?38395. **Extract citations** in BibTeX format for all papers discussed.40416. **Save the report** to `quality_reports/lit_review_[sanitized_topic].md`4243---4445## Output Format4647```markdown48# Literature Review: [Topic]4950**Date:** [YYYY-MM-DD]51**Query:** [Original query from user]5253## Summary5455[2-3 paragraph overview of the state of the literature]5657## Key Papers5859### [Author (Year)] — [Short Title]60- **Main contribution:** [1-2 sentences]61- **Method:** [Identification strategy / data]62- **Key finding:** [Result with effect size if available]63- **Relevance:** [Why it matters for our research]6465[Repeat for 5-15 papers, ordered by relevance]6667## Thematic Organization6869### Theoretical Contributions70[Grouped discussion]7172### Empirical Findings73[Grouped discussion with comparison across studies]7475### Methodological Innovations76[Methods relevant to the topic]7778## Gaps and Opportunities79801. [Gap 1 — what's missing and why it matters]812. [Gap 2]823. [Gap 3]8384## Suggested Next Steps8586- [Concrete actions: papers to read, data to obtain, methods to consider]8788## BibTeX Entries8990```bibtex91@article{...}92```93```9495---9697## Post-Flight Verification (mandatory, CoVe)9899Before returning the draft literature review to the user, run the Post-Flight Verification protocol from [`.claude/rules/post-flight-verification.md`](../../rules/post-flight-verification.md). Literature reviews are **very high** hallucination risk because WebSearch can return plausible-sounding fabricated citations. CoVe catches this architecturally.100101### Steps1021031. **Extract claims** from the draft. Each cited paper, each paraphrased finding ("Smith 2019 shows X"), each negative-literature assertion ("no prior work studies Y") is a claim.1042. **Generate verification questions** per claim. Specific ones: "Does Smith (2019, *JEL*) Section 3 actually report the finding that X implies Y? Is the venue correct?"1053. **Spawn `claim-verifier`** via the `Agent` tool with `subagent_type=claim-verifier` and `context=fork`. Pass: the claims table, the verification questions, the source-material pointers (paper URLs, DOIs, `master_supporting_docs/` paths). **Do NOT pass the draft text itself** — the fresh-context independence is what makes CoVe work.1064. **Reconcile:** if the verifier reports PASS, attach a green Post-Flight block to the output. If PARTIAL, mark the unverifiable claims with uncertainty flags in the BibTeX block. If FAIL, **remove or rewrite the contradicted citations** using the verifier's evidence before returning.107108### Skip conditions109110- `--no-verify` flag — user opts out for speed.111- User hands you ≤3 papers they already have read and confirmed; CoVe is overhead for content they've personally verified.112113### Output contract114115Append a Post-Flight block to the report (collapsed by default). See rule doc for the format.116117---118119## Important120121- **Be honest about uncertainty.** If you cannot verify a citation, say so.122- **Prioritize recent work** (last 5-10 years) unless seminal papers are older.123- **Note working papers vs published papers** — working papers may change.124- **Do NOT fabricate citations.** If you're unsure about a paper's details, flag it for the user to verify. Post-Flight Verification catches most fabrications automatically; this rule is the backup.