Agent skill

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.

View SKILL.md on GitHub Repository
Stars 190
Forks 12

Install this agent skill to your Project

npx add-skill https://github.com/cnfjlhj/ai-collab-playbook/tree/main/skills/full/paperreview

SKILL.md

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.

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

cnfjlhj/ai-collab-playbook

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.

190 12
Explore
cnfjlhj/ai-collab-playbook

academic-paper-helper

学术论文写作助手，专门用于 LaTeX 论文编写、BibTeX 管理、格式化、学术写作规范检查。适用于 AI/ML 研究论文、会议投稿（NeurIPS、ICML、ICLR 等）

190 12
Explore
cnfjlhj/ai-collab-playbook

collaborating-with-claude

Use when you want Claude Code CLI as a second opinion for coding tasks such as design tradeoffs, debugging, or diff review, while keeping Codex as the primary implementer.

190 12
Explore
cnfjlhj/ai-collab-playbook

proactive-explorer

落实 CLAUDE.md / AGENTS.md 中的“主动探索”原则，在向用户提问前自动使用 Grep、Read、Bash、WebSearch 等工具获取信息

190 12
Explore
cnfjlhj/ai-collab-playbook

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.

190 12
Explore
cnfjlhj/ai-collab-playbook

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.

190 12
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results