Peer review
A review's job is to tell the authors, and the editor, whether the evidence supports the
claims, and what would have to change if it does not. It is not a summary, not a list of
typos, and not an opinion about how interesting the topic is. Read everything, check
what can be checked, and separate what blocks from what would help.
Non-negotiables
- Read the whole artifact including appendices, supplementary tables, and code when it
is provided. A review of the first eight pages is not a review.
- Check, do not just read. Recompute a number when the inputs are there; rerun a
provided analysis; compare a figure to the table it summarizes; check that the test
matches the design (paired vs unpaired, multiple comparisons, dependence).
- BLOCKING or OBSERVATION, for every point. Blocking means the central claim is not
supported as written: leakage, a wrong test, an unfair baseline, a result that does not
appear in the data, a claim outside the study's scope. Observations improve the paper
but do not change whether it is right.
- Locate every issue. Section, page, table, figure, equation, line. "The statistics
are weak" is not a finding; "Table 2 reports p < 0.05 from a t-test on 3 seeds per
condition without correction across 12 comparisons" is.
- Calibrate. The recommendation follows from the blocking list, not from taste.
references/calibration.md and references/scoring-rubric.md define the scale.
- Constructive and specific. Each blocking issue names the fix or the experiment that
would resolve it. Tone stays neutral; the authors are colleagues.
Workflow
Claims. State what the paper claims to have shown, with the scope it claims (which
data, which conditions). Everything else is checked against this.
Evidence per claim. For each claim: which table, figure or theorem carries it; whether
the comparison is fair (same data, budget, tuning); whether the effect size clears the
variance (seeds, confidence intervals, n); whether the metric measures the claim; whether
a simpler explanation fits the same evidence.
Methods and statistics. Design matched to the question; randomization and controls;
sample size and power; the test's assumptions met; corrections for multiple comparisons;
leakage between train and test or between selection and evaluation; hyperparameter tuning
on the test set; reported variance. references/evidence-hierarchy.md for study designs,
references/common-biases.md and references/logical-fallacies.md for reasoning faults.
Figures and reporting. Every figure's claim visible without the prose; axes, units,
uncertainty; numbers in text equal to numbers in tables; reporting checklist for the field
(CONSORT, PRISMA, ARRIVE, the venue's reproducibility checklist).
Reproducibility. Code and data availability; enough detail to rerun; seeds; compute.
If code is attached, run the smallest thing that tests a central number.
An independent second read. When the artifact is long, the stakes are high, or your
own draft is under review, delegate one read to an explore worker (Task tool,
subagent_type: "explore") with the artifact paths, this skill's name to load, and the
specific angle: statistics, leakage, claims versus evidence. The worker is read-only; ask
it to report BLOCKING and OBSERVATION items. Merge its BLOCKING findings with yours; do not
average them away.
Report
## Summary
Three sentences: what the work claims, what it does, what the evidence shows.
## Blocking
1. [Section/Table] Issue. Why it undermines the claim. What would resolve it.
## Observations
- [Location] Suggestion.
## Recommendation
Accept / Minor revision / Major revision / Reject, with the one-sentence reason tied to the
blocking list. Confidence: high / medium / low, and why.
For the user's own draft, the same report, then the offer to fix the blocking items with
paper-writing. For grant review, references/reviewer-expectations.md covers criteria
and scoring conventions.
Before you hand it over
- Every issue has a location and a fix.
- The recommendation follows from the blocking list; a paper with no blocking issues is not
rejected for taste, and a paper with one is not accepted for polish.
- Numbers you recomputed are shown with your method.
- What you could not check is listed as unchecked, not assumed fine.
1---2name: peer-review3description: Reviews a manuscript, proposal, analysis or result the way a careful referee does, reading the whole artifact, checking the methods against the claims, the statistics against the design, the figures against the numbers, and reporting BLOCKING issues separately from observations, with a calibrated recommendation. Use for peer review, critical appraisal of a paper or claim, pre-submission review of the user's own draft, grant review, or evaluating research rigor. For fixing the text afterwards use paper-writing; for an independent second opinion delegate a read to an explore worker.4license: MIT5---67# Peer review89A review's job is to tell the authors, and the editor, whether the evidence supports the10claims, and what would have to change if it does not. It is not a summary, not a list of11typos, and not an opinion about how interesting the topic is. Read everything, check12what can be checked, and separate what blocks from what would help.1314## Non-negotiables15161. **Read the whole artifact** including appendices, supplementary tables, and code when it17 is provided. A review of the first eight pages is not a review.182. **Check, do not just read.** Recompute a number when the inputs are there; rerun a19 provided analysis; compare a figure to the table it summarizes; check that the test20 matches the design (paired vs unpaired, multiple comparisons, dependence).213. **BLOCKING or OBSERVATION, for every point.** Blocking means the central claim is not22 supported as written: leakage, a wrong test, an unfair baseline, a result that does not23 appear in the data, a claim outside the study's scope. Observations improve the paper24 but do not change whether it is right.254. **Locate every issue.** Section, page, table, figure, equation, line. "The statistics26 are weak" is not a finding; "Table 2 reports p < 0.05 from a t-test on 3 seeds per27 condition without correction across 12 comparisons" is.285. **Calibrate.** The recommendation follows from the blocking list, not from taste.29 `references/calibration.md` and `references/scoring-rubric.md` define the scale.306. **Constructive and specific.** Each blocking issue names the fix or the experiment that31 would resolve it. Tone stays neutral; the authors are colleagues.3233## Workflow3435- [ ] Read fully; write the paper's claims in your own words (three lines).36- [ ] For each claim: the evidence offered, and whether it supports the claim as worded.37- [ ] Methods and statistics check (`references/statistical-pitfalls.md`, `references/common-issues.md`).38- [ ] Figures, tables and reporting check (`references/paper-mechanics.md`, `references/reporting-standards.md`).39- [ ] Reproducibility and ethics check.40- [ ] Classify, calibrate, write the report.4142**Claims.** State what the paper claims to have shown, with the scope it claims (which43data, which conditions). Everything else is checked against this.4445**Evidence per claim.** For each claim: which table, figure or theorem carries it; whether46the comparison is fair (same data, budget, tuning); whether the effect size clears the47variance (seeds, confidence intervals, n); whether the metric measures the claim; whether48a simpler explanation fits the same evidence.4950**Methods and statistics.** Design matched to the question; randomization and controls;51sample size and power; the test's assumptions met; corrections for multiple comparisons;52leakage between train and test or between selection and evaluation; hyperparameter tuning53on the test set; reported variance. `references/evidence-hierarchy.md` for study designs,54`references/common-biases.md` and `references/logical-fallacies.md` for reasoning faults.5556**Figures and reporting.** Every figure's claim visible without the prose; axes, units,57uncertainty; numbers in text equal to numbers in tables; reporting checklist for the field58(CONSORT, PRISMA, ARRIVE, the venue's reproducibility checklist).5960**Reproducibility.** Code and data availability; enough detail to rerun; seeds; compute.61If code is attached, run the smallest thing that tests a central number.6263**An independent second read.** When the artifact is long, the stakes are high, or your64own draft is under review, delegate one read to an `explore` worker (Task tool,65`subagent_type: "explore"`) with the artifact paths, this skill's name to load, and the66specific angle: statistics, leakage, claims versus evidence. The worker is read-only; ask67it to report BLOCKING and OBSERVATION items. Merge its BLOCKING findings with yours; do not68average them away.6970## Report7172```markdown73## Summary74Three sentences: what the work claims, what it does, what the evidence shows.7576## Blocking771. [Section/Table] Issue. Why it undermines the claim. What would resolve it.7879## Observations80- [Location] Suggestion.8182## Recommendation83Accept / Minor revision / Major revision / Reject, with the one-sentence reason tied to the84blocking list. Confidence: high / medium / low, and why.85```8687For the user's own draft, the same report, then the offer to fix the blocking items with88paper-writing. For grant review, `references/reviewer-expectations.md` covers criteria89and scoring conventions.9091## Before you hand it over9293- Every issue has a location and a fix.94- The recommendation follows from the blocking list; a paper with no blocking issues is not95 rejected for taste, and a paper with one is not accepted for polish.96- Numbers you recomputed are shown with your method.97- What you could not check is listed as unchecked, not assumed fine.