pdf-to-expert-report

name

pdf-to-expert-report

description

Transforms a research paper PDF into a comprehensive, visually-rich expert report by extracting ALL content (text, figures, diagrams, tables, equations, algorithms) using parallel vision agents, then synthesizing into a structured report optimized for PhD-level readers who lack domain expertise but are eager to master the paper in one reading. Trigger this skill whenever a user: - Provides any .pdf file path and wants to understand, analyze, summarize, or report on it - Says "read this paper", "explain this PDF", "brief me on this research", "create a report from this paper", "help me understand this", "master this paper", "extract knowledge from" - Wants deep understanding of academic or technical content from a PDF - Asks "what does this paper say about X" or "what are the key findings in this PDF" - Provides a PDF and asks ANY analytical or comprehension question about its content Always invoke this skill proactively — even for "quick summaries", the parallel extraction approach catches visual content (diagrams, charts) that plain text extraction misses. This skill is the right choice any time a PDF is involved and understanding is the goal.

PDF to Expert Report

A lossless, visually-aware pipeline that turns any research paper PDF into a report designed to let a PhD reader in ANY field master the paper in one sitting. Built on the insight that research papers communicate critical information through diagrams, charts, and figures — not just text — this skill uses vision-capable agents to see the full rendered page.

---

Overview of the Pipeline

PDF
 │
 ├─ Step 0: Render pages to PNG (PyMuPDF, 120 DPI)
 │          → preserves all visual content
 │
 ├─ Step 1: Read first 4 pages → identify paper, structure, scope
 │
 ├─ Step 2: Launch N parallel extraction agents (one per ~20 pages)
 │          → each agent sees and describes ALL content on their pages
 │          → each agent writes extract_pages_NNN_MMM.md
 │
 └─ Step 3: Read all extractions → write comprehensive report
            REPORT_<title>.md

---

Step 0: Setup and Rendering

Check dependencies

python -c  2>&1