pdf-summarizer

Indexes and summarizes document folders into a persistent README.md cache.

Updated Mar 21, 2026
One-click install
npx skills add https://github.com/pulak999/ai-tooling --skill pdf-summarizer-pulak999
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pdf-summarizer
Source: https://github.com/pulak999/ai-tooling/tree/main/ai-assistant-kit/cursor-skills/pdf-summarizer
Command: npx skills add https://github.com/pulak999/ai-tooling --skill pdf-summarizer-pulak999

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python-docx, PyMuPDF, and includes scripts (resource) and references (resource) components.

What problem does it solve? Reading and re-reading large folders of PDFs, DOCX files, and notes for every question wastes time and context. This Skill builds a persistent README.md index of structured summaries so later questions are answered from the cache instead of re-opening every source file. ## Core Features & Use Cases - Folder-scale indexing: Scans a directory of PDF, DOCX, Markdown, and text files, then writes a structured five-point summary (problem, difficulty, rejected alternatives, solution, key details) per document into a README.md cache. - Staleness detection: Uses check-stale.sh to compare source modification times against summary dates and re-summarizes only STALE or MISSING entries. - README-first querying: Answers questions from the index and re-opens source files only for quotes, tables, or gaps, fetching targeted page ranges rather than whole documents. - Use Case: A researcher with 30 papers in a folder asks "what do these papers say about GPU virtualization" and gets an answer synthesized from the index without re-reading every PDF. ## Quick Start Ask the assistant to summarize and index all documents in a chosen folder so future questions about them are answered from the generated README index.

Frequently Asked Questions about pdf-summarizer

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

FAQPage Schema
How do I summarize a folder of PDF documents at once?

Point the skill at the folder and it lists all documents, extracts text with pdftotext or PyMuPDF, and writes a structured five-point summary per file into a README.md index. New files are batched in one pass and the README is written once at the end.

How to extract text from PDF files for summarization?

Use pdfinfo to inspect the file, sample pages with pdftotext, then run the extract-text.sh helper for full text. For PDFs over 40 pages, start with the abstract, introduction, and conclusion before reading methods or appendices.

Does PDF summarization work with scanned documents?

Scanned PDFs lack a text layer, so standard extraction returns nothing. The skill recommends sampling pages or installing OCR tools like tesseract-ocr or ocrmypdf when full text from scanned documents is required.

Can I index Word DOCX and Markdown files together with PDFs?

Yes, one README.md can index mixed folders containing PDFs, DOCX, Markdown, and plain text. DOCX files are read with python-docx, while Markdown and text files are read directly.

How are document summaries kept up to date when files change?

The check-stale.sh script compares each source file's modification time against its Summarized date in the README. Entries reported as STALE or MISSING are re-summarized in place, and entries are marked [STALE] until refreshed.

When should I not use folder-scale document indexing?

Avoid it for single-file coding reads or one-off questions about one document, where reading the file directly is faster. The index pays off only when a folder is queried repeatedly over time.