boazcstrike/extracting-pdf-text
skills/extracting-pdf-text/SKILL.md
Extract text from PDFs for LLM consumption. Use when processing PDFs for RAG, document analysis, or text extraction. Supports API services (Mistral OCR) and local tools (PyMuPDF, pdfplumber). Handles text-based PDFs, tables, and scanned documents with OCR.
$ install --global
skillsauthnpx skillsauth add boazcstrike/opencode extracting-pdf-textInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 20, 2026, 3:14 AM6.2s1 file scanned
SKILL.md
- name:
- extracting-pdf-text
- description:
- Extract text from PDFs for LLM consumption. Use when processing PDFs for RAG, document analysis, or text extraction. Supports API services (Mistral OCR) and local tools (PyMuPDF, pdfplumber). Handles text-based PDFs, tables, and scanned documents with OCR.
- compatibility:
- opencode
- source:
- https://github.com/letta-ai/skills/tree/main/tools/extracting-pdf-text
Extracting PDF Text for LLMs
This skill provides tools and guidance for extracting text from PDFs in formats suitable for language model consumption.
Quick Decision Guide
| PDF Type | Best Approach | Script |
|----------|--------------|--------|
| Simple text PDF | PyMuPDF | ./scripts/extract_pymupdf.py |
| PDF with tables | pdfplumber | ./scripts/extract_pdfplumber.py |
| Scanned/image PDF (local) | pytesseract | ./scripts/extract_with_ocr.py |
| Complex layout, highest accuracy | Mistral OCR API | ./scripts/extract_mistral_ocr.py |
| End-to-end RAG pipeline | marker-pdf | pip install marker-pdf |
Recommended Workflow
- Try PyMuPDF first - fastest, handles most text-based PDFs well
- If tables are mangled - switch to pdfplumber
- If scanned/image-based - use Mistral OCR API (best accuracy) or local OCR (free but slower)
Local Extraction (No API Required)
PyMuPDF - Fast General Extraction
Best for: Text-heavy PDFs, speed-critical workflows, basic structure preservation.
uv run ./scripts/extract_pymupdf.py input.pdf output.md
The script outputs markdown with preserved headings and paragraphs. For LLM-optimized output, it uses pymupdf4llm which formats text for RAG systems.
pdfplumber - Table Extraction
Best for: PDFs with tables, financial documents, structured data.
uv run ./scripts/extract_pdfplumber.py input.pdf output.md
Tables are converted to markdown format. Note: pdfplumber works best on machine-generated PDFs, not scanned documents.
Local OCR - Scanned Documents
Best for: Scanned PDFs when API access is unavailable.
uv run ./scripts/extract_with_ocr.py input.pdf output.txt
Requires: pytesseract, pdf2image, and Tesseract installed (brew install tesseract on macOS).
API-Based Extraction
Mistral OCR API
Best for: Complex layouts, scanned documents, highest accuracy, multilingual content, math formulas.
Pricing: ~1000 pages per dollar (very cost-effective)
export MISTRAL_API_KEY="your-key"
uv run ./scripts/extract_mistral_ocr.py input.pdf output.md
Features:
- Outputs clean markdown
- Preserves document structure (headings, lists, tables)
- Handles images, math equations, multilingual text
- 95%+ accuracy on complex documents
For detailed API options and other services, see references/api-services.md.
For detailed comparisons of local tools, see references/local-tools.md.
Related Skills
boazcstrike/gws-workflow-file-announce
development
VerifiedTrustedCommunity
Google Workflow: Announce a Drive file in a Chat space.
2SKILL.mdUpdated Apr 20, 2026
boazcstrike/gws-workflow-email-to-task
development
VerifiedTrustedCommunity
Google Workflow: Convert a Gmail message into a Google Tasks entry.
2SKILL.mdUpdated Apr 20, 2026
boazcstrike/gws-tasks
development
VerifiedTrustedCommunity
Google Tasks: Manage task lists and tasks.
2SKILL.mdUpdated Apr 20, 2026
boazcstrike/gws-slides
development
VerifiedTrustedCommunity
Google Slides: Read and write presentations.
2SKILL.mdUpdated Apr 20, 2026