# Lit Review

> Systematic literature review methodology for social science research. Use when conducting systematic reviews, research synthesis, meta-analyses, scoping reviews, or comprehensive literature searches across economics, political science, sociology, education, public health, and development. Produces structured notebook cells with search strategy, evidence table, thematic synthesis, and gap analysis.

- **Type:** Skill
- **Install:** `agentstack add skill-sshtomar-claude-code-skills-social-science-literature-review`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [sshtomar](https://agentstack.voostack.com/s/sshtomar)
- **Installs:** 0
- **Category:** [Search](https://agentstack.voostack.com/c/search)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [sshtomar](https://github.com/sshtomar)
- **Source:** https://github.com/sshtomar/claude-code-skills-social-science/tree/main/skills/literature-review

## Install

```sh
agentstack add skill-sshtomar-claude-code-skills-social-science-literature-review
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

A systematic literature review follows a structured, reproducible protocol to identify, evaluate, and synthesize existing research on a topic. This skill enforces methodological rigor by requiring explicit search strategies, transparent inclusion criteria, quality assessment, and structured evidence tables -- all implemented as notebook cells for full reproducibility.

Literature reviews in social science differ from biomedical reviews: gray literature (working papers, policy reports) carries significant weight, quasi-experimental designs are common, and the boundary between "published" and "working" research is fluid. This skill accounts for these disciplinary norms.

  Explicit Search Strategy
  MUST document search terms, databases, date ranges, and inclusion/exclusion criteria BEFORE presenting any findings
  Petticrew & Roberts (2006) emphasize that undocumented search strategies make reviews unreproducible and prone to selection bias. In social science, where researcher priors are strong, this discipline is essential
  Cherry-picked citations that confirm priors rather than representing the field

  Structured Evidence Table
  ALL sources MUST be recorded in a structured DataFrame with: authors, year, title, journal/source, methodology, sample_size, geographic_scope, key_finding, effect_size, quality_rating, and relevance
  Systematic organization prevents narrative bias and makes gaps in the evidence visible (Tranfield et al., 2003). The structured format enables programmatic analysis of the evidence base
  Narrative reviews without structure tend to over-weight memorable or recent studies

  Source Evaluation
  Each source MUST be assessed for methodological quality: identification strategy, internal validity, external validity, sample size adequacy, and potential threats. Rate as high/medium/low
  Not all evidence is equal. Meta-analyses show that effect sizes vary systematically with study quality (Stanley & Doucouliagos, 2012). In social science, identification strategy is the primary quality marker
  Treating all studies as equally valid produces misleading syntheses

  Gap Identification
  The synthesis MUST explicitly identify gaps, contradictions, and unresolved questions in the literature
  The primary value of a literature review is mapping what is NOT known, not just summarizing what is. Gap identification motivates new research
  Review becomes a summary rather than a foundation for new research

  Gray Literature Inclusion
  MUST search working paper repositories (NBER, SSRN, IZA, CEPR, J-PAL, 3ie) alongside peer-reviewed journals
  In economics and policy research, the most current and influential work often circulates as working papers for years before publication. Publication bias means published studies systematically overstate effect sizes (Andrews & Kasy, 2019). Excluding gray literature biases reviews toward significant findings
  Missing the most current research and introducing publication bias into the review

  Thematic Synthesis
  Results MUST be organized thematically, NOT as study-by-study summaries. Synthesize across studies within each theme
  Study-by-study presentation fails to identify patterns, contradictions, and the weight of evidence. Thematic synthesis is the distinguishing feature of a good review (Braun & Clarke, 2006)
  Review reads as an annotated bibliography rather than a synthesis

For social science reviews, use the SPIDER framework (more flexible than PICO for non-clinical research):

- S (Sample): What population, group, or context?
- PI (Phenomenon of Interest): What intervention, policy, program, or phenomenon?
- D (Design): What study designs to include? (RCT, DID, IV, RDD, qualitative, mixed)
- E (Evaluation): What outcomes or impacts to evaluate?
- R (Research type): Quantitative, qualitative, or mixed methods?

Example: "What is the effect (E: learning outcomes, enrollment) of conditional cash transfer programs (PI) on educational attainment in low- and middle-income countries (S), as measured by experimental and quasi-experimental studies (D, R)?"

For policy evaluation reviews, also consider:
- Implementation context (what makes programs work or fail?)
- Heterogeneity (for whom, where, under what conditions?)
- Cost-effectiveness (what is the cost per unit of impact?)
- Scalability (do effects hold when programs scale?)

Select at minimum 3 complementary databases appropriate for the domain:

Core Social Science Databases:
- Google Scholar: Comprehensive cross-disciplinary coverage, citation tracking
- SSRN: Working papers in economics, finance, law, political science
- NBER Working Papers: Leading economics research (often years before publication)
- JSTOR: Historical and current peer-reviewed articles across social sciences
- Web of Science / Scopus: Citation-indexed peer-reviewed literature
- EconLit: Economics-specific (AEA journals, books, working papers)

Policy and Development:
- J-PAL Evidence: RCTs in development economics
- 3ie Development Evidence Portal: Impact evaluations in international development
- World Bank Open Knowledge Repository: Policy research and working papers
- IMF Working Papers: Macroeconomics and public finance
- OECD iLibrary: Cross-country policy analysis

Specialized by Discipline:
- ERIC: Education research
- PubMed/PMC: Public health, health economics, epidemiology
- PolicyFile: US public policy research
- Campbell Collaboration: Systematic reviews in social sciences
- Cochrane Library: Health intervention reviews (when relevant)
- IZA Discussion Papers: Labor economics
- CEPR Discussion Papers: European economics research
- arXiv (econ, q-fin, stat): Quantitative methods, econometrics

Preprint and Open Access:
- RePEc/IDEAS: Economics working papers and articles
- OSF Preprints: Open science preprints across social sciences
- EdWorkingPapers (Annenberg): Education policy research

Database Selection Strategy:
1. Primary database for breadth: Google Scholar or Web of Science
2. Working paper repository: NBER, SSRN, or IZA (field-dependent)
3. Specialized database: EconLit, ERIC, J-PAL, etc. (topic-dependent)
4. Gray literature: World Bank, OECD, or government reports
5. Citation chaining: Forward and backward from key papers

Assess each study's methodological quality based on identification strategy and validity:

Study Design Hierarchy (for causal questions):
1. RCTs (randomized controlled trials / field experiments)
2. Regression discontinuity designs (RDD)
3. Instrumental variables (IV)
4. Difference-in-differences (DID) with pre-trends evidence
5. Propensity score matching / synthetic control
6. Observational with controls (OLS with covariates)
7. Descriptive / correlational studies
8. Qualitative / case studies

Quality Dimensions to Assess:
- Internal validity: How credible is the causal identification?
- Statistical power: Is the sample large enough to detect meaningful effects?
- External validity: How generalizable are the findings?
- Measurement quality: Are key variables well-measured?
- Pre-registration: Was the analysis pre-specified? (reduces p-hacking risk)
- Transparency: Are data and code available for replication?
- Robustness: Do results hold across specifications?

Quality Rating Scale:
- High: Strong identification strategy, adequate power, transparent methods, robust results
- Medium: Reasonable identification with some threats, adequate sample, partial robustness
- Low: Weak identification, small sample, or results sensitive to specification

Red Flags:
- P-values clustered just below 0.05 (possible p-hacking)
- No robustness checks or only one specification reported
- Effect sizes that are implausibly large
- Endogeneity concerns not addressed
- Missing data handled without sensitivity analysis
- Post-hoc subgroup analysis presented as primary finding

Prioritize papers based on methodological rigor, venue quality, and influence:

Citation Count Thresholds (social science norms):
| Paper Age | Citations | Classification |
|-----------|-----------|----------------|
| 0-3 years | 10+ | Noteworthy |
| 0-3 years | 50+ | Highly Influential |
| 3-7 years | 50+ | Significant |
| 3-7 years | 200+ | Landmark Paper |
| 7+ years | 200+ | Seminal Work |
| 7+ years | 500+ | Foundational |

Note: Citation norms vary by subfield. Labor economics papers accumulate citations faster than political theory. Use these as rough guides.

Journal Tiers (Economics):
- Tier 1: American Economic Review, Quarterly Journal of Economics, Econometrica, Journal of Political Economy, Review of Economic Studies
- Tier 2: Review of Economics and Statistics, Journal of the European Economic Association, American Economic Journal (all), Journal of Finance, Journal of Labor Economics, Journal of Public Economics, Journal of Development Economics, Economic Journal
- Tier 3: Respected field journals (Journal of Human Resources, Journal of Health Economics, Journal of Urban Economics, etc.)

Journal Tiers (Political Science):
- Tier 1: American Political Science Review, American Journal of Political Science, Journal of Politics
- Tier 2: Comparative Political Studies, World Politics, International Organization, British Journal of Political Science
- Tier 3: Field journals (Political Analysis, Political Behavior, etc.)

Journal Tiers (Sociology):
- Tier 1: American Sociological Review, American Journal of Sociology
- Tier 2: Social Forces, Demography, Sociology of Education
- Tier 3: Field journals

Working Papers:
- NBER Working Papers carry significant weight (peer network vetting)
- SSRN/IZA papers should be assessed on methodology, not venue
- Check if working papers have been subsequently published

Identifying Seminal Papers:
1. Cited by many of the other papers you find (appears across reference lists)
2. Introduced a methodology now widely used (e.g., Angrist & Krueger 1991 for IV)
3. Published in Tier-1 venue with high citation count
4. Referenced in textbooks and survey articles
5. Written by researchers recognized as field leaders

Boolean Search Construction:
- AND: narrows (both terms required)
- OR: broadens (either term)
- Quotes: exact phrase ("conditional cash transfer")
- Wildcards: education* matches educational, education, educating

Example for a CCT review:
("conditional cash transfer" OR "CCT" OR "cash transfer program")
AND ("education" OR "school enrollment" OR "attendance" OR "learning outcomes")
AND ("developing countries" OR "low-income" OR "Global South")

Citation Chaining:
1. Forward citation search: Find papers citing a key paper (Google Scholar "Cited by")
2. Backward citation search: Review references of key papers
3. Snowball sampling: Start with 3-5 seminal papers, follow citation networks
4. Prioritize papers appearing in multiple reference lists (likely foundational)

Search Refinement:
1. Pilot search: Run broad terms, review first 50 results
2. Note recurring keywords, author names, and journal names
3. Refine search terms based on pilot results
4. Run refined search across all selected databases
5. Document each iteration for reproducibility

Gray Literature Search:
- NBER: Browse by program (Labor Studies, Public Economics, etc.)
- SSRN: Search by keyword and sort by downloads or citations
- Government reports: Search agency websites directly
- Conference proceedings: ASSA/AEA meetings, APPAM, BREAD
- Dissertations: ProQuest Dissertations for emerging research

Phase 1: Planning and Scoping (Cell 1)
- Define research question using SPIDER framework
- Develop search terms with synonyms and Boolean operators
- Select minimum 3 complementary databases
- Set date range, language, and geographic constraints
- Define inclusion/exclusion criteria (study design, population, outcomes)
- Specify review type: systematic, scoping, narrative, or meta-analysis

Phase 2: Systematic Search and Source Collection (Cell 2)
- Execute search across all selected databases
- Document search strings, dates, and result counts for each database
- Aggregate results and remove duplicates
- Build structured DataFrame of all identified sources
- Record how each source was found (which search, which database)
- Conduct citation chaining from key papers

Phase 3: Screening and Quality Assessment (Cell 3)
- Apply inclusion/exclusion criteria systematically
- Document exclusion reasons with counts
- Assess methodological quality of each included study
- Assign quality rating (high/medium/low)
- Create screening flow diagram (records found -> deduplicated -> screened -> included)

Phase 4: Thematic Synthesis and Gap Analysis (Cell 4)
- Identify 3-6 major themes across included studies
- Synthesize findings within each theme (NOT study-by-study)
- Compare effect sizes and directions across studies
- Weight synthesis by study quality
- Identify consensus findings, contested claims, and gaps
- Note methodological patterns and limitations across studies

Phase 5: Summary, Implications, and References (Cell 5)
- Synthesize key takeaways (what does the weight of evidence suggest?)
- Discuss implications for policy, practice, or future research
- List specific gaps that future research should address
- Acknowledge limitations of the review itself
- Provide properly formatted reference list

Each phase becomes a separate notebook cell. Pure Python code, no decorators or wrappers.

Cell 1 -- Search Strategy:
```python
import pandas as pd
from datetime import date

# LITERATURE REVIEW: [Topic]
# ============================================================

search_strategy = {
    "research_question": "What is the effect of [intervention] on [outcome] in [population/context]?",
    "framework": "SPIDER",
    "sample": "[population or context]",
    "phenomenon": "[intervention, policy, or phenomenon]",
    "design": "[RCT, DID, IV, RDD, mixed methods, etc.]",
    "evaluation": "[outcomes to measure]",
    "research_type": "[quantitative, qualitative, mixed]",
    "search_terms": [
        '("term1" OR "synonym1") AND ("term2" OR "synonym2")',
        '"exact phrase" AND (outcome1 OR outcome2)',
    ],
    "databases": [
        "Google Scholar",
        "NBER Working Papers",
        "SSRN",
        # Add domain-specific: EconLit, ERIC, J-PAL, 3ie, etc.
    ],
    "date_range": "2010-2025",
    "language": "English",
    "inclusion_criteria": [
        "Peer-reviewed articles or working papers from recognized institutions",
        "Empirical studies with quantitative outcome measures",
        "Study designs: RCT, DID, IV, RDD, or high-quality observational",
        "Population: [specify]",
    ],
    "exclusion_criteria": [
        "Purely theoretical or opinion pieces without empirical evidence",
        "Studies with sample size  0:
    print(f"\nWARNING: {len(_low_quality)} low-quality studies included.")
    print("These will be noted but down-weighted in synthesis.")
```

Cell 4 -- Thematic Synthesis:
```python
# THEMATIC SYNTHESIS
# ============================================================
print("=" * 60)
print("EVIDENCE SYNTHESIS")
print("=" * 60)

# Theme 1
print("\n--- Theme 1: [Theme Name] ---")
print("Studies: [Author1 (Year), Author2 (Year), ...]")
print("Finding: [Synthesized finding across studies, not study-by-study]")
print("Strength of evidence: [Strong/Moderate/Weak]")
print("Consistency: [Consistent/Mixed/Contradictory]")

# Theme 2
print("\n--- Theme 2: [Theme Name] ---")
# ... same structure

# Consensus vs. contested
print("\n" + "=" * 60)
print("EVIDENCE MAP")
print("=" * 60)

print("\nConsensus findings (supported by multiple high-quality studies):")
print("  1. ...")
print("  2. ...")

print("\nContested or mixed findings:")
print("  1. ... [Author1 finds X, but Author2 finds Y; difference may be due to ...]")

print("\nKnowledge gaps:")
print("  1. ... [No studies examine ...]")
print("  2. ... [Limited evidence on ... subpopulation]")
print("  3. ... [Methodological gap: no RCTs on ...]")

print("\nMethodological patterns:")
print(f"  - Most common design: {lit_table['methodology'].

…

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [sshtomar](https://github.com/sshtomar)
- **Source:** [sshtomar/claude-code-skills-social-science](https://github.com/sshtomar/claude-code-skills-social-science)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-sshtomar-claude-code-skills-social-science-literature-review
- Seller: https://agentstack.voostack.com/s/sshtomar
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
