This repository is designed to work with both Claude Code and Codex while preserving the original proofreading philosophy.
The detailed instructions live in the prompts/ folder. You can use them directly in a session, or copy/merge them into Codex-oriented workspace instructions such as AGENTS.md. For PhD theses in robotics, use prompts/04_thesis_proofreading.md.
The workflow remains two-phase: the agent detects and lists all issues with unique numbers [1], [2], [3]..., then waits. The user selects which issues to fix or discard before any file is modified.
These prompts are distilled from years of hands-on paper reviewing and mentoring experience by Hyungtae Lim, a researcher in robotics and 3D perception.
- 📝 Associate Editor, IEEE Robotics and Automation Letters (RA-L)
- 🌟 RSS Pioneer 2024
- 🎖️ ICRA 2025 Outstanding Reviewer — selected from 7,400+ reviewers
- 📄 Conducted 100+ paper reviews across top robotics and CV venues
The review rules in these prompts reflect the standards expected at top robotics and computer vision venues, refined through real paper reviews and publications across ICRA, IROS, RSS, CVPR, ICCV, NeurIPS, AAAI, RA-L, T-RO, IJRR, T-PAMI, T-IV, etc.
LaTeX infrastructure audit — detailed checklist for workspace-level errors before submission.
| Check | Description |
|---|---|
| C1 | Preamble configuration (hyperref, cleveref, caption setup) |
| C2 | Package load order & conflicts |
| C3 | Macro safety, \methodname consistency, subscript macros, \etalcite |
| C4 | Cross-reference consistency (multi-ref, subcaption Fig. 5(a) format) |
| C5 | Label naming conventions, duplicate labels |
| C6 | Citation & bibliography integrity, duplicate BibTeX keys |
| C7 | Figure & table safety (missing files, dummy figures, label placement) |
| C8 | Hidden human errors (TODOs, inconsistent naming, \vspace hacks) |
| C9 | Academic writing patterns detectable in source (\ie, \eg, units) |
Paper content proofreading — detailed checklist for strict conference-level review.
| Category | Description |
|---|---|
| A | Language & grammar, tense consistency, Related Work tense |
| B | Language quality & awkward expression: typos, nominalization, filler phrases, citation-as-noun style |
| C | Scientific clarity: overclaiming, "significantly", unsupported claims |
| D | Structure & flow: intro claims, experiment purpose, equation narrative |
| E | Figure/table/caption review: self-containedness, reference order, quantitative consistency |
| F | LaTeX formatting: units, thousand separators, \ie/\eg macros |
| G | Abstract (WHY→PROBLEM→HOW→RESULTS) & conclusion quality |
| H | Notation consistency: symbol overload, boldface vectors, coordinate frames |
| I | Hyphenation: compound adjectives, -ly adverb rule |
PhD thesis proofreading (robotics) — the paper checklist extended with checks for long, multi-chapter documents, from the perspective of an external examiner.
| Category | Description |
|---|---|
| A | Thesis architecture: T-structure, chapters building on each other, research question traceability, consistent chapter structure |
| B | Chapter-level structure: chapter introductions and summaries, equation narrative, experiment purpose, real-robot validation |
| C | Paragraph flow and motivation reminders: paragraph logic, signposting, stale cross-references |
| D | Standalone and adjacent-field readability |
| E | Cross-chapter consistency and contradictions: claims, numbers, names, spelling variant, "we" vs "I" |
| F | Abbreviations across a long document: re-introduction after long gaps, per-chapter expansion, list of abbreviations |
| G | Heading hierarchy and casing: Title Case vs Sentence case, no lone subsections, stacked headings |
| H | Literature review coverage of every technical chapter, gaps, currency |
| I–P | Paper checks adapted to theses: language, paper leftovers ("in this paper"), claims, captions (short captions, attribution of reused figures), LaTeX, abstract/intro/conclusion, notation, hyphenation |
| Q | Front matter, back matter, and bibliography: statements of contribution, publication notices, appendices |
There are two supported ways to use this repository.
git clone https://github.com/LimHyungTae/awesome-claudecode-paper-proofreading.git ~/awesome-claudecode-paper-proofreadingThese prompts are used from inside your paper workspace, not from inside this repository.
The @ file reference in Claude Code resolves paths relative to the directory where claude is launched.
cd /path/to/your/paper
claudeIn the Claude Code session, reference the prompt by its absolute path, then attach your paper files:
@~/awesome-claudecode-paper-proofreading/prompts/01_latex_workspace_review.md
@main.tex @shortcuts.tex
Provide the root .tex file and the compiled PDF. The prompt automatically instructs Claude to follow all \input{...} calls and read every included section file:
@~/awesome-claudecode-paper-proofreading/prompts/02_paper_proofreading.md
@main.tex @paper.pdf
Why the PDF? The compiled PDF lets Claude cross-check two things invisible in source alone:
- Figure placement — figures displaced far from their in-text reference
- PDF-level annotations — leftover review comments not yet resolved
After Phase 1 output, respond with:
discard 3, 7, 12 ← skip specific issues
fix all critical ← fix only CRITICAL issues
proceed with all ← fix everything
For a PhD thesis, use the thesis prompt instead of the paper prompt in Step 3. Provide the root .tex file and the compiled PDF; the PDF is needed for page distances, the List of Figures, and figure placement:
@~/awesome-claudecode-paper-proofreading/prompts/04_thesis_proofreading.md
@thesis.tex @thesis.pdf
For long theses, thesis-level only and show chapter X only keep the review focused.
Copy the prompts/ directory into your paper or thesis workspace:
cp -R ~/awesome-claudecode-paper-proofreading/prompts /path/to/your/paper/Launch Codex from the workspace root and point it at the prompt you want:
Follow prompts/01_latex_workspace_review.md for `main.tex`.
or
Follow prompts/04_thesis_proofreading.md for `thesis.tex` and `thesis.pdf`.
- Detect first, fix later — the agent never modifies files until the user explicitly confirms
- Modular categories — each check is a labeled block; reorder or disable by editing the table at the top of each prompt
- Real-world patterns — rules extracted from annotated paper reviews across ICRA, RA-L, AAAI, BMVC, and CVPR submissions
- Non-native writer aware — covers patterns common in papers by Korean/Japanese researchers
figures/vspics/— distinguishes final manuscript figures from raw image sources
This setup also works in CI or other non-GUI environments as long as the agent runs from the paper workspace and sees the relevant instructions.
Recommended pattern:
- Check out your paper repository.
- Copy in
prompts/, or inline the prompt content into your workspace'sAGENTS.md. - Ask the agent to run the workspace review or proofreading pass.
- paper-writing-checklist — LaTeX workspace guidelines referenced by these prompts in Korean