
paper-review
Guides self-review of YOUR OWN academic paper before submission with adversarial stress-testing. Core method: three passes (adversarial deep read; 5-aspect checklist — contribution sufficiency, writing clarity, results quality, testing completeness, method design; mechanical consistency scans and experimental protocol audit of data flow, assumptions, leakage), counterintuitive protocol (reject-first simulation, delete unsupported claims, score trust, promote limitations, attack novelty), reverse-outlining, and figure/table quality checks. Use when: user wants to self-review or self-check their own paper draft before submission, stress-test their claims, prepare for reviewer criticism, or mentions 'self-review', 'check my draft', 'is my paper ready'. Do NOT use for writing a peer review of someone else's paper, and do NOT use after receiving actual reviews (use paper-rebuttal instead). Also runs as a background expert: dispatch it async with a draft path and it reviews end-to-end while
- Installs
- 509
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/evoscientist/evoskills --skill paper-review- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads paper-review automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Paper Review
A systematic approach to self-reviewing academic papers before submission, run as three passes: an adversarial deep read, a checklist sweep (5 aspects, reverse-outlining, figure/table quality), and mechanical consistency scans plus an experimental protocol audit. Ends with rebuttal preparation.
When to Use This Skill
- User wants to review or check a paper draft before submission
- User asks for feedback on paper quality or completeness
- User wants to prepare for potential reviewer criticism
- User mentions "review paper", "check my draft", "self-review"
If the user has already received reviewer comments and needs to write a rebuttal, use the
paper-rebuttalskill instead.
Prerequisites
Before starting review, confirm the paper-writing handoff checklist is satisfied: all sections drafted, claims anchored to evidence, limitation section present, figures finalized, and no unresolved \todo{} markers. If any item is incomplete, finish writing before reviewing.
How to Run the Review: Three Passes
Run the review as three separate passes, in this order, and merge findings only at the end. Do not start from the checklists: a checklist primes you to see only what it names, and the flaws that kill papers in review are often the ones no checklist question points at.
Pass 1 — Adversarial deep read (checklists closed)
Read the paper end-to-end as a skeptical expert reviewer, before consulting any checklist in this skill. Chase cross-section threads as you read:
- Does the evidence actually support each claim at the place it is made?
- Does an assumption stated in the setup ever get revisited — or quietly violated — later?
- Do the numbers quoted in prose match the tables? Does the conclusion deliver what the abstract promised?
- Would this method survive outside the paper's exact setting?
Write down every suspicion with its location, including ones you cannot yet prove — see Calibrated Suspicion below for how to phrase and mark them. This pass is where hidden, cross-section flaws surface; no checklist replaces it.
Pass 2 — Checklist sweep
Now work through the structured materials: the 5-aspect checklist, the counterintuitive protocol, reverse-outlining, and the figure/table and conclusion checks. This pass buys breadth and catches the known, frequent failure patterns.
Pass 3 — Mechanical scans and protocol audit
Execute the Experimental Protocol Audit and the Mechanical Consistency Scans (both below) explicitly, using search/cross-referencing over the source files. The scans are search problems and the audit is a line-by-line reconstruction of the setup; both have a high hit rate — and "reading carefully" never triggers them on its own.
Merge
Union the findings of all three passes and deduplicate. A Pass-1 suspicion that no checklist item names still ships, under the confidence rules below — deduplication removes repeats, not doubts.
Reporting Findings: Calibrated Suspicion
A review finding contains two kinds of statements, with different rules:
- Factual assertions about the paper — what a table contains, what a section says, whether something is present or absent. These must be verifiable: check the text before asserting, and anchor the finding to an exact location or short quote. Never state that the paper says something it does not — one fabricated criticism costs more credibility than ten valid ones buy.
- Suspicions and judgments — "these gains may be within seed noise", "this assumption looks unrealistic in deployment". These are allowed and encouraged, including at low confidence. Phrase them as what they are: state the suspicion, mark the confidence, and name what evidence would settle it ("no variance is reported; 3 seeds would settle this").
Do not suppress a suspicion because you cannot prove it. In self-review, a hidden flaw that survives to the real reviewers costs far more than a raised-and-then-cleared suspicion. Precision discipline applies to facts, not to doubts.
The Perfectionist Approach
Strive for perfection: review your own paper, consider every question a reviewer might ask, and address them one by one.
The best defense against negative reviews is a thorough self-review:
- Adversarial review: Read your own paper as a critical reviewer would
- Seek advisor feedback: Ask your advisor to review — the more feedback, the better
- Address everything: For every potential weakness you find, either fix it or prepare a defense
Counterintuitive Review Protocol
Run this protocol before final polishing:
- Reject-first simulation: Force yourself to write a one-paragraph reject summary before writing any positive comments.
- Delete one unsupported strong claim: If a strong claim lacks direct evidence, remove it instead of defending it.
- Score trust, not only score gains: Papers with slightly lower gains but higher fairness and reproducibility often receive better review outcomes.
- Promote one explicit limitation: Move one meaningful limitation from hidden notes into the paper; transparency can increase confidence.
- Attack your novelty claim: Ask "Could a strong PhD derive this in one afternoon?" If yes, narrow and sharpen the novelty statement.
See references/counterintuitive-review.md
5-Aspect Self-Review Checklist
Aspect 1: Contribution Sufficiency
The paper does not provide readers with new knowledge.
Ask these questions to evaluate whether the contribution is sufficient:
- Are the failure cases common? If the failure cases are frequent and obvious, reviewers may question whether the method is ready for publication.
- Is the proposed technique well-explored? If the technique is already widely studied, what new insight or improvement do we bring?
- Is the improvement foreseeable / well-known? If the improvement was predictable from combining known ideas, the novelty may be questioned.
- Is the technique too straightforward? A straightforward application of existing techniques may lack sufficient contribution.
Red flag: If "yes" to any of these, strengthen the contribution narrative or add more technical depth.
Aspect 2: Writing Clarity
Missing technical details, not reproducible; a method module lacks motivation.
- Missing technical details? Would a reader be able to reproduce the method from the paper alone?
- Missing module motivation? Does every module in the Method section explain why it exists, not just what it does?
- Paragraph structure: Does each paragraph have a clear topic? Does the first sentence state the point?
- Flow: Is the logical flow between paragraphs and sections smooth?
- Terminology: Are terms used consistently throughout?
Red flag: If reproducibility is in doubt, add implementation details or supplementary material.
Aspect 3: Experimental Results Quality
Only slightly better than previous methods; or better than previous methods but still not good enough.
- Marginal improvement? If the improvement over SOTA is very small, is it statistically significant?
- Absolute quality insufficient? Even if better than baselines, is the output quality good enough for the application?
- Visual quality: Do qualitative results look convincing? Are improvements visible?
Red flag: If improvements are marginal, emphasize other advantages (speed, generalizability, simplicity) or add more challenging test cases.
Aspect 4: Experimental Testing Completeness
Missing ablation studies; missing important baselines; missing important evaluation metrics; data too simple.
- Missing ablation studies? Is every core contribution ablated?
- Missing important baselines? Are recent SOTA methods included?
- Missing evaluation metrics? Are all standard metrics for this task reported?
- Datasets too simple? Do the benchmarks truly test the method's capabilities?
- No failure case analysis? Honest failure analysis increases credibility.
Red flag: Missing ablations or baselines is one of the most common reasons for rejection.
Aspect 5: Method Design Issues
Experimental setting is impractical; method has technical flaws; method is not robust; new method's costs outweigh its benefits.
- Impractical experimental setting? Are assumptions realistic for the intended use case?
- Technical flaws? Does the method have theoretical or conceptual weaknesses?
- Not robust? Does the method require per-scene hyperparameter tuning?
- Benefit < Limitation? Does the new module introduce limitations that outweigh its benefits?
Red flag: If the method requires significant tuning per scenario, add robustness experiments or acknowledge and address the limitation.
Experimental Protocol Audit
The most damaging experimental flaws hide in single sentences of the setup — stated once, never revisited. Audit the experimental section line by line as a hostile auditor, not a reader:
- Reconstruct the data flow. From the text alone, write out: what was trained on what, tuned on what, evaluated on what. Any overlap between test data and training/tuning data — including a phrase like "hyperparameters tuned on the test split" buried in the setup — is a major finding. If split hygiene cannot be reconstructed from the text at all, that is itself a finding.
- List every assumption. Search the method and setup for "we assume", "assuming", "provided that", "given access to". For each: is it realistic at deployment time, and is its impact discussed anywhere downstream? A strong assumption stated once and never mentioned again is a major finding.
- Check information availability. Does the method consume anything at inference time that would not exist in practice — labels, oracle signals, future information, test-distribution statistics?
- Check the comparison protocol. Same data, same compute budget, same tuning effort for all baselines? Are baseline numbers reproduced under this paper's setup, or copied from papers with different setups?
Critical Reminder: Claims Must Have Support
Every claim in the paper (especially in the Abstract and Introduction) must be correct and supported by experiments. Some reviewers will reject a paper directly for unsupported claims.
Go through every claim in the Abstract and Introduction. For each claim:
- Is it factually correct?
- Is there an experiment or analysis that supports it?
- Is the supporting experiment clearly referenced?
An unsupported claim — especially in the Abstract or Introduction — can be grounds for rejection.
Reverse-Outlining Technique
Extract the writing plan from finished paragraphs and check whether the flow is smooth.
After writing a section (or the entire paper):
- Read each paragraph one at a time
- Write down the main message of each paragraph in one sentence
- Read the sequence of messages — does it flow logically?
- Identify breaks: Where does the flow feel abrupt or illogical?
- Fix: Reorganize paragraphs, add transitions, or split/merge paragraphs
Apply this to:
- Introduction (check narrative flow)
- Method (check if modules are presented in logical order)
- Experiments (check if results are presented in a meaningful sequence)
Figure and Table Quality Checklist
Figures
- Pipeline figure highlights novelty (not just explanation)
- Pipeline figure looks distinct from prior work
- Teaser figure is compelling and self-contained
- All figures have clear captions
- Resolution is high enough for print
- Color-blind friendly (avoid red-green only distinctions)
- Figures are referenced in the text
Tables
- Captions are above the table
- No vertical lines
- Using booktabs (
\toprule,\midrule,\bottomrule) - Best results highlighted (bold/color)
- Metric direction indicated (↑/↓)
- Captions describe setup/notation, not results
- All tables are referenced in the text
Conclusion and Limitation Check
- Conclusion summarizes contributions and key results
- Limitation section is present (reviewers frequently flag its absence)
- Limitations are framed as task/setting scope (like future work) where that is honest
Beating SOTA does not retire a technical defect. A leak, an unfair comparison, or an unsupported claim stays a defect at any metric level — record it as a finding, not as a limitation. Scope framing is for genuine boundaries of the work, not a place to file problems.
- Limitations are honest but not self-defeating
Mechanical Consistency Scans
Pass 3 runs these against the source files (rationale under Pass 3 above):
- Promise–delivery alignment. List the contributions promised in the abstract and introduction (especially numbered contribution lists). For each, find the section/experiment that delivers it and its echo in the conclusion. A contribution promised up front that silently disappears by the conclusion is a finding.
- Claimed-but-missing comparisons. Any method the paper itself calls "directly comparable", "closest prior work", or state-of-the-art must appear in the results tables — or the paper must say why not. Admitted in related work but absent from experiments is a finding.
- Numeric consistency. Every number quoted in the abstract, introduction, or conclusion must match its source table. Recompute claimed improvements ("X% better", "reduces Y by Z"). Prose interpretation must match the table — "substantially better" backed by a 0.1-point gap is a finding.
Four more scans belong to this pass but their criteria already live elsewhere in this file — run them here as searches rather than restating them: citation integrity and leftover markers (criteria in Pre-Submission Final Checks below), module motivation (criterion in Aspect 2), and the mechanical half of the table/figure checks (criteria in the Figure/Table section above — here, additionally verify the bolded "best" value actually is the best in each column and that arrows match metric direction). Pass 2 may already have flagged some of these by reading; this pass settles them by search, so report each problem once.
Pre-Submission Final Checks
- All references are complete (no "?" or missing entries)
- Author information matches venue requirements
- Page count is within limits
- Supplementary material is properly referenced
- No TODO markers remain in the paper
- Acknowledgments section is appropriate
- No accidental double-blind violations (for anonymous review)
- All cited works have complete bibliographic entries (authors, title, venue, year)
- No self-citations that break anonymity (for double-blind venues)
- Key related works cited — missing a prominent baseline paper can trigger rejection
Handoff to Rebuttal
When reviews come back, use the paper-rebuttal skill for:
- Score diagnosis and review color-coding
- Champion strategy (arming your positive reviewer for discussion)
- 18 tactical rules for structure, content, and tone
- Counterintuitive rebuttal principles
Your self-review artifacts (reject-first simulation, claim-evidence audit, prebuttal drafts from the counterintuitive protocol) feed directly into the rebuttal process.
See references/review-checklist.md for an expanded version of the 5-aspect checklist with more detailed sub-questions.
For adversarial stress testing and reject-risk thresholds, see references/counterintuitive-review.md.
The 5-aspect pass is also available as an executed workflow:
scripts/five_aspect_review.js — load it into
the code interpreter and call await fiveAspectReview(draftText) to run the
five aspects as parallel sub-reviews with typed results (score, findings,
blocking issues per aspect) and a synthesized verdict. Prefer it over
re-deriving the fan-out in prose; fall back to the sequential checklist above
only if the interpreter is unavailable.
Pass 3's mechanical scans are search problems, not comprehension problems —
collecting every citation key, sweeping \todo/TODO/FIXME across paper,
appendix and bib, recomputing claimed improvements. Run them through the
interpreter; if it is unavailable, say so in the review rather than implying
full coverage.
FAQ
What does the paper-review skill do?
Guides self-review of YOUR OWN academic paper before submission with adversarial stress-testing. Core method: three passes (adversarial deep read; 5-aspect checklist — contribution sufficiency, writing clarity, results quality, testing completeness, method design; mechanical consistency scans and experimental protocol audit of data flow, assumptions, leakage), counterintuitive protocol (reject-first simulation, delete unsupported claims, score trust, promote limitations, attack novelty), reverse-outlining, and figure/table quality checks. Use when: user wants to self-review or self-check their own paper draft before submission, stress-test their claims, prepare for reviewer criticism, or mentions 'self-review', 'check my draft', 'is my paper ready'. Do NOT use for writing a peer review of someone else's paper, and do NOT use after receiving actual reviews (use paper-rebuttal instead). Also runs as a background expert: dispatch it async with a draft path and it reviews end-to-end while
How do I install paper-review?
Run npx skills add https://github.com/evoscientist/evoskills --skill paper-review in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/paper-review/ (personal) or .claude/skills/paper-review/ (project).
Which AI agents can use paper-review?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is paper-review safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains paper-review?
It is published by evoscientist in evoscientist/evoskills. It has 509 recorded installs.
More from evoscientist/evoskills
paper-writing
evoscientist/evoskills
Guides writing academic papers section by section using an 11-step workflow with LaTeX templates and counterintuitive writing tactics. Covers Abstract, Introduction, Method, Experiments, Related Work, Conclusion, and Supplementary. Use when: user asks to write or draft a paper section, needs LaTeX templates, wants to improve academic writing quality, optimize novelty framing, or mentions 'write introduction', 'draft method', 'paper writing'. Do NOT use for pre-submission review (use paper-review), experiment execution (use experiment-pipeline), or paper planning/story design (use paper-planning).
research-ideation
evoscientist/evoskills
End-to-end research ideation pipeline: literature grounding → multi-track idea generation (3 personas: innovator/pragmatist/critic) → iterative refinement → ELO tournament ranking → update evo-memory (IDE) → user selects direction → expand into manuscript-quality proposal. Use when: user wants to find a research direction, brainstorm ideas, evaluate idea novelty, design a novel solution, rank/compare research ideas, or generate a research proposal. Do NOT use for finding/searching/reading papers (use paper-navigator), literature survey reports (use research-survey), or planning a paper (use paper-planning).
academic-slides
evoscientist/evoskills
Use this skill for creating or refining an academic slide deck and the talk built around it: structuring a conference talk, thesis defense, lab meeting, or paper-to-slides deck; deciding the narrative arc and slide breakdown; improving slide design and visual hierarchy; planning rehearsal, timing, Q&A, and backup slides; or generating the .pptx. Reach for it when the user is shaping the presentation itself. Do not use for writing the paper, producing standalone speaker notes/scripts/transcripts, making posters, creating isolated figures/charts outside a slide deck, or building non-academic presentations.
paper-rebuttal
evoscientist/evoskills
Guides writing effective rebuttals after receiving peer review feedback. Covers review diagnosis (score-driven color-coding), response strategy (champion identification, common-theme consolidation), tactical writing (18 rules), and counterintuitive rebuttal principles. Use when: user received reviewer scores/comments, needs to write a rebuttal or author response, wants to respond to specific criticism (e.g. 'limited novelty', 'missing baselines'), mentions 'rebuttal', 'reviewer comments', 'author response', or 'respond to reviewers'. Do NOT use for pre-submission self-review (use paper-review instead).
paper-planning
evoscientist/evoskills
Guides pre-writing planning for academic papers with 4 structured steps: story design (task-challenge-insight-contribution-advantage), experiment planning (comparisons + ablations), figure design (pipeline + teaser), and 4-week timeline management. Includes counterintuitive planning tactics (write a mock rejection letter to identify weaknesses before writing, narrow before broad claims, design ablations first). Use when: user wants to plan a paper before writing, design story/contributions, plan experiments, create figure sketches, set a writing timeline, or write a pre-emptive rejection letter for planning purposes. Do NOT use for actual writing (use paper-writing), running experiments (use experiment-pipeline), self-reviewing a finished draft (use paper-review), or finding research problems (use research-ideation).
experiment-pipeline
evoscientist/evoskills
Guides structured 4-stage experiment execution with attempt budgets and gate conditions: Stage 1 initial implementation (reproduce baseline), Stage 2 hyperparameter tuning, Stage 3 proposed method validation, Stage 4 ablation study. Integrates with evo-memory (load prior strategies, trigger IVE/ESE) and experiment-craft (5-step diagnostic on failure). Use when: user has a planned experiment, needs to reproduce baselines, organize experiment workflow, or systematically validate a method. Do NOT use for debugging a specific experiment failure (use experiment-craft) or designing which experiments to run (use paper-planning).
Popular education & science skills
teach
mattpocock/skills
Teach the user a new skill or concept, within this workspace.
scaffold-exercises
mattpocock/skills
Create exercise directory structures with sections, problems, solutions, and explainers that pass linting. Use when user wants to scaffold exercises, create exercise stubs, or set up a new course section.
paper-context-resolver
lllllllama/rigorpilot-skills
Rigor Paper Context helper for README-first deep learning repo reproduction. Use only when the README and repository files leave a narrow reproduction-critical gap and the task is to resolve a specific paper detail such as dataset split, preprocessing, evaluation protocol, checkpoint mapping, or runtime assumption from primary paper sources while recording conflicts. Do not use for general paper summary, repo scanning, environment setup, command execution, title-only paper lookup, or replacing README guidance by default.
caveman-learn
juliusbrussee/caveman
Act on a Caveman learn report - review the ranked token sinks, apply cost-lowering fixes with per-edit consent, and report what those fixes returned. Use when asked to lower an agent's token cost, what caveman has saved, to trim a heavy CLAUDE.md, or to offload re-pasted context into cavemem.
gsap-plugins
greensock/gsap-skills
Official GSAP skill for GSAP plugins — registration, ScrollToPlugin, ScrollSmoother, Flip, Draggable, Inertia, Observer, SplitText, ScrambleText, SVG and physics plugins, CustomEase, EasePack, CustomWiggle, CustomBounce, GSDevTools. Use when the user asks about a GSAP plugin, scroll-to, flip animations, draggable, SVG drawing, or plugin registration.
teach-impeccable
pbakaus/impeccable
DEPRECATED: Use /impeccable teach instead. This command has been folded into the impeccable skill.