extract-paper-images

Extract paper figures from arXiv sources or PDFs into an indexed images directory.

2|Updated Apr 12, 2026
One-click install
npx skills add https://github.com/Clay-HHK/claude-config --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-config/tree/main/skills/extract-paper-images
Command: npx skills add https://github.com/Clay-HHK/claude-config --skill extract-paper-images-clay-hhk

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

It automates the extraction of high-quality figures from academic papers by prioritizing arXiv source packages to avoid logos and decorative images.

Core Features & Use Cases

  • Priority-based extraction: pull real figures from arXiv source dirs such as pics, figures, or images, with fallbacks to PDF images when needed.
  • Multiple inputs & outputs: accepts arXiv IDs or local PDFs and outputs organized images under a notes-friendly path with an index.md.
  • Use Case: researchers collect figures for literature reviews by automatically generating image assets and links for notes.

Quick Start

Run the extract-paper-images command with an arXiv ID (for example, 2510.24701) to fetch and index all paper images into your notes.

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

To extract figures from an arXiv paper, provide the arXiv ID to fetch the source package and pull true figures from directories like pics, figures, or images. This method avoids PDF logos and decorative images by prioritizing original source files.

Can I extract figures from a local PDF file?

Yes, you can extract figures from a local PDF file. The tool uses PyMuPDF for PDF-based extraction as a fallback when arXiv source packages are unavailable, ensuring you still get the images needed for your research notes.

How are extracted paper images organized for research notes?

Extracted paper images are organized into a structured directory under 20_Research/Papers/[field]/[paper title]/images. An index.md file is also generated to provide notes-friendly links and preserve image sources like arxiv-source or pdf-figure.

Does extracting images from arXiv source packages improve quality over PDF extraction?

Extracting images from arXiv source packages yields higher quality figures because it retrieves the original true figures directly. This approach bypasses PDF compression artifacts and filters out decorative images or logos typically embedded in compiled PDFs.

What Python libraries are needed to extract paper images?

The image extraction process requires Python with the PyMuPDF and requests libraries. PyMuPDF handles PDF-based image extraction, while requests manages fetching arXiv source packages when using an arXiv ID as input.