pdf-reader

Extract text, tables, and images from PDF documents using Python libraries.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/robinade/persona-theater --skill pdf-reader-robinade
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pdf-reader
Source: https://github.com/robinade/persona-theater/tree/main/.claude/skills/pdf-reader
Command: npx skills add https://github.com/robinade/persona-theater --skill pdf-reader-robinade

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill consolidates PDF content extraction, enabling automatic retrieval of text, tables, and images from PDF documents using reliable Python libraries, reducing manual data collection.

Core Features & Use Cases

  • Text extraction with preserved layout: Retrieve readable, structured text that maintains page structure.
  • Table detection and extraction: Identify and export tabular data for downstream processing.
  • Image extraction and metadata: Pull embedded images and document metadata for branding or archival tasks.
  • Use Case: Analyze brand guidelines or invoices to assemble searchable content, tables, and media into a unified dataset.

Quick Start

  • Install dependencies: pip install pdfplumber pymupdf pillow
  • Extract from PDF: python scripts/extract_pdf.py <path/to/document.pdf> --output-dir ./output
  • Inspect outputs: check extracted_text.md, extracted_tables.json, metadata.json, and images/ directory

Frequently Asked Questions about pdf-reader

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I extract text and tables from a PDF document?

You can extract text and tables from a PDF using Python libraries like pdfplumber and PyMuPDF, which retrieve readable text with preserved layout and export tabular data into structured JSON files.

Can I extract embedded images from PDF documents?

Yes, you can extract embedded images from PDF documents using PyMuPDF and Pillow, which pull visual media into a dedicated images directory alongside document metadata.

What is the best way to parse invoices and brand materials from PDF files?

The best way to parse invoices and brand materials from PDF files is using a consolidated Python extraction script that outputs structured text, tables, and images for downstream analysis.

Does PDF text extraction with pdfplumber preserve the original page layout?

Yes, PDF text extraction with pdfplumber preserves the page layout, retrieving readable and structured text that maintains the original document's page structure in a markdown file.

What output formats are generated when extracting PDF content?

Extracting PDF content generates a markdown file for text, a JSON file for tables, a JSON file for metadata, and a dedicated directory containing extracted images.

Do I need Python to extract tables and images from a PDF?

Yes, you need Python installed along with the pdfplumber, PyMuPDF, and Pillow libraries to run the extraction scripts that pull tables, images, and text from your documents.

Related Skills