How do I install the Pymupdf skill?

Run npx skillmds@latest add modbender/pymupdf in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Pymupdf safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Pymupdf?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Pymupdf free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Pymupdf?

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Pymupdf by modbender — Agent Skill

Name: Pymupdf
Rating: 4.5 (4 reviews)
Author: modbender

Pymupdf

Render PDF pages to images, extract embedded images, annotate PDFs, and perform advanced PDF inspection using pymupdf (fitz). Use for tasks such as exporting pages as PNG/JPG, extracting images embedded in a PDF, drawing annotations, redacting content, or when high-fidelity rendering is required. For text extraction, splitting, merging, or rotating PDFs, use the pypdf skill instead.

modbender Updated Sep 9, 2026 12 repo stars

File contents

pymupdf

Use scripts/pymupdf_cli.py for deterministic pymupdf operations instead of ad-hoc fitz snippets.

Workflow

Confirm the PDF file path is accessible locally.
Run the desired command (export-images, extract-images, info).
Inspect the output directory or stdout.

Command Guide

Export pages as images:
- python scripts/pymupdf_cli.py export-images --input <file.pdf> --output-dir <dir/>
- Override format: --format png (default), jpg, or ppm.
- Override resolution: --dpi 300 (default: 150).
- Restrict to specific pages: --pages 0 1 2.
Extract images embedded inside a PDF:
- python scripts/pymupdf_cli.py extract-images --input <file.pdf> --output-dir <dir/>
- Optionally restrict to specific pages: --pages 0 1 2.
Inspect page dimensions and basic document info:
- python scripts/pymupdf_cli.py info --input <file.pdf>

Operational Rules

Pages are always 0-indexed in all commands.
export-images renders each page as a raster image at the specified DPI.
extract-images saves raw image streams embedded in the PDF (e.g. photos, logos); output filenames include page index and image index.
Install dependency if missing: pip install pymupdf.
For text extraction, splitting, merging, or rotating PDFs, use the pypdf skill instead.

Frequently asked questions