paper-review

Write peer reviews of academic manuscripts with error sweeps and filtered suggestions.

Updated Oct 7, 2022
One-click install
npx skills add https://github.com/tamagusko/linux-cfg --skill paper-review-tamagusko
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: paper-review
Source: https://github.com/tamagusko/linux-cfg/tree/main/dotfiles/claude/skills/paper-review
Command: npx skills add https://github.com/tamagusko/linux-cfg --skill paper-review-tamagusko

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Writing a peer review that is both thorough and disciplined is hard: reviewers either miss real errors or pad reviews with stock comments and preferences. This Skill produces reviews where every error is caught and every suggestion earns its place, in a consistent senior reviewer voice. ## Core Features & Use Cases - Systematic error sweep: Recomputes numbers, checks internal consistency, and covers statistics, machine learning, spatial methods, causal claims, reproducibility, and ethics using references/error_sweep.md. - Two-gate filtering: Errors pass unconditionally; suggestions are admitted only if a competent editor would not accept the paper without them, with worked admit/reject examples in references/filter_examples.md. - Voice and venue adaptation: Standardized verdict vocabulary, location-led comments with diagnosis plus fix, plain-text output for submission forms, and a distinct Brazilian Portuguese register for venues like ANPET via references/invariants.md. - Use Case: You receive a transportation journal manuscript to referee. The Skill reads the full paper, recomputes its tables, lists every error with locations and fixes, filters suggestions down to the load-bearing ones, and outputs a plain-text review with a standardized recommendation line. ## Quick Start Review this manuscript PDF and write my referee report for the journal, including a recommendation line and numbered comments.

Frequently Asked Questions about paper-review

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

FAQPage Schema
How do I write a peer review for a journal manuscript?

Read the full manuscript first, then sweep for errors by recomputing every number and checking internal consistency. Filter suggestions by asking whether a competent editor would accept the paper without each one, then write location-led comments pairing each diagnosis with a fix.

How to handle a revision round review of a rebuttal?

Check the rebuttal against the previous review point by point and state for each whether it was actually addressed. A brief courtesy opening or closing is allowed on revision rounds, but it must never substitute for a verdict.

Can I write referee reports in Brazilian Portuguese?

Yes, the Skill supports Brazilian Portuguese for venues like ANPET using an impersonal third-person register, not translated English. It uses constructions like "Recomenda-se ajustar" and verdicts such as Recomendado or Não recomendado.

What kinds of errors does a manuscript review check?

The sweep covers recomputed arithmetic and statistics, internal consistency, ML train/test leakage, spatial autocorrelation and MAUP, causal identification, reproducibility, and ethics. Errors are admitted unconditionally regardless of severity, including typos.

When should a reviewer comment be cut from a review?

Cut any suggestion a competent editor would let the paper keep, such as stock comments, style preferences, or citation requests that change no argument. A useful test is whether the comment could have been written before reading the paper.

What is the difference between paper-review and reviewing my own draft?

This Skill is only for refereeing someone else's manuscript. Reviewing your own draft belongs to paper-self-review, responding to reviewers belongs to review-response, and code review is out of scope entirely.