extract-paper-images

Extract paper figures from arXiv source assets or PDFs with PyMuPDF.

5|Updated Mar 14, 2026
One-click install
npx skills add https://github.com/JaneHuang1833/claude-code-paper-skills --skill extract-paper-images-janehuang1833
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: extract-paper-images
Source: https://github.com/JaneHuang1833/claude-code-paper-skills/tree/main/extract-paper-images
Command: npx skills add https://github.com/JaneHuang1833/claude-code-paper-skills --skill extract-paper-images-janehuang1833

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires PyMuPDF, requests, and includes scripts (resource) components.

What problem does it solve?

这个技能从论文中提取图片,优先使用 arXiv 源码包中的实际论文图片,生成易于引用的图片库,避免把论文中的徽标或装饰性图片误当成核心图片。

Core Features & Use Cases

  • 优先从 arXiv 源码包(pics/、figures/、fig/、images/、img/ 等目录)提取原始论文图片;若源码中未找到合适图片,则从源码中的 PDF 提取图片作为备选,并生成图片索引。
  • 支持从 arXiv ID 或本地 PDF 提取,输出到 20_Research/Papers/[领域]/[论文标题]/images/ 目录,并返回图片路径供笔记引用。
  • 生成图片索引 markdown,标注来源(arxiv-source、pdf-figure、pdf-extraction),方便后续查阅与复用。

Quick Start

Provide a paper ID to start extracting images, and the tool will save them under the paper's images directory and an index will be generated.

Frequently Asked Questions about extract-paper-images

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I extract true paper figures from arXiv sources instead of decorative images?

To extract true paper figures from arXiv sources, prioritize fetching source packages to retrieve original images from directories like pics/ or figures/, avoiding decorative logos. This ensures a clean image library for notes.

Can I extract images from a local PDF if the arXiv source package is unavailable?

Yes, you can extract images from a local PDF as a fallback. The tool first attempts arXiv source extraction, then falls back to PDF-based extraction to generate an image index and paths.

Do I need PyMuPDF installed to extract arXiv paper images?

Yes, you need PyMuPDF installed to extract arXiv paper images, as it handles PDF-based image extraction and fallback processing. Optional network access is also required for arXiv source retrieval.

What's the best way to organize extracted paper images for research notes?

The best way to organize extracted paper images is saving them to a structured directory like 20_Research/Papers/[Field]/[Title]/images/. The tool generates a markdown index tagging image sources for easy reference.

Why does PDF image extraction often include unwanted logos or decorative graphics?

PDF image extraction often includes unwanted logos because it scrapes all embedded objects indiscriminately. Prioritizing arXiv source package extraction filters out decorative graphics, retrieving only true paper figures.

Does this tool work with both arXiv IDs and local PDF files for image extraction?

Yes, the tool works with both arXiv IDs and local PDF files for image extraction. It applies source-image extraction first for arXiv IDs, then uses PDF extraction as a fallback for both input types.