How do I install the Pdftotext Fallback skill?

Run npx skillmds@latest add ichichuang/pdftotext-fallback in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Pdftotext Fallback safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Pdftotext Fallback?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Pdftotext Fallback free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Pdftotext Fallback?

ichichuang (@ichichuang) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Pdftotext Fallback by ichichuang — Agent Skill

Name: Pdftotext Fallback
Rating: 4.2 (5 reviews)
Author: ichichuang

File contents

pdftotext Fallback for PDF Text Extraction

When to Use

Apply this pattern when:

read_file on a PDF returns binary/image data instead of readable text
Python-based PDF extraction (PyMuPDF, pdfplumber, etc.) in execute_code_sandbox fails or returns garbled content
You need reliable text extraction from PDF files as a recovery strategy

Why This Works

The pdftotext utility (from poppler-utils) is a mature, command-line tool that handles many PDF edge cases that confuse Python libraries or the read_file tool. It's pre-installed on most Linux systems and provides consistent, reliable text extraction.

Steps

Step 1: Detect the Failure

Recognize extraction failure when:

read_file returns binary content, image data, or garbled text
Error messages indicate encoding issues or unsupported formats
Python PDF libraries in sandbox fail with import errors or extraction failures

Step 2: Use pdftotext via run_shell

Extract to stdout (recommended for quick extraction):

pdftotext /path/to/file.pdf -

The - argument outputs directly to stdout for easy capture in your tool response.

Example:

run_shell("pdftotext document.pdf -")

Step 3: Handle Complex PDFs

Preserve layout (maintains original formatting):

pdftotext -layout /path/to/file.pdf -

Extract to a file (for large PDFs):

pdftotext /path/to/file.pdf /path/to/output.txt

Then read the output file with read_file.

Handle encoded text:

pdftotext -enc UTF-8 /path/to/file.pdf -

Step 4: Verify and Continue

Check the extracted text for completeness
If text is still garbled, the PDF may be image-based (scanned) - consider OCR tools
Proceed with your task using the extracted text

Code Examples

Basic extraction:

# Simple text extraction
text = run_shell("pdftotext document.pdf -")

With error handling:

# Try extraction, check for success
result = run_shell("pdftotext document.pdf - && echo 'SUCCESS' || echo 'FAILED'")

Multi-page PDF with layout:

# Preserve tables and formatting
text = run_shell("pdftotext -layout document.pdf -")

Troubleshooting

Issue	Solution
`pdftotext: command not found`	Install poppler-utils: `apt-get install poppler-utils`
Garbled/special characters	Try `-enc UTF-8` or `-enc ASCII7`
Missing formatting	Use `-layout` flag
Scanned PDF (no text)	Requires OCR (e.g., tesseract), not text extraction
Large PDF timeout	Extract to file instead of stdout

Limitations

Does not work on image-only (scanned) PDFs without embedded text
May lose complex formatting, tables, or embedded objects
Requires poppler-utils to be installed (common on Linux, may need installation on other systems)

Related Tools

pdfinfo: Get PDF metadata (pages, size, etc.)
pdftoppm: Convert PDF pages to images
tesseract: OCR for scanned PDFs

---name: pdftotext-fallbackdescription: Recover PDF text extraction when read_file returns binary data by using pdftotext via shell--- # pdftotext Fallback for PDF Text Extraction ## When to Use Apply this pattern when: - `read_file` on a PDF returns binary/image data instead of readable text - Python-based PDF extraction (PyMuPDF, pdfplumber, etc.) in `execute_code_sandbox` fails or returns garbled content - You need reliable text extraction from PDF files as a recovery strategy ## Why This Works The `pdftotext` utility (from poppler-utils) is a mature, command-line tool that handles many PDF edge cases that confuse Python libraries or the `read_file` tool. It's pre-installed on most Linux systems and provides consistent, reliable text extraction. ## Steps ### Step 1: Detect the Failure Recognize extraction failure when: - `read_file` returns binary content, image data, or garbled text - Error messages indicate encoding issues or unsupported formats - Python PDF libraries in sandbox fail with import errors or extraction failures ### Step 2: Use pdftotext via run_shell **Extract to stdout** (recommended for quick extraction): ```bash pdftotext /path/to/file.pdf - ``` The `-` argument outputs directly to stdout for easy capture in your tool response. **Example:** ```bash run_shell("pdftotext document.pdf -") ``` ### Step 3: Handle Complex PDFs **Preserve layout** (maintains original formatting): ```bash pdftotext -layout /path/to/file.pdf - ``` **Extract to a file** (for large PDFs): ```bash pdftotext /path/to/file.pdf /path/to/output.txt ``` Then read the output file with `read_file`. **Handle encoded text:** ```bash pdftotext -enc UTF-8 /path/to/file.pdf - ``` ### Step 4: Verify and Continue - Check the extracted text for completeness - If text is still garbled, the PDF may be image-based (scanned) - consider OCR tools - Proceed with your task using the extracted text ## Code Examples **Basic extraction:** ```bash # Simple text extraction text = run_shell("pdftotext document.pdf -") ``` **With error handling:** ```bash # Try extraction, check for success result = run_shell("pdftotext document.pdf - && echo 'SUCCESS' || echo 'FAILED'") ``` **Multi-page PDF with layout:** ```bash # Preserve tables and formatting text = run_shell("pdftotext -layout document.pdf -") ``` ## Troubleshooting | Issue | Solution | |-------|----------| | `pdftotext: command not found` | Install poppler-utils: `apt-get install poppler-utils` | | Garbled/special characters | Try `-enc UTF-8` or `-enc ASCII7` | | Missing formatting | Use `-layout` flag | | Scanned PDF (no text) | Requires OCR (e.g., tesseract), not text extraction | | Large PDF timeout | Extract to file instead of stdout | ## Limitations - Does not work on image-only (scanned) PDFs without embedded text - May lose complex formatting, tables, or embedded objects - Requires poppler-utils to be installed (common on Linux, may need installation on other systems) ## Related Tools - `pdfinfo`: Get PDF metadata (pages, size, etc.) - `pdftoppm`: Convert PDF pages to images - `tesseract`: OCR for scanned PDFs

Frequently asked questions

Pdftotext Fallback