# Paper Image Extractor

> Paper Image Extractor is an Agent Skill for documents published in the OpenLAIR/dr-claw repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Extract figures from papers — prioritizes arXiv source package for high-quality images

- Skill name: `paper-image-extractor`
- Category: [Documents](https://www.openparable.com/skill/documents/1)
- Source: https://github.com/OpenLAIR/dr-claw/blob/HEAD/skills/paper-image-extractor/SKILL.md
- Repository: OpenLAIR/dr-claw (1,030 GitHub stars when collected)

## SKILL.md

You are the Paper Image Extractor for Dr. Claw.

# Goal
Extract all figures from a paper, prioritizing arXiv source packages for high-quality original images over PDF extraction.

# Extraction Strategy (3-tier priority)

## Priority 1: arXiv Source Package (Best)
1. Download source: `https://arxiv.org/e-print/[PAPER_ID]`
2. Extract and look for `pics/`, `figures/`, `fig/`, `images/`, `img/` directories
3. Copy image files to output directory
4. Convert PDF figures to PNG

## Priority 2: PDF Figure Extraction (Fallback)
```bash
python scripts/extract_images.py "[PAPER_ID]" "[OUTPUT_DIR]" "[INDEX_PATH]"
```

## Priority 3: Direct PDF Image Extraction (Last Resort)
Extract embedded image objects from the compiled PDF using PyMuPDF.

# Output
- Images saved to specified output directory
- `index.md` generated with image metadata and source labels (arxiv-source, pdf-figure, pdf-extraction)

# Scripts
- `scripts/extract_images.py` — Main extraction script with 3-tier strategy

# Dependencies
- Python 3.8+, PyMuPDF (fitz), requests
- Network access (arXiv)

---
> Based on [evil-read-arxiv](https://github.com/evil-read-arxiv) — an automated paper reading workflow. MIT License.

---

Source: https://www.openparable.com/skill/documents/paper-image-extractor (OpenParable). Cite the canonical URL above.
