Skip to content
Back to search

llm-paper-reading-skills

MarketplaceWorks with Claude CodeGitHub

llm-paper-reading 的 Agent Skills 集合

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/llm-paper-reading--pdf-figure-extract/badge.svg)](/listings/llm-paper-reading--pdf-figure-extract)

HTML

<a href="/listings/llm-paper-reading--pdf-figure-extract"><img src="/api/listings/llm-paper-reading--pdf-figure-extract/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

方式一:skills CLI(推荐,自动识别已装客户端)

# 项目级,交互选择要装给哪些 agent
npx skills add llm-paper-reading/pdf-figure-extract

# 只装给 Claude Code 与 Codex,用户级,免交互
npx skills add llm-paper-reading/pdf-figure-extract -g -a claude-code -a codex -y

# 固定版本
npx skills add llm-paper-reading/pdf-figure-extract@v1.1.0 -a claude-code

方式二:Claude Code 插件

claude plugin marketplace add llm-paper-reading/pdf-figure-extract
claude plugin install pdf-figure-extract@llm-paper-reading-skills

也可在 Claude Code 会话内一步完成:

/plugin install pdf-figure-extract --marketplace llm-paper-reading/pdf-figure-extract

方式三:源码安装

git clone https://github.com/llm-paper-reading/pdf-figure-extract.git
cd pdf-figure-extract

# 默认装给 Claude Code(用户级软链接)
./install.sh

# 装给 Codex / Cursor 等(~/.agents/skills)
./install.sh -a codex

# 同时装给多个客户端;-p 装到当前项目;--copy 复制而非软链
./install.sh -a claude-code,codex
cd your-project && /path/to/pdf-figure-extract/install.sh -p -a claude-code

# 查看目标路径或覆盖已存在安装
./install.sh --list
./install.sh --force

手动软链等价写法:

# Claude Code
ln -s "$PWD/skills/pdf-figure-extract" ~/.claude/skills/pdf-figure-extract
# Codex / Cursor / Cline 等
ln -s "$PWD/skills/pdf-figure-extract" ~/.agents/skills/pdf-figure-extract

方式四:直接放进项目

把 `skills/pdf-figure-extract/` 整个目录复制到项目的 `.claude/skills/` 或 `.agents/skills/` 下即可,目录名保持 `pdf-figure-extract`。

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 18 lines
  1. {
  2. "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  3. "name": "llm-paper-reading-skills",
  4. "description": "llm-paper-reading 的 Agent Skills 集合",
  5. "owner": {
  6. "name": "llm-paper-reading"
  7. },
  8. "plugins": [
  9. {
  10. "name": "pdf-figure-extract",
  11. "displayName": "PDF Figure Extract",
  12. "description": "从论文 PDF 中安全抽取 Figure 为 PNG/SVG,杜绝贴边裁剪、caption 混入与图片 404。",
  13. "source": "./",
  14. "category": "productivity",
  15. "homepage": "https://github.com/llm-paper-reading/pdf-figure-extract"
  16. }
  17. ]
  18. }
README.md · README · 176 lines
  1. # pdf-figure-extract
  2. [![Claude Skill](https://img.shields.io/badge/Claude-Code%20Skill-blueviolet)](https://code.claude.com/docs/en/skills)
  3. [![Agent Skills](https://img.shields.io/badge/Agent%20Skills-compatible-10b981)](https://agentskills.io)
  4. [![skills.sh](https://skills.sh/b/llm-paper-reading/pdf-figure-extract)](https://skills.sh/llm-paper-reading/pdf-figure-extract)
  5. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
  6. 从论文 PDF 中安全抽取 Figure 为 **PNG / SVG** 的通用 Agent Skill,遵循 [Agent Skills 开放规范](https://agentskills.io),可用于 Claude Code、Codex、Cursor、Cline、Gemini CLI 等客户端。
  7. 杜绝抽图最常见的四类问题:
  8. - ✂️ **贴边裁剪** —— 顶部/底部文字被切一半、坐标轴没截全
  9. - 📰 **混入杂质** —— 论文自带 caption、正文段落、页眉被裁进图里
  10. - 🔗 **双栏误判** —— 把另一栏的图或正文并进同一张图
  11. - ❌ **图 404** —— 只写了引用没产出文件
  12. ## 支持平台
  13. | 客户端 | 加载位置 | 安装方式 |
  14. |---|---|---|
  15. | Claude Code | `.claude/skills/`、`~/.claude/skills/` | skills CLI / plugin / 源码 |
  16. | Codex CLI | `.agents/skills/`、`~/.agents/skills/` | skills CLI / 源码 |
  17. | Cursor、Cline、Gemini CLI、Windsurf、GitHub Copilot、OpenCode 等 | `.agents/skills/`、`~/.agents/skills/` | skills CLI / 源码 |
  18. | 其他 Agent Skills 客户端 | 见各自文档 | 源码(`install.sh` 软链) |
  19. ## 安装
  20. ### 方式一:skills CLI(推荐,自动识别已装客户端)
  21. ```bash
  22. # 项目级,交互选择要装给哪些 agent
  23. npx skills add llm-paper-reading/pdf-figure-extract
  24. # 只装给 Claude Code 与 Codex,用户级,免交互
  25. npx skills add llm-paper-reading/pdf-figure-extract -g -a claude-code -a codex -y
  26. # 固定版本
  27. npx skills add llm-paper-reading/pdf-figure-extract@v1.1.0 -a claude-code
  28. ```
  29. ### 方式二:Claude Code 插件
  30. ```bash
  31. claude plugin marketplace add llm-paper-reading/pdf-figure-extract
  32. claude plugin install pdf-figure-extract@llm-paper-reading-skills
  33. ```
  34. 也可在 Claude Code 会话内一步完成:
  35. ```text
  36. /plugin install pdf-figure-extract --marketplace llm-paper-reading/pdf-figure-extract
  37. ```
  38. ### 方式三:源码安装
  39. ```bash
  40. git clone https://github.com/llm-paper-reading/pdf-figure-extract.git
  41. cd pdf-figure-extract
  42. # 默认装给 Claude Code(用户级软链接)
  43. ./install.sh
  44. # 装给 Codex / Cursor 等(~/.agents/skills)
  45. ./install.sh -a codex
  46. # 同时装给多个客户端;-p 装到当前项目;--copy 复制而非软链
  47. ./install.sh -a claude-code,codex
  48. cd your-project && /path/to/pdf-figure-extract/install.sh -p -a claude-code
  49. # 查看目标路径或覆盖已存在安装
  50. ./install.sh --list
  51. ./install.sh --force
  52. ```
  53. 手动软链等价写法:
  54. ```bash
  55. # Claude Code
  56. ln -s "$PWD/skills/pdf-figure-extract" ~/.claude/skills/pdf-figure-extract
  57. # Codex / Cursor / Cline 等
  58. ln -s "$PWD/skills/pdf-figure-extract" ~/.agents/skills/pdf-figure-extract
  59. ```
  60. ### 方式四:直接放进项目
  61. 把 `skills/pdf-figure-extract/` 整个目录复制到项目的 `.claude/skills/` 或 `.agents/skills/` 下即可,目录名保持 `pdf-figure-extract`。
  62. ## 依赖
  63. | 依赖 | 用途 | 安装 |
  64. |---|---|---|
  65. | Python 3.10+ | 运行脚本 | — |
  66. | [PyMuPDF](https://pymupdf.readthedocs.io/) | PDF 解析、渲染 | `pip install pymupdf pillow numpy` |
  67. | [poppler](https://poppler.freedesktop.org/) | `pdftocairo` SVG 转换 | macOS: `brew install poppler` |
  68. | [librsvg](https://gitlab.gnome.org/GNOME/librsvg) | `rsvg-convert`(仅 SVG 边界检查) | macOS: `brew install librsvg` |
  69. ## 使用
  70. 安装后对 agent 说「从论文抽取 Figure 2」即可自动触发;也可直接调脚本(脚本位于本 skill 目录的 `scripts/` 下):
  71. ```bash
  72. cd /tmp && mkdir work && cd work
  73. curl -sL -o paper.pdf "https://arxiv.org/pdf/2205.14135"
  74. # 矢量图 → SVG(推荐,任意缩放不失真)
  75. python <skill-dir>/scripts/extract_svg.py paper.pdf 2 1 fig1.svg
  76. # 位图 → PNG(自动注入 1.2% 白边;FlashAttention 的 Figure 2 在第 6 页)
  77. python <skill-dir>/scripts/extract_fig.py paper.pdf 6 2 fig2.png
  78. # 双栏页 / 特殊图注(Figure 1 |、Fig. 1: 等)→ 显式矩形(pt)
  79. # 例:vLLM 论文第 5 页右栏的 Figure 5
  80. python <skill-dir>/scripts/extract_svg.py paper.pdf 5 5 fig5.svg --clip "318,40,560,168"
  81. # 批量边界检查(PNG / JPG / SVG / 目录)
  82. python <skill-dir>/scripts/check_border.py path/to/images/
  83. ```
  84. 每个脚本都内置自检:提取后立即检查四边墨迹比例,超阈值(0.3%)即以退出码 3 报 WARN,不会静默输出坏图。
  85. ## 工作原理
  86. 1. **caption 锚定**:以 `Figure N:` 图注文本行 bbox 为锚点,向「上」合并 image/vector 块并集作为图区,硬停在 caption 之前;
  87. 2. **安全边距**:PNG 模式注入 1.2% 白边后自检四边;SVG 模式校验 clip 矩形边界;
  88. 3. **背景感知**:边界检查以四角颜色估计背景,深色主题图不误报。
  89. 详细设计、已知坑与对策见 [skills/pdf-figure-extract/SKILL.md](skills/pdf-figure-extract/SKILL.md)。
  90. ## 已验证场景
  91. - arXiv 单栏技术报告(DeepSeek-V3、Llama 3、Kimi K2/K3、GLM-5 等)
  92. - 双栏论文(vLLM、Attention Is All You Need、KD 综述)
  93. - 章节式图编号(GPT-3 的 `Figure 3.1`)
  94. - 非冒号图注(`Figure 2 |`)
  95. - 双子图拆分(同一 Figure 的左右子图独立提取)
  96. ## 不适用
  97. - 网页 / 博客截图来源(非 PDF):贴边只能重新截图;
  98. - 跨页图:需手工处理。
  99. ## 目录结构
  100. ```text
  101. pdf-figure-extract/
  102. ├── plugin.json # 通用 Agent Plugins 清单
  103. ├── .claude-plugin/ # Claude Code 插件与 marketplace 清单、图标
  104. ├── skills/pdf-figure-extract/ # 技能本体(SKILL.md + scripts + Codex 元数据)
  105. ├── tests/ # 单元、回归、CLI、README 冒烟、打包校验
  106. ├── install.sh # 源码安装(软链 / 复制到各 agent 目录)
  107. └── AGENTS.md # 给仓库内编码 agent 的约定
  108. ```
  109. ## 测试
  110. ```bash
  111. pip install -r requirements-dev.txt
  112. # 离线:单元 + 回归 + CLI + 打包校验
  113. python -m pytest tests/ -q
  114. # README 命令逐条冒烟(联网下载 arXiv PDF)
  115. python -m pytest tests/test_readme_commands.py --net -q
  116. ```
  117. 测试分层:
  118. - `tests/test_unit.py`:caption 锚定(含章节编号、无交叉误配)、边界墨迹检测(含深色背景不误报)、错误路径;
  119. - `tests/test_regression.py`:历史 bug 回归(图内图例 TXT 块被切、两脚本 figure_clip 行为一致性);
  120. - `tests/test_cli.py`:CLI 退出码、`--clip` 跳过 caption 查找、PNG 白边注入、check_border 目录扫描;
  121. - `tests/test_readme_commands.py`:README 示例命令原样执行(默认跳过,`--net` 开启);
  122. - `tests/test_packaging.py`:frontmatter 规范、三处版本号一致、marketplace 条目、`install.sh` 行为。
  123. ## License
  124. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.