Agent skill

pdf-reader

Read and extract text from PDF files — documents, reports, contracts, spreadsheets. Use whenever you need to read PDF content, not just when explicitly asked. Handles local files, URLs, and WhatsApp attachments.

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/pdf-reader-qwibitai-nanoclaw

SKILL.md

PDF Reader

Quick start

bash
pdf-reader extract report.pdf              # Extract all text
pdf-reader extract report.pdf --layout     # Preserve tables/columns
pdf-reader fetch https://example.com/doc.pdf  # Download and extract
pdf-reader info report.pdf                 # Show metadata + size
pdf-reader list                            # List all PDFs in directory tree

Commands

extract — Extract text from PDF

bash
pdf-reader extract <file>                        # Full text to stdout
pdf-reader extract <file> --layout               # Preserve layout (tables, columns)
pdf-reader extract <file> --pages 1-5            # Pages 1 through 5
pdf-reader extract <file> --pages 3-3            # Single page (page 3)
pdf-reader extract <file> --layout --pages 2-10  # Layout + page range

Options:

  • --layout — Maintains spatial positioning. Essential for tables, spreadsheets, multi-column docs.
  • --pages N-M — Extract only pages N through M (1-based, inclusive).

fetch — Download and extract PDF from URL

bash
pdf-reader fetch <url>                    # Download, verify, extract with layout
pdf-reader fetch <url> report.pdf         # Also save a local copy

Downloads the PDF, verifies it has a valid %PDF header, then extracts text with layout preservation. Temporary files are cleaned up automatically.

info — PDF metadata and file size

bash
pdf-reader info <file>

Shows title, author, page count, page size, PDF version, and file size on disk.

list — Find all PDFs in directory tree

bash
pdf-reader list

Recursively lists all .pdf files with page count and file size.

WhatsApp PDF attachments

When a user sends a PDF on WhatsApp, it is automatically saved to the attachments/ directory. The message will include a path hint like:

[PDF attached: attachments/document.pdf]

To read the attached PDF:

bash
pdf-reader extract attachments/document.pdf --layout

Example workflows

Read a contract and summarize key terms

bash
pdf-reader info attachments/contract.pdf
pdf-reader extract attachments/contract.pdf --layout

Extract specific pages from a long report

bash
pdf-reader info report.pdf                    # Check total pages
pdf-reader extract report.pdf --pages 1-3     # Executive summary
pdf-reader extract report.pdf --pages 15-20   # Financial tables

Fetch and analyze a public document

bash
pdf-reader fetch https://example.com/annual-report.pdf report.pdf
pdf-reader info report.pdf

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results