pdf-reader

Extract text and render math-heavy PDF pages for accurate reading.

Updated May 4, 2026
One-click install
npx skills add https://github.com/panamini/pi-tooling --skill pdf-reader-panamini
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pdf-reader
Source: https://github.com/panamini/pi-tooling/tree/main/skills/pdf-reader
Command: npx skills add https://github.com/panamini/pi-tooling --skill pdf-reader-panamini

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Manually reading and extracting key information from math-heavy or diagram-heavy PDFs is slow and error-prone, especially when equations and figures do not copy cleanly.

Core Features & Use Cases

  • PDF triage before deep reading: Extracts page count, TOC (when available), per-page text length, image count, and estimated math density to decide what to extract vs. render.
  • Hybrid comprehension for math and diagrams: Supports text extraction by page plus selective page rendering to images for accurate visual reading of equations and figures.
  • Targeted search and lookup: Searches by regex or literal strings and then renders only the relevant pages to explain or summarize precise content with page references.

Use case: You have a lecture packet or paper and need the exact statement of a theorem or the explanation around “Theorem 3.2”; you can search to find the page and then visually read that page to avoid math rendering issues.

Quick Start

Run the pdf-reader skill on the provided PDF to triage it, selectively extract text, and render only the math/diagram-heavy pages for accurate reading and summarization.

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 read math equations from academic PDF papers?

To extract text and read math equations from academic PDF papers, this tool triages pages by text length and math density, then selectively renders math-heavy pages into images for accurate visual reading. It uses PyMuPDF-based page analysis to bypass typical equation rendering issues.

How do I find a specific theorem in a PDF and get its exact page reference?

You can find a specific theorem in a PDF and get its exact page reference by using regex or literal string search to locate relevant lines. It then renders only the matching pages, allowing you to visually verify the theorem statement without manual scrolling.

Does PyMuPDF support rendering diagram-heavy PDF pages into images?

Yes, PyMuPDF supports rendering diagram-heavy PDF pages into images. The tool uses deterministic per-page text extraction and page-range rendering to convert complex diagrams and equations into readable visual material for accurate comprehension.

What is the best way to summarize math lecture notes stored as PDFs?

The best way to summarize math lecture notes stored as PDFs is to triage the document using TOC support and per-page analysis. This extracts clean text while rendering math-heavy sections visually, ensuring accurate summarization with correct page references.

Why does copying text from a math-heavy PDF result in broken equations?

Copying text from a math-heavy PDF results in broken equations because standard text extraction often fails on complex formatting. This tool solves the problem by rendering those specific pages into images for visual reading instead of relying solely on text extraction.

Can I use this PDF reader to get a table of contents and page count before extracting text?

Yes, you can use this PDF reader to get a table of contents and page count before extracting text. It performs PDF triage to extract page count, TOC, per-page text length, and image count to decide what to extract versus render.