pdf-reader

Extract text from local PDFs, URLs, and WhatsApp attachments to stdout.

1|Updated Mar 9, 2026
One-click install
npx skills add https://github.com/breakcafe/picoclaw --skill pdf-reader-breakcafe
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pdf-reader
Source: https://github.com/breakcafe/picoclaw/tree/main/.claude/skills/add-pdf-reader/add/container/skills/pdf-reader
Command: npx skills add https://github.com/breakcafe/picoclaw --skill pdf-reader-breakcafe

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Extracting readable text from PDF documents is tedious and time-consuming when done manually, especially across many files, URLs, or message attachments.

Core Features & Use Cases

  • Text extraction from PDFs with optional layout preservation to maintain tables and columns.
  • Metadata retrieval (title, author, page count) and size estimation for quick validation.
  • Recursive directory search to locate PDFs and process batches, including attachments from messaging apps.

Quick Start

Run pdf-reader extract <file> to print the full text of a PDF.

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 from a PDF file for downstream processing?

To extract text from a PDF file, the tool uses Poppler utilities like pdftotext to output plain text directly to stdout. This enables quick review and feeds extracted content into downstream data pipelines or AI prompts.

Can I preserve the original layout and tables when extracting text from PDFs?

Yes, extracting text from PDFs supports optional layout preservation to maintain tables and columns. This ensures the original formatting remains intact in the plain text output for accurate downstream processing.

How do I retrieve metadata like page count and author from a PDF document?

Retrieving metadata from a PDF document uses the pdfinfo utility to fetch details like title, author, and page count. This also provides size estimation for quick validation before performing full text extraction.

Does this tool work with remote PDFs and WhatsApp attachments?

Yes, the tool works with remote PDFs by downloading them via curl and processes WhatsApp attachments saved in the attachments/ directory. It ensures consistent text extraction across local files, URLs, and messaging app attachments.

What is the best way to process multiple PDF documents in a directory?

Processing multiple PDF documents utilizes a recursive directory search to locate and process batches of files. This approach handles bulk text extraction efficiently, including attachments exported from messaging applications.

Do I need to install Poppler tools to extract text from PDFs?

Yes, extracting text from PDFs relies on the Poppler tools suite, specifically pdftotext and pdfinfo, along with curl for downloading remote files. Standard Unix utilities are also used for file handling and output processing.