extract-paper-images

Extract figures from academic papers by prioritizing arXiv source packages over PDF extraction.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Extracting figures from research paper PDFs often yields logos, icons, and decorative elements instead of the actual architecture diagrams and experiment result charts, because many figures are LaTeX vector graphics not stored as standalone image objects in the PDF. ## Core Features & Use Cases - arXiv Source Package Extraction: Downloads the paper's source tarball from arXiv and pulls original high-resolution figures from directories like pics/, figures/, and images/. - Three-Tier Fallback Strategy: Falls back from source package extraction to converting embedded PDF figure files into PNGs, then to direct PDF image extraction when sources are unavailable. - Indexed Output: Saves all images to a structured directory and generates an index.md file listing each image with its path, size, format, and source type. - Use Case: Given an arXiv ID like 2510.24701, automatically download the paper, extract its real figures (pipeline diagrams, result charts), and receive a list of image paths ready to embed in your research notes. ## Quick Start Extract all figures from arXiv paper 2510.24701 and save them with an index file into my paper notes folder.

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 figures from an arXiv paper?▼

Provide the arXiv ID (e.g., 2510.24701) and the script downloads the paper's source package from arxiv.org/e-print, then copies original figure files from directories like pics/ or figures/. This yields the author's original high-resolution images rather than PDF artifacts.

Why does PDF image extraction return logos instead of paper figures?▼

PDFs store logos and icons as image objects while real figures are often LaTeX vector graphics without standalone image data. Extracting from the arXiv source package avoids this by accessing the author's original figure files directly.

Can I extract images from a local PDF file instead of arXiv?▼

Yes, pass a local PDF path instead of an arXiv ID. The script detects an arXiv ID from the filename if present and tries the source package first, otherwise it extracts embedded images directly from the PDF using PyMuPDF.

What happens if the arXiv source package download fails?▼

The script automatically falls back to direct PDF extraction when the source download fails or yields too few images. Check your network connection and verify the arXiv ID format (YYYYMM.NNNNN) if downloads repeatedly fail.

What Python libraries are needed to extract paper images?▼

The script requires PyMuPDF (fitz) for PDF processing and image conversion, plus the requests library for downloading arXiv source packages. If requests is unavailable, it falls back to urllib from the standard library.