paperreview
Use when the user explicitly wants to upload a final or near-final PDF to paperreview.ai for an external second opinion. Skip this for local paper critique, which should go through `paper-review-pipeline` first.
Best use case
paperreview is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Use when the user explicitly wants to upload a final or near-final PDF to paperreview.ai for an external second opinion. Skip this for local paper critique, which should go through `paper-review-pipeline` first.
Teams using paperreview should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/paperreview/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How paperreview Compares
| Feature / Agent | paperreview | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Use when the user explicitly wants to upload a final or near-final PDF to paperreview.ai for an external second opinion. Skip this for local paper critique, which should go through `paper-review-pipeline` first.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
SKILL.md Source
# paperreview.ai submission ## Purpose Submit a paper PDF to `paperreview.ai` using the same HTTP flow as the website: 1) Request a presigned upload URL 2) Upload the PDF directly to S3 3) Confirm the upload to start processing and receive a token This skill uses a small Python script so it can run deterministically without a browser. The public version requires you to provide your own email when submitting. ## Safety model - Treat `--submit` as an **irreversible external side effect** (creates a real submission and returns a token). - Default to `--dry-run` first to validate the file and show what would happen. ## Email policy The public version does **not** ship with a fixed email address. - Use `--email you@example.com` when doing a real submission - Keep your own email out of version-controlled defaults ## How to use ### 1) Dry-run (no network, no submission) ```bash python scripts/submit_http.py --pdf "/path/to/paper.pdf" --dry-run ``` ### 2) Real submit (network + S3 upload + token returned) ```bash python scripts/submit_http.py --pdf "/path/to/paper.pdf" --venue ICLR --email "you@example.com" --submit ``` By default, after a successful submit the token is also written next to the PDF as: - `<pdf>.paperreview.token.txt` To disable token file writing: ```bash python scripts/submit_http.py --pdf "/path/to/paper.pdf" --venue ICLR --email "you@example.com" --submit --no-token-file ``` ### 3) Poll for results (every 10 minutes) and save next to the PDF When the review is ready, `paperreview.ai` can be queried with: - `GET /api/review/<token>` - `202` means still processing - `200` means ready (JSON review payload) This skill provides a polling script that saves **timestamped** artifacts next to the PDF: - `<pdf>.paperreview.<timestamp>.json` (raw JSON, includes `_retrieved_at` and `_token`) - `<pdf>.paperreview.<timestamp>.md` (human-readable Markdown) Run (default: 10 minutes, up to 48 hours): ```bash python scripts/watch_review.py --pdf "/path/to/paper.pdf" ``` One-shot check (useful for debugging / cron): ```bash python scripts/watch_review.py --pdf "/path/to/paper.pdf" --once ``` ### Minimal acceptance checks - Dry-run: exits `0` and prints basic validation info. - Submit: exits `0` and prints a `token:` line. Save the token immediately. - Watch: when ready, saves `.json` + `.md` next to the PDF and exits `0`.
Related Skills
writing-anti-ai
This skill should be used when the user asks to "remove AI writing patterns", "humanize this text", "make this sound more natural", "remove AI-generated traces", "fix robotic writing", or needs to eliminate AI writing patterns from prose. Supports both English and Chinese text. Based on Wikipedia's "Signs of AI writing" guide, detects and fixes inflated symbolism, promotional language, superficial -ing analyses, vague attributions, AI vocabulary, negative parallelisms, and excessive conjunctive phrases.
xhs-note-creator
小红书笔记素材创作技能。当用户需要创建小红书笔记素材时使用这个技能。技能包含：根据用户的需求和提供的资料，撰写小红书笔记内容（标题+正文），生成图片卡片（封面+正文卡片），以及发布小红书笔记。
xhs-longform-private-publisher
This skill should be used when the user wants to publish an existing Markdown article to Xiaohongshu as a private longform post, keep the original wording and structure, insert inline images in order, use one-click layout, and verify the result in note manager.
timestamped-video-summary
Generate a detailed, professional video content summary from timestamped subtitles/transcripts (e.g., lines starting with 00:00 / 1:23:45). Enforce strict per-segment structure (timestamp range + bold segment title + 2-paragraph body: first-person creator summary + expert 【导师评注】 critique with uncertainty handling). Use when the user provides time-coded subtitles and asks for a规范化纪要/内容纪要/逐段总结, and optionally wants a clean PDF export (do NOT include the full raw transcript in the PDF unless explicitly requested).
skills-governance
Use when auditing a large local skill collection, identifying duplicate or imported skills, comparing skill roots, or deciding what to keep, disable, or archive across Codex and adjacent agent skill directories.
skill-governance-loop
Use when the user asks to review a skill, analyze skill quality, update a skill version, or run a repeatable keep/disable/archive decision loop from real failures instead of abstract best practices.
skill-creator
Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Codex's capabilities with specialized knowledge, workflows, or tool integrations.
session-recovery-codex
Use when recovering a Codex session, especially if the user provides a Codex session id or wants recent Codex sessions listed before resuming work.
research-lead-sidecar
Use when the user wants multi-agent division of labor for research-led work and the lead should stay on the critical path while 1-2 bounded sidecars handle low-coupling tasks. Do not use this for tiny tasks, fully sequential debugging, or overlapping refactors.
question-refiner
Use when a research question is still vague and must be clarified into a structured deep-research brief before actual literature research or execution. Skip this if the user already has a concrete paper draft or a ready-to-run research specification.
prompt-polisher
Use when receiving messy, unstructured input like voice transcriptions, stream-of-consciousness notes, or rough document content that needs to be transformed into a polished, optimized prompt. Cleans up filler words, extracts intent, asks clarifying questions, applies Claude 4.x/Opus 4.5/Sonnet 4.5 best practices, and previews the polished prompt for approval before execution. Trigger phrases include "polish this", "clean this up", "turn this into a prompt", or when input is clearly rough/unstructured.
proactive-explorer
落实 CLAUDE.md / AGENTS.md 中的“主动探索”原则，在向用户提问前自动使用 Grep、Read、Bash、WebSearch 等工具获取信息