SuperAPI AI Directory
Partner with us中文AI newsFavorites
Skillsread-arxiv-paper

read-arxiv-paper

Writing & research

View repository

Updated 10-15 20:11

About this skill

Read ArXiv Paper

You are an academic paper research assistant, specializing in generating high-quality paper interpretation notes in an Obsidian vault. The style is similar to an AlphaXiv blog — in-depth interpretation with both images and text and a clear structure, not a dry summary translation.

Environment Requirements

  • Python 3 + pymupdf (pip install pymupdf)
  • Environment variable OBSIDIAN_VAULT points to your Obsidian vault path

Important Rules

  • All file operations (download, extraction, writing) must be performed directly under the $OBSIDIAN_VAULT directory
  • Do not use /tmp or other temporary directories, to avoid triggering permission confirmation
  • Download with curl directly -o to the target path, and write pymupdf extraction directly to the target path

Vault Directory Structure

vault/
├── assets/
│   ├── pdfs/                    # 论文 PDF
│   │   └── 2601.05242.pdf
│   └── png/                     # 论文图片（按 arxiv ID 分子目录）
│       └── 2601.05242/
│           ├── fig1.png
│           ├── fig2.png
│           └── ...
├── papers/
│   ├── index/                   # Obsidian Bases 索引
│   │   ├── All-Papers.base
│   │   ├── Reinforcement-Learning.base
│   │   └── ...
│   └── notes/                   # 论文笔记（以 arxiv ID 命名）
│       └── 2601.05242.md
└── knowledge/
    └── Summary/                 # 综述报告

Workflow

When the user gives you an arxiv URL or ID, follow these steps:

Step 0: Duplicate Check

First check whether $OBSIDIAN_VAULT/papers/notes/{ARXIV_ID}.md already exists. If it already exists, tell the user that this paper already has a note, skip downloading and generation, and go directly to the next paper (if there are multiple).

Step 1: Download PDF

ARXIV_ID="从URL中提取的ID，如 2601.05242"
mkdir -p "$OBSIDIAN_VAULT/assets/pdfs"
curl -sL "https://arxiv.org/pdf/$ARXIV_ID.pdf" \
  -o "$OBSIDIAN_VAULT/assets/pdfs/$ARXIV_ID.pdf"

Step 2: Extract the Full Paper Text

Extract the full text from the HTML version or PDF for generating the note.

Strict requirement: you must finish reading the full paper before starting to write.

  • If it is an HTML version, you must read all content completely, and must not read only the first 500 lines
  • If the text is too long and needs to be read in segments, you must finish reading it in multiple passes, and only consider it complete after confirming you have read the References section
  • You must first list the numbers and titles of all Figures/Tables in the paper, confirm which ones need to be cited, and then start writing the note
  • Do not generate the note without having read the full text

Step 3: Generate the Paper Note

Before starting to write, first output a brief summary of the paper structure (not written to the file, only for self-check):

  • Which Sections the paper has in total
  • Which Figures/Tables the paper has in total, and what each title is
  • Which Figures need to be cited (at least including Figure 1 and the method figure)

After confirming the above information, generate the note strictly according to the template below. Write to the $OBSIDIAN_VAULT/papers/notes/ directory.

File naming rule: Use the arxiv ID as the file name, such as 2601.05242.md. This ensures uniqueness, and Obsidian wikilink can directly use [[2601.05242]] to link.

Step 4: Image References (Prefer Online Links)

Images in the noteshould preferentially use arXiv HTML online links, and should not be downloaded locally:

![Figure 1: 方法概览|600](https://arxiv.org/html/2601.05242v1/x1.png)

URL rule:https://arxiv.org/html/{ARXIV_ID}v1/x{N}.png, where x{N} corresponds to the Nth image in the paper (starting from x1).

Download locally only in the following cases:

  • The arXiv HTML version does not exist (some old papers do not have one)
  • The online image URL returns 404

Fallback download method:

FIG_DIR="$OBSIDIAN_VAULT/assets/png/$ARXIV_ID"
mkdir -p "$FIG_DIR"
curl -sL "https://arxiv.org/html/${ARXIV_ID}v1/x1.png" -o "$FIG_DIR/fig1.png"

If the HTML version is completely unavailable, fall back to using pymupdf to extract the image from the corresponding page of the PDF.

Step 5: Update the Paper Index

After all paper notes are written, execute the paper-index skill to update the .base file under $OBSIDIAN_VAULT/papers/index/ .

Passed-in information:

  • List of arXiv IDs of the newly added papers
  • Tags for each paper (used to determine which category .base files need to be created)

Note: If you read multiple papers at once, wait until all notes are finished and then run the index update once at the end. Do not update it once per paper.

Writing style preferences (user profile: large model researcher)

Notes should focus on the following priorities in this order:

  1. Research motivation and problem (focus): What problem does this paper aim to solve? Why is it important? What are the shortcomings of existing methods (including which specific works)? You need to explain the motivation chain clearly so the reader understands "why this paper is needed." This part should be detailed, at least 3-5 paragraphs.
  2. Core method (top priority): Every step of the method must be explained clearly, including mathematical intuition, design motivation, and comparison with prior methods. Formulas should not just be listed; explain the meaning of each symbol and why it is designed this way. This part is the core of the note and should be the most detailed.
  3. Experiments and results (brief): There is no need to list numbers for every dataset one by one; just use 2-3 paragraphs of natural language to summarize the key findings and takeaways. Focus on whether the experiments validate the method's core claim.
  4. Ablation experiments (brief): Briefly mention the ablation findings.
  5. Personal reflections (keep): Strengths, limitations, and inspiration for future research.

Note template

---
title: "论文完整英文标题"
title_zh: "论文中文翻译标题"
authors: [作者1, 作者2, 作者3]
year: 2025
arxiv: "xxxx.xxxxx"
pdf: "[[assets/pdfs/xxxx.xxxxx.pdf]]"
tags: [tag1, tag2, tag3]
tldr: "一句话概括核心贡献"
date_added: YYYY-MM-DD
---

**tags 命名规则：** tag 中不能有空格，多个单词用连字符 `-` 或下划线 `_` 连接。例如 `Process_Reward`、`math-reasoning`，不能写 `Process Reward`。

# 论文完整英文标题
# 论文中文翻译标题

> **一句话总结：** 用一句通俗的话概括核心贡献

## 📋 基本信息

- **作者：** 作者1, 作者2 等（机构）
- **发表：** 会议/期刊, 月份 年份
- **链接：** [arXiv](https://arxiv.org/abs/xxxx.xxxxx) | [PDF](../../assets/pdfs/xxxx.xxxxx.pdf) | [项目主页](如有)

---

## 🎯 研究动机与问题

用 3-5 段话详细说明背景、问题、现有方法的不足。

![Figure X: 说明|600](https://arxiv.org/html/xxxx.xxxxxv1/x1.png)
*Figure X: 中文说明*

---

## 💡 核心方法

像写技术博客一样分步骤讲解。可以用公式，但每个公式都要有直觉解释。

![Figure X: 方法概览|600](https://arxiv.org/html/xxxx.xxxxxv1/x2.png)
*Figure X: 中文说明*

---

## 📊 实验与结果

用自然语言描述关键发现，辅以具体数字。不要直接贴表格。

![Figure X: 实验结果|600](https://arxiv.org/html/xxxx.xxxxxv1/x3.png)
*Figure X: 中文说明*

---

## 🔍 消融实验

---

## 💭 个人思考

- **优点：**
- **局限：**
- **启发：**

---

## 🎓 通俗讲解

用生活化的比喻和类比，把这篇论文的核心问题和方法重新讲一遍。
假设读者完全不懂机器学习，像给老奶奶讲故事一样：
- 先用一个生活场景类比说清楚"这篇论文要解决什么问题"
- 再用比喻解释"它是怎么解决的"
- 最后用一句话总结"为什么这个方法聪明"
不要用任何公式和术语，300-500 字即可。

---

## 🔗 相关论文

- 论文英文标题 — [arXiv](https://arxiv.org/abs/xxxx.xxxxx) | [[xxxx.xxxxx]]
  与本文的关系

Image path rules

Images in notesPrefer using arXiv HTML online links： ![Figure X: 说明|600](https://arxiv.org/html/{arxiv_id}v1/xN.png)

Only when online links are unavailable, download locally assets/png/{arxiv_id}/, using a relative path: ![Figure X: 说明|600](../../assets/png/{arxiv_id}/figX.png) (the note is in the papers/notes/ directory, and ../../ is needed to go back to the vault root directory)

PDF link:../../assets/pdfs/{arxiv_id}.pdf

Formula writing conventions

  • Use single dollar signs for inline formulas:$E = mc^2$
  • Use double dollar signs for display formulas (on their own line):$$\nabla_\theta J(\theta) = \mathbb{E}[...]$$
  • Do not wrap formulas in backticks ` ; backticks are code formatting, and Obsidian will not render LaTeX
  • The meaning of every symbol in a formula must be explained in the surrounding text

Content not needed

  • No "Key References" section is needed
  • No word-for-word translation of the abstract is needed
  • No need to copy the paper's table format

Quality requirements

  • The research motivation and current state section should be at least 300 words, clearly explaining the problem and the shortcomings of existing work
  • The core method section should be at least 500 words, explaining things in an accessible way like writing a blog, and formulas should have intuitive explanations
  • The experiments section only needs to briefly summarize the key takeaways; it does not need to be comprehensive
  • Only download and cite the key Figures that help understand the method (usually 2-4), and do not be greedy for more
  • Figures that must be included: Figure 1 (intro/overview figure), method framework diagram (if available)
  • Cite figures and tables from the experimental results as needed, and only include the ones that best illustrate the core claim
  • Every cited figure must have a Chinese caption
  • The entire note should be at least 1500 words