pymupdf-pdf
Fast local PDF parsing with PyMuPDF (fitz) for Markdown/JSON outputs and optional images/tables. Use when speed matters more than robustness, or as a fallback while heavier parsers are unavailable. Default to single-PDF parsing with per-document output folders.
How do I install this agent skill?
npx skills add https://github.com/kesslerio/pymupdf-pdf-parser-skill --skill pymupdf-pdfIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill provides PDF parsing capabilities using the PyMuPDF library to extract text and images from local documents. The security analysis identified a low-severity risk related to how the skill handles untrusted data. Because the tool extracts content from external PDF files and presents it to the AI agent without sanitization, a malicious document could potentially include instructions designed to influence the agent's behavior (indirect prompt injection). This is a standard risk for skills processing external file content.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
What does this agent skill do?
PyMuPDF PDF
Overview
Parse PDFs locally using PyMuPDF for fast, lightweight extraction into Markdown by default, with optional JSON and image/table outputs in a per-document directory.
Prereqs / when to read references
If you hit import errors (PyMuPDF not installed) or Nix libstdc++ issues, read:
references/pymupdf-notes.md
Quick start (single PDF)
# Run from the skill directory
./scripts/pymupdf_parse.py /path/to/file.pdf \
--format md \
--outroot ./pymupdf-output
Options
--format md|json|both(default:md)--imagesto extract images--tablesto extract a simple line-based table JSON (quick/rough)--outroot DIRto change output root--langadds a language hint into JSON output metadata
Output conventions
- Create
./pymupdf-output/<pdf-basename>/by default. - Markdown output:
output.md - JSON output:
output.json(includeslang) - Images:
images/subdir - Tables:
tables.json(rough line-based)
Notes
- PyMuPDF is fast but less robust on complex PDFs.
- For more robust parsing, use a heavy-duty OCR parser (e.g., MinerU) if installed.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/kesslerio/pymupdf-pdf-parser-skill/pymupdf-pdf">View pymupdf-pdf on skillZs</a>