paperreview

Submit PDFs to paperreview.ai via presigned S3 uploads and poll for review artifacts.

425|37|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/cnfjlhj/ai-collab-playbook --skill paperreview
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: paperreview
Source: https://github.com/cnfjlhj/ai-collab-playbook/tree/main/skills/full/paperreview
Command: npx skills add https://github.com/cnfjlhj/ai-collab-playbook --skill paperreview

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, and includes scripts (resource) components.

What problem does it solve?

Provide a deterministic, script-driven way to submit a final or near-final paper PDF to paperreview.ai and retrieve an external review token and artifacts without using a browser, enabling reproducible submissions and automated result collection.

Core Features & Use Cases

  • Dry-run validation mode that checks the PDF file, header, and size without performing network calls to prevent accidental submissions.
  • Three-step HTTP workflow: request a presigned upload URL, upload the PDF to S3, and confirm the upload to receive a review token; token writing is optional and configurable.
  • Polling utility that queries the review API, saves timestamped JSON and human-readable Markdown next to the original PDF, and supports one-shot checks or continuous polling for up to 48 hours.
  • Use cases include automating external second-opinion submissions for conference papers, integrating review retrieval into paper workflows, and debugging submission flows.

Quick Start

Run the submit script in dry-run mode with your PDF to validate inputs, then rerun with submit and an email to perform the actual upload and receive a token.

Frequently Asked Questions about paperreview

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I submit a paper PDF to paperreview.ai without using a browser?

To submit a paper PDF for review without a browser, use the script to perform a presigned S3 upload and confirm the submission to receive a review token. The workflow validates PDF format and size, then automates the HTTP upload process.

How does automated paper review retrieval work with timestamped artifacts?

Automated paper review retrieval works by polling the review API endpoint using the received token, saving timestamped JSON and Markdown artifacts next to the original PDF. It supports one-shot checks or continuous polling for up to 48 hours.

Can I validate a PDF for upload without actually submitting it to the review API?

Yes, you can validate a PDF for upload without submitting it using the dry-run validation mode. This mode checks the PDF file, header, and size without performing network calls, preventing accidental submissions before you are ready.

Do I need the requests library to run the paperreview submission script?

Yes, you need the requests library installed to run the paperreview submission script. It is required as a dependency to handle the HTTP requests for presigned S3 uploads, confirmation calls, and polling the review endpoint.

What is the best way to integrate an external second opinion into a reproducible paper workflow?

The best way to integrate an external second opinion into a reproducible paper workflow is automating the PDF submission and polling process via scripts. This ensures deterministic, script-driven uploads and automated retrieval of JSON and Markdown review artifacts.

Why does the paperreview polling utility stop after 48 hours?

The paperreview polling utility stops after 48 hours because it is designed to support continuous polling for review results up to that duration. This timeout limitation prevents indefinite polling loops when review generation takes exceptionally long.