关于 arxiv-reading
arxiv-reading 是一项研究技能,可将 arXiv 论文转换为 Markdown,保留数学公式、表格和章节结构,便于阅读。它还说明如何获取所需图表,以及 HTML 转换不可用时的处理方式。
主要功能
- 01用 arxiv2md 转换 arXiv 论文
- 02保留 LaTeX 公式、表格和章节
- 03获取并查看所需图表资源
- 04提供旧论文的备用读取方式
适用场景
- 01无需从 PDF 开始阅读论文正文
- 02查看论文中的重要图表
- 03处理无法获取 arXiv HTML 的论文
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ leo1oel/ leo-agent-skills --skill arxiv-reading安装后在 Claude Code 中输入/arxiv-reading确认已加载。
详细介绍
arXiv 论文阅读
以清晰的 Markdown 阅读论文,不要阅读 PDF。
对于判断方面——从论文中提取什么内容以及如何权衡,请使用 research-taste 技能。
阅读前先转换
对于 arXiv 论文,使用 arxiv2md 转换为 Markdown。它会解析 arXiv 的结构化 HTML,并保留 LaTeX 格式的数学公式、真实表格和章节树:
uvx --from arxiv2markdown arxiv2md <id> -o paper.md
/abs/、/pdf/ 和 /html/ 这几种 URL 形式使用相同的 ID,因此 PDF 链接也可以使用;只需提取其中的 ID。
图表
arxiv2md 会保留文本、数学公式和表格,但不会下载图表。
每个图表在 Markdown 中都会显示为一行不起作用的文本,例如 Refer to caption: 2501.11120v1/x1.png——这是相对资源路径,不是 URL,也不是已保存的文件。
要实际查看图表,请将该路径与 https://arxiv.org/html/ 拼接,下载资源,然后使用 Read 工具打开(Read 会以视觉方式呈现图像):
curl -sL https://arxiv.org/html/2501.11120v1/x1.png -o fig1.png
然后用 Read 读取 fig1.png。
将论文读取操作导向 arxiv2md 的工具调用前钩子允许下载这些图像资源(.png、.jpg、.svg 等),同时仍会阻止直接获取 HTML/PDF 论文,因此请一次下载一个图表,而不是获取整个 HTML 页面。
只下载实际需要的图表——大多数论文只需阅读文本和几张关键图表即可。
备用方案
如果 arxiv2md 没有可用的 HTML(较早的论文尚未由 arXiv 渲染为 HTML),请按以下顺序处理:
- 使用 WebFetch 访问
https://ar5iv.org/abs/<id>并提出具体问题;ar5iv 会从 LaTeX 源码为大多数较早的论文渲染 HTML。 - 仅将 PDF 作为最后手段,使用 Read 工具按页码范围读取,而不是盲目转储全文。通常只看摘要就足以判断是否值得继续阅读。