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.
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
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/academic-reviewer/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How academic-reviewer Compares
| Feature / Agent | academic-reviewer | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/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
Best AI Skills for Claude
Explore the best AI skills for Claude and Claude Code across coding, research, workflow automation, documentation, and agent operations.
AI Agents for Coding
Browse AI agent skills for coding, debugging, testing, refactoring, code review, and developer workflows across Claude, Cursor, and Codex.
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
Review JusticeHub code against ACT ecosystem values. Enforces cultural protocols, ALMA principles, and regenerative design.
academic-writing-style
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
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
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
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
Search academic paper repositories (arXiv, Semantic Scholar) for scholarly articles in physics, mathematics, computer science, quantitative biology, AI/ML, and related fields
Academic Researcher
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
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
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
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
## Description
academic-letter-architect
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.