paperreview — Claude Code skill: send a paper PDF to paperreview.ai
Uploads a paper PDF to paperreview.ai over HTTP and fetches the finished review by token. No browser in the loop.
no license ★ 475 updated 2026-10-13
npx skills add cnfjlhj/ai-collab-playbook --skill paperreview -a claude-codeWhat paperreview does
The skill follows the site's own three steps: it asks for a temporary upload link, pushes the PDF into S3, then confirms so processing starts and a token is issued. A small Python script, scripts/submit_http.py, does the work, so nothing opens a browser.
--submit is the point of no return. It files a real submission and returns a token you cannot regenerate later. Run --dry-run first to see what the script validates without any network call. Your email is not baked in anywhere, so pass it with --email and set the venue with --venue. After a successful submit the token is written beside the PDF as <pdf>.paperreview.token.txt unless you add --no-token-file.
scripts/watch_review.py polls GET /api/review/<token> every 10 minutes for up to 48 hours. A 202 means the job is still running, 200 means the review is ready; you get a timestamped raw JSON dump and a readable Markdown copy next to the PDF. --once does a single check for debugging or cron.
What it helps with
- Send a near-final PDF out for an outside review without a browser
- See what the script checks before anything leaves your machine
- Pull the finished review by token and keep it beside the paper
- Poll the review endpoint on a schedule without losing the result
- Keep your email address out of repo defaults
Example prompts for the agent
- Dry-run
paper.pdffirst and show me what the script checked, without submitting anything. - Submit
paper.pdfto paperreview.ai for the ICLR venue; I'll give you the email address to use. - Start
scripts/watch_review.pyonpaper.pdfand tell me when the review files appear.
How to install paperreview
1Skills CLI (Vercel)
npx skills add cnfjlhj/ai-collab-playbook --skill paperreview -a claude-code2Manually: put the files in place
~/.claude/skills/paperreview/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/paperreview/
1Skills CLI (Vercel)
npx skills add cnfjlhj/ai-collab-playbook --skill paperreview -a codex2Manually: put the files in place
.agents/skills/paperreview/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add cnfjlhj/ai-collab-playbook --skill paperreview -a cursor2Manually: put the files in place
.cursor/skills/paperreview/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install cnfjlhj/ai-collab-playbook skills/full/paperreview2Manually: put the files in place
.github/skills/paperreview/SKILL.md1Skills CLI (Vercel)
npx skills add cnfjlhj/ai-collab-playbook --skill paperreview -a gemini-cli2Platform CLI
gemini skills install https://github.com/cnfjlhj/ai-collab-playbook --path skills/full/paperreviewManually: put the files in place
.devin/skills/paperreview/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about paperreview
How do I install paperreview in Claude Code?
Run npx skills add cnfjlhj/ai-collab-playbook --skill paperreview -a claude-code. The skill lands at ~/.claude/skills/paperreview/SKILL.md.
What does paperreview do?
It pushes a paper PDF to paperreview.ai through the site's own HTTP flow and hands back a token. That token is how you pull the review later.
What do I need before submitting?
Python, plus your own email address via --email since no fixed one ships with the public version. Start with --dry-run to check the file.