Agent skill

Paper Interpretation

by digoal in digoal/blog

从论文 PDF 文件或论文 PDF URL 生成通俗易懂、图文并茂、带批判性评估的中文 Markdown 解读,并保存到当前项目的 markdown 目录。Use when the user asks to interpret,精读,解读,summarize,explain,analyze, or write an article from an academic paper PDF…

GPL-2.0Auto-check passedDocuments & Office

Install Paper Interpretation

skills CLI
$ npx skills add digoal/blog --skill paper-interpretation -a claude-code

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

GitHub CLI
$ gh skill install digoal/blog paper-interpretation --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/digoal/blog.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/paper-interpretation .claude/skills/paper-interpretation && 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-interpretation
GitHub stars
8.6k
Token cost
~1.5k tokens
SKILL.md length
709 words
Files
4 (incl. scripts, references)
Skills in repo
98
Repo updated
First seen
Licence
GPL-2.0

At a glance

从论文 PDF 文件或论文 PDF URL 生成通俗易懂、图文并茂、带批判性评估的中文 Markdown 解读,并保存到当前项目的 markdown 目录。Use when the user asks to interpret,精读,解读,summarize,explain,analyze, or write an article from an academic paper PDF…

  • Works in 5 steps: 论文定位 → 前置知识地图 → 论文精读 → …
  • The user asks to interpret
  • SKILL.md covers Goal, Intake, Extraction Workflow and Reading Checklist, plus 4 more sections
  • Runs Python scripts from its folder; calls python3

What it does

Paper Interpretation is an agent skill from digoal/blog. 从论文 PDF 文件或论文 PDF URL 生成通俗易懂、图文并茂、带批判性评估的中文 Markdown 解读,并保存到当前项目的 markdown 目录。Use when the user asks to interpret,精读,解读,summarize,explain,analyze, or write an article from an academic paper PDF, arXiv PDF, conference paper PDF, journal paper PDF, or local/remote PDF URL.

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts and reference files (for example `agents/openai.yaml`, `references/article-template.md` and `scripts/extract_paper_assets.py`).

It sits in Documents & Office, covering PDF, Query optimization and Blog and article writing. It works with arXiv. The repository describes itself as: AI,Opensource,Database,Business,Finance,Minds. git clone --depth 1 https://github.com/digoal/blog. The licence is GPL-2.0.

When your agent uses it

  • The user asks to interpret
  • Write an article from an academic paper PDF
  • Conference paper PDF
  • Journal paper PDF

Example prompts

  • “/paper-interpretation”

Requirements

  • Python 3

Workflow steps

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

  1. 论文定位
  2. 前置知识地图
  3. 论文精读
  4. 术语解释
  5. 批判性评估:论文强在哪里,边界在哪里

What it can do on your machine

Read from SKILL.md and the folder at commit 69fb793. 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 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

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

  • Network

    No URLs in SKILL.md.

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

  • Credentials

    Names no API keys, tokens, secrets or passwords.

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

Context cost

Paper Interpretation loads about 1.5k tokens when it runs, and up to ~1.9k if it reads all its reference files. Until then it costs about 73 tokens; SKILL.md has 709 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~73
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.9k

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); the scripts in this folder are not scanned.

SKILL.md

The full file from digoal/blog at commit 69fb793, republished under its GPL-2.0 licence (© digoal). 709 words, ~1,516 tokens.

Download SKILL.mdSave it as .claude/skills/paper-interpretation/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
paper-interpretation
description
从论文 PDF 文件或论文 PDF URL 生成通俗易懂、图文并茂、带批判性评估的中文 Markdown 解读,并保存到当前项目的 markdown 目录。Use when the user asks to interpret,精读,解读,summarize,explain,analyze, or write an article from an academic paper PDF, arXiv PDF, conference paper PDF, journal paper PDF, or local/remote PDF URL.

Paper Interpretation

Goal

Read the whole paper, including text, tables, figures, captions, appendices, and experiment details, then write a Chinese Markdown article that helps non-specialists understand the paper while preserving its academic and industrial value.

Always save the final Markdown under the current project's markdown/ directory. Create the directory if missing. Use a descriptive filename derived from the paper title, for example markdown/论文标题-通俗解读.md.

Intake

Accept either:

  • A local PDF path.
  • A PDF URL.

If the user gives a URL, download the PDF or use scripts/extract_paper_assets.py to download and extract it. If the PDF is scanned or extraction is incomplete, use OCR or available PDF/image tooling before writing. Do not rely only on abstract/introduction unless the PDF cannot be fully processed; state any limitation explicitly.

Extraction Workflow

Use the helper script when useful:

bash
python3 /Users/digoal/.codex/skills/paper-interpretation/scripts/extract_paper_assets.py INPUT_PDF_OR_URL --out .paper-work

The script creates:

  • paper.pdf for the normalized PDF.
  • paper_text.md with page-level text.
  • paper_tables.md with table candidates when pdfplumber is available.
  • figures/ with extracted embedded images when PyMuPDF is available.
  • manifest.json with extraction status and warnings.

Read the extracted files and inspect important figures/tables directly when they carry evidence, architecture, or results. If a library is unavailable, use other local tools if present; otherwise continue with the available extraction and mention the gap only if it affects confidence.

Reading Checklist

Before writing, identify:

  • Paper title, authors, venue/date when available.
  • Research problem and practical motivation.
  • Prior methods or baselines the paper contrasts against.
  • Proposed method, system architecture, algorithm, data, or theory.
  • Main experiments, metrics, datasets, tables, and figures.
  • Claimed academic contributions and industrial implications.
  • Assumptions, limitations, failure cases, and future work.

Article Structure

Write in Chinese. Make the result accessible, but do not dilute technical substance.

1. 论文定位

Start by answering "这是什么、跟我有什么关系、值不值得读":

  • Use 1-3 sentences to explain the real-world problem.
  • State academic value: what gap it fills or what new capability/evidence it adds.
  • State industrial value: where it can be used or what decision it can improve.
  • Give one intuitive analogy tailored to the paper. Avoid reusing examples blindly; for a multi-agent finance paper, an analogy like "给 AI 配了一个完整的投资团队" is appropriate.
2. 前置知识地图

Build a prerequisite knowledge map:

text
核心概念(必须懂) -> 支撑概念(有助于理解) -> 扩展概念(感兴趣再看)

For each important concept, explain with:

  • A chart or structured list.
  • An analogy.
  • A concrete example.

Use Mermaid when it improves clarity:

mermaid
flowchart LR
  A["核心概念"] --> B["支撑概念"]
  B --> C["扩展概念"]
3. 论文精读

Use the 5W1H frame and map it to the paper:

问题对应论文结构写作要求
Why:为什么要做这个研究?Introduction / Motivation讲清痛点和旧方法不足
What:提出了什么方法/系统?Method / Architecture用一句话先讲总方案
How:具体怎么实现?Technical Details拆成模块、流程、公式或伪代码
So What:结果怎么样?Experiments / Results引用关键表格/图/指标,解释数字意味着什么
Now What:对我们意味着什么?Value / Discussion总结工业和学术启发

Prefer comparison over isolated explanation:

  • Compare with prior methods or baselines.
  • Compare with a reader's intuitive expectation.
  • Explain what changes in the workflow, cost, accuracy, robustness, or scalability.
Show full SKILL.md (273 more words)Show less
4. 术语解释

Include a glossary for important terms. Use this template:

markdown
**Term(中文名)**
- 是什么:...
- 为什么重要:...
- 现实类比:...

Explain why the term is named that way when useful. Keep terms short and selective; prioritize terms required to understand the paper.

5. 批判性评估:论文强在哪里,边界在哪里

Evaluate, do not merely praise:

  • Which assumptions must hold in real deployments?
  • Are datasets, baselines, metrics, ablations, or statistical claims convincing?
  • Where might the method fail?
  • What cost, latency, safety, privacy, reproducibility, or integration risks exist?
  • What future improvements are realistic?

Separate paper claims from your inference. Use wording like "论文证明了..." for supported claims and "可推断..." for reasoned extrapolation.

Visual Requirements

Use Markdown-supported visuals at key points:

  • Mermaid for process, architecture, concept maps, causal chains, and experiment flow.
  • Markdown tables for comparisons, result interpretation, limitations, and term dictionaries.
  • Simple SVG only when a static diagram is clearer than Mermaid.
  • Text diagrams when they are more readable than formal charts.

Do not add decorative diagrams. Every visual must help explain a concept, method, result, or critique.

Source Discipline

  • Cite page numbers, section names, table numbers, or figure numbers whenever possible.
  • Do not invent results, claims, datasets, or author intent.
  • If extraction is incomplete, clearly label uncertain parts.
  • Preserve important formulas or algorithms, but explain them in plain language.
  • If the paper has supplementary material or appendices inside the PDF, include relevant evidence from them.

Output Checklist

The final Markdown must include:

  • Title.
  • Paper metadata.
  • 1-3 sentence overview.
  • Academic value and industrial value.
  • Knowledge map.
  • Problem-solution-validation deep read.
  • Key figure/table interpretations.
  • Term glossary.
  • Critical evaluation and future directions.
  • References/source notes pointing back to paper sections, pages, figures, or tables.

After saving, report the absolute output path and any extraction limitations.

© digoal, GPL-2.0. 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 3 other files (scripts, references) in skills/paper-interpretation of digoal/blog.

  • SKILL.md
  • agents/openai.yaml
  • references/article-template.md
  • scripts/extract_paper_assets.py

Open the folder on GitHubat commit 69fb793

Compare with similar skills

Paper Interpretation 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 Interpretation compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Paper Interpretation this skilldigoal/blog8.6k—~1.5kAutomated safety check: PassGPL-2.0
Fulltext RetrievalAperivue/medsci-skills329—~1.9kAutomated safety check: PassMIT
Paper LensYSQ-boop/paper-lens101—~1.3kAutomated safety check: PassApache-2.0
Paper Interpreterchujianyun/skills740—~810Automated safety check: PassCustom licence
Omh Paper Learningrlaope/oh-my-hermes3.2k—~2.2kAutomated safety check: PassMIT
Paper2htmlcnfjlhj/ai-collab-playbook452—~2.4kAutomated safety check: PassNone

Similar skills

  • Fulltext Retrieval

    Aperivue/medsci-skills

    A skill your agent uses when you need full-text PDFs for a list of DOIs, such as a meta-analysis screening set.

    329 GitHub stars~1.9k tokensUpdated 3 days ago
    Documents & OfficeAuto-check passed
  • Paper Lens

    YSQ-boop/paper-lens

    Read and critically analyze one academic paper from an arXiv URL/ID or a local PDF, producing a source-grounded Markdown report that can grow from a quick read into a reviewer-level deep review.

    101 GitHub stars~1.3k tokensUpdated 9 days ago
    Documents & OfficeAuto-check passed
  • Paper Interpreter

    chujianyun/skills

    论文解读助手。适用于用户发送 arXiv 论文链接,并希望下载论文、解读论文、生成读书笔记、做论文拆解或输出详细报告时使用。会在工作目录创建论文文件夹、下载 PDF 与 TeX Source(如有)、生成中文 Markdown 报告。默认先交付初稿,不自动复查;如果用户明确同意,再安排后续复查。不适用于只要简短推荐语的情况。

    740 GitHub stars~810 tokensUpdated 14 days ago
    Documents & OfficeAuto-check passed
  • Omh Paper Learning

    rlaope/oh-my-hermes

    [omh] Paper or paper PDF to understand: explain a supplied paper or paper/PDF at a selected level while preserving full section coverage and source evidence boundaries.

    3.2k GitHub stars~2.2k tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Paper2html

    cnfjlhj/ai-collab-playbook

    A skill your agent uses when turning an academic paper PDF/arXiv/OpenReview page/local LaTeX source into a single-file Chinese HTML deep-reading page, especially when the user wants a Cheat-Sheet…

    452 GitHub stars~2.4k tokensUpdated 24 days ago
    Documents & OfficeAuto-check passed
  • Summary

    alaliqing/claude-paper

    Use this for a quick summary of a research paper's core ideas and key points.

    344 GitHub starsUsed in 1 repo~2k tokens
    Research & ScienceAuto-check: notes

More from digoal/blog

All 98 skills in this repo
  • 三层审查模型,逐段逐句验证文章真伪、证据链与逻辑结构。Use when the user asks to fact-check, verify, audit, or evaluate the credibility of an article, essay, report, opinion piece, social-media post, or any written claim —…

    8.6k GitHub stars~939 tokensUpdated 11 days ago
    Auto-check passed
  • Find latent bugs in a local PostgreSQL source tree (RELxxSTABLE branch or HEAD) the way a core hacker does: build a heavily-poisoned debug instance (cassert + cache-discard + -O0/-ggdb3 + core…

    8.6k GitHub stars~4k tokensUpdated 11 days ago
    Auto-check passed
  • Digoal

    digoal/blog

    Portable digital employee distilled from digoal's personal blog for PostgreSQL, PolarDB, DuckDB, AI+database, vector/RAG, database operations, source-code reading, technical content creation…

    8.6k GitHub stars~2.2k tokensUpdated 11 days ago
    Auto-check passed
  • Analyze a product from documentation, websites, PDFs, articles, release notes, pricing pages, app listings, reviews, filings, or related links; save separate intermediate analyses from seven roles…

    8.6k GitHub stars~1.8k tokensUpdated 11 days ago
    Auto-check passed
  • Turn a blog post, article, notes, or any source material into a set of vertical poster images — one cover plus several coherent content slides that explain the core points.

    8.6k GitHub stars~1.4k tokensUpdated 11 days ago
    Auto-check passed
  • Convert a Markdown article into a natural first-person podcast script for 1 to 4 speakers and save it as a .txt file under the current project's markdown directory.

    8.6k GitHub stars~1.6k tokensUpdated 11 days ago
    Auto-check passed

Works with

Questions about Paper Interpretation

What does Paper Interpretation do?

从论文 PDF 文件或论文 PDF URL 生成通俗易懂、图文并茂、带批判性评估的中文 Markdown 解读,并保存到当前项目的 markdown 目录。Use when the user asks to interpret,精读,解读,summarize,explain,analyze, or write an article from an academic paper PDF…. Paper Interpretation is an agent skill from digoal/blog. 从论文 PDF 文件或论文 PDF URL 生成通俗易懂、图文并茂、带批判性评估的中文 Markdown 解读,并保存到当前项目的 markdown 目录。Use when the user asks to interpret,精读,解读,summarize,explain,analyze, or write an article from an academic paper PDF, arXiv PDF, conference paper PDF, journal paper PDF, or local/remote PDF URL.

When should I use Paper Interpretation?

Paper Interpretation fits situations like: the user asks to interpret; write an article from an academic paper PDF; conference paper PDF; journal paper PDF.

How do I install Paper Interpretation in Claude Code?

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

How do I install Paper Interpretation in Codex?

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

Can I use Paper Interpretation 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 digoal/blog --skill paper-interpretation -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-interpretation, .gemini/skills/paper-interpretation, .github/skills/paper-interpretation and .opencode/skills/paper-interpretation in your project.

What does Paper Interpretation need to run?

Going by SKILL.md and its folder, Paper Interpretation needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Paper Interpretation access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Paper Interpretation 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Paper Interpretation use?

Paper Interpretation is published under the GPL-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Paper Interpretation use?

About 1.5k tokens (SKILL.md is roughly 6.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 370 tokens, read only when the agent opens those files.

What are the alternatives to Paper Interpretation?

Skills that share tags, products or a category with Paper Interpretation: Fulltext Retrieval (Aperivue/medsci-skills, 329 stars), Paper Lens (YSQ-boop/paper-lens, 101 stars), Paper Interpreter (chujianyun/skills, 740 stars) and Omh Paper Learning (rlaope/oh-my-hermes, 3.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Paper Interpretation?

digoal (a GitHub user) maintains it in digoal/blog, which has 8,587 GitHub stars. The repository holds 98 skills in this directory. The repository was last updated on September 28, 2026.

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