academic-reviewer

Expert guidance for reviewing academic manuscripts submitted to journals, particularly in political science, economics, and quantitative social sciences. Use when asked to review, critique, or provide feedback on academic papers, research designs, or empirical strategies. Emphasizes methodological rigor, causal identification strategies, and constructive feedback on research design.

181 stars

Best use case

academic-reviewer is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Expert guidance for reviewing academic manuscripts submitted to journals, particularly in political science, economics, and quantitative social sciences. Use when asked to review, critique, or provide feedback on academic papers, research designs, or empirical strategies. Emphasizes methodological rigor, causal identification strategies, and constructive feedback on research design.

Teams using academic-reviewer should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/academic-reviewer/SKILL.md --create-dirs "https://raw.githubusercontent.com/majiayu000/claude-skill-registry/main/skills/data/academic-reviewer/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/academic-reviewer/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How academic-reviewer Compares

Feature / Agentacademic-reviewerStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Expert guidance for reviewing academic manuscripts submitted to journals, particularly in political science, economics, and quantitative social sciences. Use when asked to review, critique, or provide feedback on academic papers, research designs, or empirical strategies. Emphasizes methodological rigor, causal identification strategies, and constructive feedback on research design.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

Related Guides

SKILL.md Source

# Academic Manuscript Reviewer

This skill provides expert guidance for reviewing academic manuscripts with methodological rigor, focusing on causal identification, research design, and constructive critique.

## When to Use This Skill

Use this skill when:
- Asked to review an academic paper or manuscript
- Evaluating a research design or empirical strategy
- Providing feedback on causal identification approaches
- Critiquing experimental designs (field, survey, or lab experiments)
- Assessing quasi-experimental methods (DiD, RDD, IV, etc.)

## Review Process

Follow these steps to conduct a thorough review:

### 1. Initial Reading and Understanding

- Read the paper carefully to understand the research question, argument, methods, and findings
- Identify the core empirical strategy and identification approach
- Consider the theoretical contribution and stakes

### 2. Consult Reference Materials

Before writing the review, consult these reference documents as needed:

- **[Reviewer Profile](references/reviewer-profile.md)**: Detailed guidance on methodological approach, common critiques, and reviewing philosophy
- **[Review Structure](references/review-structure.md)**: Recommended structure for organizing your review
- **[Checklists](references/checklists.md)**: Manuscript checklist and reviewer self-checklist to ensure thorough evaluation
- **[Review Examples](references/review-examples.md)**: Example reviews demonstrating the style and approach

### 3. Evaluate Core Elements

**Identification Strategy (Primary Focus)**:
- Assess the credibility of causal identification
- Evaluate whether identifying assumptions are justified
- Check for plausible alternative explanations

**Research Design**:
- For DiD: check parallel trends, treatment timing endogeneity, estimator choice
- For RDD: check covariate balance, bandwidth selection, interpretation
- For IV: check exclusion restriction, instrument strength
- For experiments: check external validity, statistical power, realistic scenarios

**Statistical Inference**:
- Check subgroup analysis (are interactions formally tested?)
- Assess multiple comparison issues
- Evaluate clustering of standard errors
- Identify "bad controls" or post-treatment bias

**Theory-Empirics Link**:
- Can the design distinguish the proposed mechanism from alternatives?
- Is there a clear theoretical payoff (especially for top journals)?

### 4. Structure Your Review

Follow this format:

1. **Metadata**: Journal, dates, recommendation
2. **Summary**: Concise paragraph (~100 words) of paper's core elements
3. **Overall Assessment**: High-level verdict with strengths before reservations
4. **Major Issues**: 2-4 fundamental flaws (numbered list)
5. **Minor Issues**: Less critical suggestions (numbered list)
6. **Recommendation**: Clear decision justified by major issues

### 5. Maintain Appropriate Tone

- Be constructive but firm on methodological issues
- Praise genuine strengths and author efforts
- Provide actionable suggestions when possible
- Avoid ad hominem criticism
- Distinguish between fatal flaws and suggestions for improvement

## Key Principles

**Primacy of Identification**: The quality of causal identification strategy is paramount. Clever questions or novel data cannot compensate for flawed identification.

**Methodological Fluency**: Cite relevant methodological literature (Goodman-Bacon on DiD, Cattaneo et al. on RDD, Hainmueller et al. on conjoints, etc.).

**Skepticism of Survey Experiments**: Be particularly skeptical of survey experiments on sensitive topics (corruption, clientelism) due to social desirability bias and external validity concerns.

**Subgroup Analysis**: Consistently check whether apparent differences across subgroups are formally tested with interaction terms.

**Statistical Power**: Assess whether studies (especially field experiments) are adequately powered to detect plausible effect sizes.

## Self-Check Before Submitting

Use the reviewer self-checklist (in references/checklists.md) to ensure:
- Requests for controls are justified by confounding arguments
- Literature suggestions explain why citations are essential
- Comments about framing relate to scientific validity
- No unnecessary or ad hominem criticism
- Positive reviews adequately explain contributions

Related Skills

act-code-reviewer

181
from majiayu000/claude-skill-registry

Review JusticeHub code against ACT ecosystem values. Enforces cultural protocols, ALMA principles, and regenerative design.

academic-writing-style

181
from majiayu000/claude-skill-registry

Personalized academic writing assistant for university assignments in Chinese and English. Use when users need help writing/revising academic reports, project docs, technical analyses, research reviews, or case studies. Produces natural prose avoiding AI markers. Triggers: academic writing, assignment, report, technical analysis, research review, case study. | 个性化学术写作助手,适用于中英文大学作业。触发词:学术写作、作业、报告、技术分析、研究综述、案例研究、项目文档。

academic-writing-standards

181
from majiayu000/claude-skill-registry

Expert knowledge of academic writing standards for peer-reviewed papers, including citation integrity, style compliance, clarity, and scientific writing best practices. Use when reviewing or editing academic manuscripts, papers, or research documentation.

academic-writing-cs

181
from majiayu000/claude-skill-registry

Comprehensive toolkit for writing high-quality computer science research papers (conference, journal, thesis). Provides narrative construction guidance, sentence-level clarity principles (Gopen & Swan), academic phrasebank, CS-specific conventions, and section-by-section quality checklists. Use when assisting with academic paper writing, revision, or structure planning across all stages from drafting to submission.

academic-task-planner

181
from majiayu000/claude-skill-registry

Transform academic course assignment PDFs into structured, actionable markdown checklists with dates, unique IDs, and custom tags. Asks when the user will start, assigns tasks only to weekdays (Monday-Friday), respects weekends automatically, and calculates forum deadlines 3 days before due date. Use this skill when the user uploads academic PDFs or asks to create a task plan from course assignments.

academic-search

181
from majiayu000/claude-skill-registry

Search academic paper repositories (arXiv, Semantic Scholar) for scholarly articles in physics, mathematics, computer science, quantitative biology, AI/ML, and related fields

Academic Researcher

181
from majiayu000/claude-skill-registry

Academic paper search across 14+ scholarly platforms including arXiv, PubMed, Google Scholar, Web of Science, Semantic Scholar, Sci-Hub, and more. Use for literature review, research discovery, and citation management.

academic-research

181
from majiayu000/claude-skill-registry

Systematic academic literature search with source prioritization and APA 7th edition citations. Use when the user needs to research a topic with scholarly sources, verify claims with academic backing, find peer-reviewed evidence, compile research findings, or generate properly cited reports. Triggers: "research [topic]", "what does the research say about...", "find studies on...", "verify this claim...", "literature review", "academic sources for...", "peer-reviewed evidence", "scholarly articles about...", "evidence-based", "cite sources for...". This skill provides basic APA citation capabilities; for advanced citation work (complex source types, edge cases, batch formatting), consider the `apa-style-citation` skill which offers enhanced citation expertise.

academic-research-writing

181
from majiayu000/claude-skill-registry

Use when writing CS research papers (conference, journal, thesis), reviewing scientific manuscripts, improving academic writing clarity, or preparing IEEE/ACM submissions. Invoke when user mentions paper, manuscript, research writing, journal submission, or needs help with academic structure, formatting, or revision.

academic-research-writer

181
from majiayu000/claude-skill-registry

Write academic research documents following academic guidelines with peer-reviewed sources from Google Scholar and other academic databases. Always verify source credibility and generate IEEE standard references. Use for research papers, literature reviews, technical reports, theses, dissertations, conference papers, and academic proposals requiring proper citations and scholarly rigor.

Academic Paper

181
from majiayu000/claude-skill-registry

## Description

academic-letter-architect

181
from majiayu000/claude-skill-registry

Use when writing recommendation letters, reference letters, or award nominations for students, postdocs, or colleagues. Invoke when user mentions recommendation letter, reference, nomination, letter of support, endorsement, or needs help with strong advocacy, comparative statements, or evidence-based character assessment.