Agent skill

Paper Review

by RapidAI in RapidAI/MaClaw

论文深度解读 Skill — 下载论文PDF → LLM深度解读(问题/创新点/方法原理/实验分析)→ PDF图片提取 → 生成组会PPT → 生成解读音频MP3。端到端学术论文解读工具。

MITAuto-check passedDocuments & Office

Install Paper Review

skills CLI
$ npx skills add RapidAI/MaClaw --skill paper-review -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install RapidAI/MaClaw paper-review --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/RapidAI/MaClaw.git skills-src && mkdir -p .claude/skills && cp -r skills-src/paper-review .claude/skills/paper-review && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
paper-review
GitHub stars
148
Token cost
~1k tokens
SKILL.md length
212 words
Files
9
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

论文深度解读 Skill — 下载论文PDF → LLM深度解读(问题/创新点/方法原理/实验分析)→ PDF图片提取 → 生成组会PPT → 生成解读音频MP3。端到端学术论文解读工具。

  • Works in 6 steps: 下载 PDF → 全文提取 → LLM 深度解读 → …
  • Tasks that involve Peer review
  • SKILL.md covers 架构概览, 环境要求, Step 1: 下载 PDF and Step 2: 全文提取, plus 7 more sections
  • Runs Python scripts from its folder; calls python and pip; needs OPENAI_API_KEY

What it does

Paper Review is an agent skill from RapidAI/MaClaw. 论文深度解读 Skill — 下载论文PDF → LLM深度解读(问题/创新点/方法原理/实验分析)→ PDF图片提取 → 生成组会PPT → 生成解读音频MP3。端到端学术论文解读工具。

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 9 other files (for example `run.py`, `skill.yaml` and `steps/analyze_paper.py`).

It sits in Documents & Office, covering Peer review, PDF and PowerPoint presentations. It works with OpenAI, Google Gemini, Kimi and MiniMax. The repository describes itself as: 下一代企业级自主进化智能体平台(GUI/TUI/Service/SDK) 。全世界唯一全博士团队开发的开源企业级免费智能体平台。 The licence is MIT.

When your agent uses it

  • Tasks that involve Peer review
  • Tasks that involve PDF
  • Tasks that involve PowerPoint presentations

Example prompts

  • “/paper-review”

Requirements

  • Python 3
  • A credential in OPENAI_API_KEY

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. 下载 PDF
  2. 全文提取
  3. LLM 深度解读
  4. 提取图片素材
  5. 生成组会 PPT
  6. 生成解读音频

What it can do on your machine

Read from SKILL.md and the folder at commit c936793. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python
    • pip

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use pip, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • OPENAI_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Paper Review loads about 1k tokens when it runs. Until then it costs about 27 tokens; SKILL.md has 212 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~27
When it runs · the whole SKILL.md, loaded when a task matches
~1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from RapidAI/MaClaw at commit c936793, republished under its MIT licence (© RapidAI). 212 words, ~1,036 tokens.

Download SKILL.mdSave it as .claude/skills/paper-review/SKILL.md (or your agent's skills folder). This skill also uses 8 other files; get the full folder from GitHub.
name
paper-review
description
论文深度解读 Skill — 下载论文PDF → LLM深度解读(问题/创新点/方法原理/实验分析)→ PDF图片提取 → 生成组会PPT → 生成解读音频MP3。端到端学术论文解读工具。
license
MIT
requires_env
OPENAI_API_KEY
triggers
论文解读, paper review, paper reading, 组会PPT, 研读论文
required_args
paper_url
metadata.version
1.0
metadata.category
academic
metadata.author
RapidAI Research - 安妮

Paper Review — 论文深度解读工具

端到端论文解读流程:下载论文 → LLM 深度解读 → 提取图片 → 生成 PPT → 生成 MP3 音频。

架构概览

用户提供论文URL/路径
       │
       ▼
┌──────────────────┐
│  Step 1: 下载PDF  │  (支持 arXiv / DOI / 任意URL)
└────────┬─────────┘
         ▼
┌─────────────────────────┐
│  Step 2: 全文提取 (txt)  │  (PDF→文本,含图片占位标记)
└────────┬────────────────┘
         ▼
┌──────────────────────────────────────────────┐
│  Step 3: LLM 深度解读分析                     │
│   • 解决的问题                               │
│   • 创新点                                   │
│   • 方法本质与核心原理                        │
│   • 详细原理解读                              │
│   • 实验方法与结果分析                        │
└────────┬─────────────────────────────────────┘
         ▼
┌──────────────────┐
│  Step 4: 提取图片 │  (PDF→PNG图片素材)
└────────┬─────────┘
         ▼
┌──────────────────────────────┐
│  Step 5: 生成组会PPT (.pptx)  │  (深度解读内容 + 图片嵌入)
└────────┬─────────────────────┘
         ▼
┌──────────────────────────────┐
│  Step 6: 生成解读音频 (.mp3)  │  (TTS 合成为自然语音)
└────────┬─────────────────────┘
         ▼
      输出文件清单

环境要求

  • Python 3.8+
  • 依赖安装:pip install requests PyPDF2 python-pptx Pillow pydub
  • 如使用 Edge TTS 音频:pip install edge-tts
  • (可选) pdf2image + poppler 用于图片提取

Step 1: 下载 PDF

从 arXiv / DOI / 任意 URL 下载论文 PDF。

bash
python "{baseDir}/steps/download_paper.py" --url "{{paper_url}}" --output "{{output_dir}}"

参数:

  • --url: 论文 URL(arXiv 链接、DOI 链接、或直接 PDF 链接)
  • --output: 输出目录(可选,默认当前目录)

输出:{{paper_id}}.pdf

Step 2: 全文提取

从 PDF 提取文本内容(含图片标记):

bash
python "{baseDir}/steps/extract_text.py" --pdf "{{pdf_path}}" --output "{{output_dir}}"

输出:{{paper_id}}_text.txt

Step 3: LLM 深度解读

调用 OpenAI 兼容 API 对论文进行深度解读:

bash
python "{baseDir}/steps/analyze_paper.py" --text "{{txt_path}}" --output "{{output_dir}}"

输出:{{paper_id}}_review.json + {{paper_id}}_review.md

解读结构:

json
{
  "title": "论文标题",
  "problem": "解决的问题",
  "novelty": ["创新点1", "创新点2", ...],
  "method_essence": "方法本质/核心思想",
  "method_detail": "详细原理解读",
  "experiments": "实验方法及结果分析",
  "conclusion": "结论与启示"
}

Step 4: 提取图片素材

从 PDF 中提取图片作为 PPT 素材:

bash
python "{baseDir}/steps/extract_images.py" --pdf "{{pdf_path}}" --output "{{output_dir}}/images"

参数:

  • --dpi: 图片 DPI(默认 200)
  • --format: 输出格式(默认 png)

输出:images/page_XX.png 等

Step 5: 生成组会 PPT

基于解读内容和图片生成组会 PPT:

bash
python "{baseDir}/steps/generate_ppt.py" --review "{{review_json}}" --images "{{images_dir}}" --output "{{output_dir}}"

PPT 结构(10-15页):

  1. 封面 — 论文标题 / 作者 / 会议
  2. 研究背景与动机 — 为什么做这个工作
  3. 要解决的问题 — 问题定义与挑战
  4. 核心创新点 — 本文的主要贡献
  5. 方法总览 — 整体架构图(含原论文图)
  6. 方法详解① — 关键模块/步骤
  7. 方法详解② — 更多细节
  8. 核心原理剖析 — 为什么有效
  9. 实验设置 — 数据集 / 评价指标 / 基线
  10. 实验结果 — 主实验结果(含原论文表格)
  11. 消融实验 — 各模块贡献分析
  12. 可视化分析 — 可视化结果(含原论文图)
  13. 讨论与局限性
  14. 总结与启示
  15. 参考资料 / Q&A

输出:{{paper_id}}_presentation.pptx

Step 6: 生成解读音频

将完整解读文本合成为 MP3 音频:

bash
python "{baseDir}/steps/generate_audio.py" --text "{{review_md}}" --output "{{output_dir}}"

输出:{{paper_id}}_audio.mp3

完整运行

一步到位运行所有步骤:

bash
python "{baseDir}/run.py" --url "{{paper_url}}" --output "{{output_dir}}"

输出文件

文件说明
{{paper_id}}.pdf原论文 PDF
{{paper_id}}_text.txtPDF 提取的纯文本
{{paper_id}}_review.mdLLM 深度解读报告
{{paper_id}}_review.json结构化解读数据
images/提取的论文图片素材
{{paper_id}}_presentation.pptx组会 PPT
{{paper_id}}_audio.mp3解读音频

自定义配置

通过环境变量配置 API:

变量说明默认值
OPENAI_BASE_URLAPI 基础 URL由 maclaw proxy 自动注入
OPENAI_API_KEYAPI 密钥由 maclaw proxy 自动注入
OPENAI_MODEL模型名称gpt-4o-mini
TTS_ENGINETTS 引擎 (openai/edge)edge
PPT_LANGPPT 语言 (zh/en)zh

© RapidAI, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 8 other files in paper-review of RapidAI/MaClaw.

  • SKILL.md
  • run.py
  • skill.yaml
  • steps/analyze_paper.py
  • steps/download_paper.py
  • steps/extract_images.py
  • steps/extract_text.py
  • steps/generate_audio.py
  • steps/generate_ppt.py

Open the folder on GitHubat commit c936793

Compare with similar skills

Paper Review next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Paper Review compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Paper Review this skillRapidAI/MaClaw148—~1kAutomated safety check: PassMIT
01 Paper Reviewagentscope-ai/OpenJudge871—~2.4kAutomated safety check: PassApache-2.0
Markitdownaipoch/medical-research-skills1.9k—~1.3kAutomated safety check: PassMIT
Document ConverterBlackBeltTechnology/pi-agent-dashboard315—~999Automated safety check: PassMIT
Paper Auditbrycewang-stanford/Auto-Empirical-Research-Skills4.6k—~3.6kAutomated safety check: PassCustom licence
PDFzai-org/ZCode7.7k—~18kAutomated safety check: NotesProprietary

Similar skills

  • 01 Paper Review

    agentscope-ai/OpenJudge

    Review academic papers for correctness, quality, and novelty using OpenJudge's multi-stage pipeline.

    871 GitHub stars~2.4k tokensUpdated 1 mo ago
    Research & ScienceAuto-check passed
  • Markitdown

    aipoch/medical-research-skills

    Convert files and Office documents into clean Markdown when you need LLM-friendly, token-efficient text (e.g., for summarization, search, RAG ingestion, or dataset preparation).

    1.9k GitHub stars~1.3k tokensUpdated 24 days ago
    Documents & OfficeAuto-check passed
  • Document Converter

    BlackBeltTechnology/pi-agent-dashboard

    Convert documents bidirectionally via the pi-doc-engine facade: ingest PDF/DOCX/PPTX/XLSX to provenance-stamped Markdown (with OCR), and produce templated DOCX/PDF from Markdown with diagrams, TOC…

    315 GitHub stars~999 tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Paper Audit

    brycewang-stanford/Auto-Empirical-Research-Skills

    Deep-review-first audit for Chinese and English academic papers across LaTeX, Typst, and PDF formats.

    4.6k GitHub stars~3.6k tokensUpdated 5 days ago
    Documents & OfficeAuto-check passed
  • PDF

    zai-org/ZCode

    Professional PDF toolkit covering four production workflows: reports, creative visuals, academic LaTeX, and existing PDF processing.

    7.7k GitHub stars~18k tokensUpdated today
    Documents & OfficeAuto-check: notes
  • Reasoning Serialization Tests

    tailcallhq/forgecode

    Checks that ReasoningConfig fields are serialized into the right provider-specific JSON for OpenRouter, Anthropic, GitHub Copilot and Codex requests.

    7.6k GitHub stars~1k tokensUpdated today
    Testing & QAAuto-check passed

Questions about Paper Review

What does Paper Review do?

论文深度解读 Skill — 下载论文PDF → LLM深度解读(问题/创新点/方法原理/实验分析)→ PDF图片提取 → 生成组会PPT → 生成解读音频MP3。端到端学术论文解读工具。. Paper Review is an agent skill from RapidAI/MaClaw.

When should I use Paper Review?

Paper Review fits situations like: tasks that involve Peer review; tasks that involve PDF; tasks that involve PowerPoint presentations.

How do I install Paper Review in Claude Code?

Run `npx skills add RapidAI/MaClaw --skill paper-review -a claude-code`. Or copy the skill folder (paper-review in RapidAI/MaClaw) into .claude/skills/paper-review in your project. Claude Code loads it when a task matches its description.

How do I install Paper Review in Codex?

Run `npx skills add RapidAI/MaClaw --skill paper-review -a codex`. Or copy the skill folder (paper-review in RapidAI/MaClaw) into .agents/skills/paper-review in your project. Codex loads it when a task matches its description.

Can I use Paper Review in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add RapidAI/MaClaw --skill paper-review -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/paper-review, .gemini/skills/paper-review, .github/skills/paper-review and .opencode/skills/paper-review in your project.

What does Paper Review need to run?

Going by SKILL.md and its folder, Paper Review needs Python for the scripts in its folder, the command-line tools its instructions call (python and pip) and credentials named OPENAI_API_KEY. Our summary lists: Python 3; A credential in OPENAI_API_KEY.

Does Paper Review access the network?

SKILL.md contains no URLs. Its commands use pip, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Paper Review safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Paper Review use?

Paper Review is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Paper Review use?

About 1k tokens (SKILL.md is roughly 4.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Paper Review?

Skills that share tags, products or a category with Paper Review: 01 Paper Review (agentscope-ai/OpenJudge, 871 stars), Markitdown (aipoch/medical-research-skills, 1.9k stars), Document Converter (BlackBeltTechnology/pi-agent-dashboard, 315 stars) and Paper Audit (brycewang-stanford/Auto-Empirical-Research-Skills, 4.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Paper Review?

RapidAI (a GitHub organization) maintains it in RapidAI/MaClaw, which has 148 GitHub stars. The repository was last updated on October 10, 2026.

Source: RapidAI/MaClaw on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.