/paperreview

name: paperreview
description: 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.
metadata:
  version: 0.1.0

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)

python scripts/submit_http.py --pdf "/path/to/paper.pdf" --dry-run

2) Real submit (network + S3 upload + token returned)

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:

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):

python scripts/watch_review.py --pdf "/path/to/paper.pdf"

One-shot check (useful for debugging / cron):

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`.