pdf

# PDF Processing Guide ## When to use this skill Load this skill whenever the workflow involves PDF input or output. In the paideia context specifically: - Converting `materials/**/*.pdf` to markdown in `converted/**/*.md` (via `/ingest`) - Converting hand-written answer PDFs in `answers/*.pdf` to markdown in `answers/converted/*.md` (via `/grade`) - OCR for scanned lecture notes, textbook chapters, or hand-written work ## Quick decision tree ``` What kind of PDF? ├─ Course material (materials/**/*.pdf) → VISION pipeline (see VISION.md) │ pdfplumber is unreliable on course │ content — even "prose-heavy" │ textbook pages mix in equations, │ figures, and multi-column layouts │ that break digital extraction │ silently. We route everything │ through vision instead of │ maintaining a per-category heuristic. ├─ Hand-written answer PDF → vision-ocr skill (see vision-ocr/) └─ Arbitrary outside-the-plugin PDF → pdfplumber / pypdf / pytesseract per the sections below, case-by-case ``` Within this plugin, `/paideia:ingest` routes **all** `materials/**/*.pdf` through the vision pipeline. The `pdfplumbe...