review-paper

Reviews academic manuscripts via single-pass, adversarial, or simulated peer-review pipelines.

4|Updated Aug 22, 2025
One-click install
npx skills add https://github.com/stevejbickley/arcbita-geek-seminars --skill review-paper-stevejbickley
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: review-paper
Source: https://github.com/stevejbickley/arcbita-geek-seminars/tree/main/sessions/2026-07-29-ClaudeCodeforAppliedSocialScience/starter/.claude/skills/review-paper
Command: npx skills add https://github.com/stevejbickley/arcbita-geek-seminars --skill review-paper-stevejbickley

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Academic authors need rigorous, referee-quality feedback on manuscripts before journal submission, but real peer review is slow and unpredictable. This Skill produces comprehensive manuscript reviews across six dimensions (argument, identification, econometrics, literature, writing, presentation) and can simulate an entire editorial pipeline calibrated to a target journal. ## Core Features & Use Cases - Three review modes: single-pass report for early drafts, --adversarial critic-fixer loop (max 5 rounds) that proposes and applies edits until approval, and --peer <journal> simulated peer review with an editor plus two dispositioned referees. - Journal calibration and variance analysis: referee dispositions are sampled from a 6-way taxonomy (STRUCTURAL, CREDIBILITY, MEASUREMENT, POLICY, THEORY, SKEPTIC), with --variance N producing a decision distribution, --stress running a hostile-editor gauntlet, and --r2/--r3 handling revise-and-resubmit rounds. - Cross-artifact verification: automatically invokes code review and reproducibility audits on referenced analysis scripts, and verifies editor novelty-probe claims before they enter the desk-review narrative. - Use Case: Before submitting to the QJE, run a simulated peer review with --peer QJE --variance 3 to get a decision distribution and concern-frequency table showing which criticisms are robust versus disposition-dependent. ## Quick Start Ask the AI to review your manuscript file, for example: review my paper at drafts/paper.tex in peer-review mode calibrated to AER with variance set to 3 referees.

Frequently Asked Questions about review-paper

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I simulate peer review for a specific journal before submitting?▼

Run the skill in peer mode with the target journal short name, for example --peer AER. It loads the journal profile, runs an editor desk review, then two blind referees with different dispositions, and finishes with an editorial decision letter.

What is the difference between adversarial mode and peer-review mode?▼

Adversarial mode runs one critic-fixer loop up to 5 rounds, applying approved edits until the critic approves. Peer mode simulates distinct personas (editor plus two dispositioned referees) blind to each other, producing a decision letter rather than iterative fixes.

How do I estimate reviewer-disposition variance in a paper decision?▼

Use --peer with --variance N (default 3, max 5). It samples N independent referee dispositions, runs each in an isolated context, and reports a decision distribution plus a concern-frequency table separating robust criticisms from disposition-dependent ones.

Can the review check my analysis code and reproducibility too?▼

Yes. Unless --no-cross-artifact is set, it auto-invokes code review on referenced R scripts and a reproducibility audit on the manuscript outputs, merging critical findings into a Cross-Artifact Findings section of the report.

When should I not use adversarial mode on a manuscript?▼

Avoid it for early exploratory drafts where ideas are still forming, papers without compilable source, or when you want a single independent opinion. Adversarial mode enforces critic sign-off semantics, which forces premature polish.

Does the simulated peer review work for non-economics fields?▼

The pipeline is field-agnostic; only calibration data changes. Copy the journal-profile template into journal-profiles.md and extend the referee paper-type list for fields like biology, finance, or political science.