Agent skill · AI & Agents

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.

Nick44,414★ · +328/wk · 1 repos on radarProfile →
claude-codecodexcursorMIT
Install
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.

Facts
Files in the skill folder: 1
SKILL.md size: 15 KB
Bundled scripts: none
Path: skills/pdf-conversion-router/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 44,414 · +328 this week
Language: Python
Read our review of the source →

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

From the SKILL.md

# 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

What's inside
Steps it walks through
  1. When to Use
  2. Core Rule
  3. Primary Engine Rule
  4. Step 1: Classify the Source PDF
  5. Document-Type Heuristics
  6. Step 2: Choose the Output Shape
  7. Step 3: Choose the Extraction Route
  8. For OpenDataLoader CLI
  9. For medical or lab PDFs
  10. For slide decks
  11. For scanned PDFs
  12. Step 4: Validation Gates
  13. Red Flags
  14. Never Trust Page 1
Commands it runs
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
More from agentic-awesome-skills
All skills →
About this skill
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.

Keep going