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.

16 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/diegosouzapw/awesome-omni-skill/main/skills/design/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.

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

brutalist-academic-ui

16
from diegosouzapw/awesome-omni-skill

Skriptoteket-specific brutalist/academic UI design. Use for Vue/Vite SPA and SSR templates when you want grid-based layouts, systematic typography, and high-contrast “academic” aesthetics, while staying compatible with Skriptoteket’s pure-CSS + HuleEdu token stack (no Tailwind).

ascii-design-reviewer

16
from diegosouzapw/awesome-omni-skill

Review Phase 1 ASCII UI designs from a product owner perspective. Analyze user journeys, identify potential issues, ask clarifying questions about requirements and user flows, create Mermaid diagrams (flowcharts, sequence diagrams, state charts), provide detailed system behavior documentation, and document error handling strategies. Use when reviewing ASCII mockups to validate design against actual user needs, understand system workflows, and ensure completeness before moving to implementation.

quant-plan-reviewer

16
from diegosouzapw/awesome-omni-skill

Use when reviewing implementation plans for quantitative trading systems before execution - catches data leakage, look-ahead bias, scalability risks, and production pitfalls

multi-model-reviewer

16
from diegosouzapw/awesome-omni-skill

協調多個 AI 模型(ChatGPT、Gemini、Codex、QWEN、Claude)進行三角驗證,確保「Specification == Program == Test」一致性。過濾假警報後輸出報告,大幅減少人工介入時間。

ethics-reviewer

16
from diegosouzapw/awesome-omni-skill

This skill should be used when the user mentions "dark patterns", "accessibility", "a11y", "privacy", "tracking", "analytics", "notifications", "user data", "GDPR", "consent", "manipulation", "sustainability", "performance budget", or when building user-facing features that collect data, send notifications, display urgency, or gate access. Addresses ethical constraints in software design — manipulation, accessibility, privacy, and sustainability.

codex-reviewer

16
from diegosouzapw/awesome-omni-skill

Use OpenAI's Codex CLI as an independent code reviewer to provide second opinions on code implementations, architectural decisions, code specifications, and pull requests. Trigger when users request code review, second opinion, independent review, architecture validation, or mention Codex review. Provides unbiased analysis using GPT-5-Codex model through the codex exec command for non-interactive reviews.

code-reviewer

16
from diegosouzapw/awesome-omni-skill

Elite code review expert specializing in modern AI-powered code analysis, security vulnerabilities, performance optimization, and production reliability. Masters static analysis tools, security scanning, and configuration review with 2024/2025 best practices. Use PROACTIVELY for code quality assurance.

banking-domain-reviewer

16
from diegosouzapw/awesome-omni-skill

Code review agent with banking domain knowledge — validates business flows, compliance requirements, double-entry accounting, payment processing, and regulatory patterns in the Firefly Banking Platform

architect-reviewer

16
from diegosouzapw/awesome-omni-skill

Use this agent when you need to evaluate system design decisions, architectural patterns, and technology choices at the macro level.

aidf-reviewer

16
from diegosouzapw/awesome-omni-skill

Code reviewer focused on quality, consistency, and maintainability. Provides constructive, actionable feedback with rationale.

agent-native-reviewer

16
from diegosouzapw/awesome-omni-skill

Use this agent when reviewing code changes to ensure features are agent-native - any action a user can take, an agent can also take, and anything a user can see, an agent can see. Triggers on requests like "agent-native review", "AI accessibility check".

agent-code-reviewer

16
from diegosouzapw/awesome-omni-skill

Expert code reviewer specializing in code quality, security vulnerabilities, and best practices across multiple languages. Masters static analysis, design patterns, and performance optimization with focus on maintainability and technical debt reduction.