reviewing-my-paper

reviewing-my-paper

A Claude Code plugin that runs a multi-lens review of your own academic paper and delivers the feedback as an annotated PDF (highlights + sticky notes), not just prose.

It layers five independent review lenses and adversarially verifies its own findings before presenting them:

1. Multi-perspective peer review — Editor-in-Chief + 3 reviewers + Devil's Advocate (via the academic-research-skills plugin).
2. Citation-hallucination check — every reference web-verified for existence + metadata; classified VERIFIED / SUSPECT / NOT_FOUND.
3. Argument / logical flow — motivation → method → claim chain, claim–evidence alignment, overclaims.
4. Academic-English discourse flow — CARS intro moves, general→specific (summary then specification), topic-sentence-first paragraphs, section-opener signposting.
5. Grammar / copy-edit — genuine prose errors only (ignores PDF-extraction artifacts).

The result is written to <paper>_reviewed.pdf with color-coded annotations (🔴 critical · 🟠 major · 🔵 minor · 🟢 strength · 🟣 copy-edit).

---

Requirements

• Claude Code with plugin support.
• Python 3 available on PATH (the annotation tool uses PyMuPDF; the skill auto-creates a venv and installs it if missing).
• Dependency plugin: academic-research-skills — this plugin invokes its academic-paper-reviewer skill. You must install it first (see step 1 below). It lives in a separate marketplace, so it is not auto-installed.

---

Install

Run these inside Claude Code (the leading / commands are Claude Code slash commands).

1. Install the dependency plugin first (academic-research-skills):

/plugin marketplace add Imbad0202/academic-research-skills
/plugin install academic-research-skills

2. Install this plugin:

/plugin marketplace add pengyizhou/claude-plugins
/plugin install reviewing-my-paper@yizhou-tools

3. Reload plugins:

/reload-plugins

reviewing-my-paper@yizhou-tools — the part after @ is the marketplace name (the name field in .claude-plugin/marketplace.json). If you rename the marketplace, keep this in sync.

---

Usage

In any session, just ask:

review my paper /path/to/paper.pdf

or invoke the skill explicitly:

/reviewing-my-paper:reviewing-my-paper

Claude will extract the PDF, run the five lenses (in parallel where possible), self-verify the findings, annotate the PDF, and send back paper_reviewed.pdf plus a summary. Ask for a consolidated P0/P1/P2 revision plan if you want one.

Standalone annotation tool

The bundled annotate_pdf.py can be used on its own — give it a findings JSON and it produces the annotated PDF:

python annotate_pdf.py --src paper.pdf --findings findings.json

findings.json is a list of {"page": <1-based>, "anchor": "<short unique text>", "severity": "<critical|major|minor|strength|copyedit|clarify>", "note": "<comment>"}.

---

Repository layout

claude-plugins/
├── .claude-plugin/
│   └── marketplace.json            # advertises the plugin(s)
├── reviewing-my-paper/             # the plugin
│   ├── .claude-plugin/
│   │   └── plugin.json
│   ├── README.md
│   └── skills/
│       └── reviewing-my-paper/
│           ├── SKILL.md
│           └── annotate_pdf.py
├── LICENSE
└── README.md

License

MIT — see LICENSE.