Claude Code Skills for Academic Research

Reusable Claude Code skills for paper review, code review, and computational reproducibility audits

View the Project on GitHub lcrawfurd/claude-skills

← Back to all skills

Paper Review

Review academic research papers using established frameworks and guidelines.

Usage

/paper-review <path-to-paper>

Frameworks

When reviewing a paper, read the provided file first, then apply the following evaluation frameworks:

1. Edmans’ Framework for Editorial Assessment

Evaluate the research paper intended for submission to a top journal using Edmans’ framework for editorial assessment. Assess the paper across the three key dimensions:

Contribution

Execution

Exposition

Feedback Format

Provide specific, actionable feedback, highlighting:


2. Nyhan’s Checklist for Peer Review

Based on Brendan Nyhan’s “Checklist Manifesto for Peer Review” (built from 150+ manuscript reviews), evaluate the paper against these methodological criteria:

  1. Interaction terms: Does the author properly interpret any interaction terms and include the necessary interactions to test subgroup differences?

  2. P-value interpretation: Does the author avoid misinterpreting null findings as evidence that true effects equal zero?

  3. Replication materials: Are questionnaires, study materials, and code included for reproducibility?

  4. Causal language: Does the author avoid using causal language for correlational findings?

  5. Causal assumptions: Are assumptions necessary for causal interpretation explicitly stated?

  6. Mediation models: Are mediation models properly specified using current best practices?

  7. Post-treatment bias: Does the author avoid controlling for variables affected by the treatment?

  8. Statistical power: Does the study have sufficient statistical power to test the hypothesis of interest reliably?

  9. Subgroup analyses: Are subgroup analyses adequately powered and theoretically justified rather than data-driven?

Provide actionable feedback on any checklist items where the manuscript falls short, with specific suggestions for improvement.


3. Humphreys’ Comprehensive Review Framework

Based on Macartan Humphreys’ guide to critiquing research papers. Structure formal reviews in three parts:

Part 1: Summary Paragraph

Part 2: Major Themes (3-6 issues)

Organize feedback by theme, drawing from these categories:

Theory

From Theory to Hypotheses

Hypotheses

Evidence I: Design

Evidence II: Analysis and Testing

Evidence III: Other Sources of Bias

Explanation

Policy Implications

Part 3: Smaller Issues

Bullet point items including:

Review Conduct Guidelines


4. Blattman’s Empirical Paper Review Guide

Chris Blattman’s structured approach for reading and reviewing empirical papers:

Research Question and Hypothesis

Research Design

Theory/Model

Data

Empirical Analysis

Results

Scope


5. Evans & Bellemare: Introduction, Abstract, and Conclusion Structure

Based on David Evans’ guides on writing introductions and abstracts for development economics papers, and Marc Bellemare’s “Conclusion Formula”.

Introduction Structure (Evans, drawing on Keith Head’s “Introduction Formula”)

You win or lose readers with the introduction. Papers with more readable introductions get cited more. Evaluate whether the introduction follows this pattern:

  1. Hook (1-2 paragraphs): Does it attract reader interest by showing the topic matters?
    • Y matters (people are hurt or helped)
    • Y is puzzling (defies easy explanation)
    • Y is controversial
    • Y is big or common
    • The motivation must be about the economics — NEVER start with literature or a new technique
  2. Research Question (1 paragraph): Is the question clearly stated?
    • Lead with YOUR question
    • Be specific and motivate YOUR research question
  3. Antecedents (integrated): What prior work does this build on?
    • No need for a separate “Literature Review” section
    • Should be woven into the introduction
    • Focus on the closest 5-7 studies
  4. Value-Added (1 paragraph): How does this add to prior work?
    • Approximately 3 contributions relative to antecedents
    • This may be the most important paragraph for convincing referees
    • Contributions should make sense only in light of prior work
  5. Roadmap: Brief guide to paper structure

Abstract Structure (Evans)

Use all words allowed and use them wisely. More readable abstracts (simpler words, shorter sentences) get more citations. Typical structure:

  1. (Sometimes) One sentence of motivation
  2. Research question and empirical approach — often start directly here
  3. Detailed discussion of results (most of the space)
  4. (Sometimes) One sentence on implications

Word limits vary: AER/AEJ allow 100 words (~4-5 sentences); QJE allows 250; JDE allows 150.

Conclusion Structure (Bellemare’s “Conclusion Formula”)

  1. Summary: Tell them what you told them — but differently from abstract/intro. Present as narrative if possible.

  2. Limitations: Emphasize constraints of methodology and approach.

  3. Policy Implications: Discuss real-world applications, but avoid unsupported claims.
    • Assess costs against benefits, even approximately
    • Identify clear winners and losers (2-3 sentences)
    • Evaluate political feasibility and implementation difficulty
  4. Future Research: Acknowledge imperfections and suggest extensions.
    • How could theoretical contributions be generalized?
    • How might empirical work achieve better causal identification?
    • How could findings be tested in additional contexts?

Evaluation Questions

When reviewing, ask: