pdf-conversion-router
Use when converting a PDF into another format such as Markdown, HTML, text, JSON, DOCX, or structured notes and the agent must choose the best extraction route, settings, and cleanup strategy for maximum fidelity and readability.
npx skills add sickn33/agentic-awesome-skills --skill pdf-conversion-router --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# PDF Conversion Router Route every PDF conversion through a short analysis step before choosing tools or CLI flags. The goal is not "extract the most text". The goal is: - preserve structure - preserve attachment between labels and values - choose the most faithful output shape - avoid noisy defaults when a better route exists ## When to Use - The user wants a PDF converted into another format. - The requested output is `.md`, `.html`, `.txt`, `.json`, `.docx`, or structured notes. - The PDF may be scanned, OCR-heavy, table-heavy, slide-based, medical, academic, or multi-column. ## Core Rule Never start with one fixed default pipeline. Always: 1. classify the PDF 2. classify the target output 3. choose the strongest route for that combination 4. validate the result on representative sections 5. if needed, retry with better settings before delivering Heuristics are starting points, not guarantees. Do not promote one flag combination into a universal default just because it worked well on one PDF. Prefer document-specific evidence over habit. ## Primary Engine Rule Use `opendataloader-pdf` as the primary conversion engine for every PDF conversion task by default. This skill should a
- When to Use
- Core Rule
- Primary Engine Rule
- Step 1: Classify the Source PDF
- Document-Type Heuristics
- Step 2: Choose the Output Shape
- Step 3: Choose the Extraction Route
- For OpenDataLoader CLI
- For medical or lab PDFs
- For slide decks
- For scanned PDFs
- Step 4: Validation Gates
- Red Flags
- Never Trust Page 1
pdfinfo input.pdf pdftotext -layout input.pdf - opendataloader-pdf -f markdown-with-html --table-method cluster --image-output off opendataloader-pdf -f markdown-with-html --image-output off
What does the pdf-conversion-router skill do?
Use when converting a PDF into another format such as Markdown, HTML, text, JSON, DOCX, or structured notes and the agent must choose the best extraction route, settings, and cleanup strategy for maximum fidelity and readability.
How do I install it?
Run `npx skills add sickn33/agentic-awesome-skills --skill pdf-conversion-router --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From sickn33/agentic-awesome-skills, a repository with 44,414 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.