oma-pdf
Convert PDF files to Markdown using opendataloader-pdf. Extracts text, tables, headings, lists, and images with correct reading order. Use for PDF parsing, PDF to Markdown conversion, document extraction, and AI-ready data preparation.
npx skills add first-fluke/oh-my-agent --skill oma-pdf --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 Skill - PDF to Markdown Conversion ## Scheduling ### Goal Convert PDF files into structured Markdown or another requested extraction format while preserving readable document structure for LLM context, RAG, or downstream review. ### Intent signature - User asks to convert, parse, read, extract, or transform a PDF. - User needs PDF text, headings, lists, tables, or images prepared for AI consumption. - User mentions "PDF to markdown", "parse PDF", "read this PDF", or equivalent wording. ### When to use - Converting PDF documents to Markdown for LLM context or RAG - Extracting structured content such as tables, headings, lists, images, footnotes, or hyperlinks - Preparing PDF data for AI consumption - Checking whether a PDF has a text layer before choosing OCR ### When NOT to use - Generating or creating PDFs -> use document-generation tools - Editing existing PDFs -> out of scope - Reading an already-text file -> use direct file reading - Processing HWP, HWPX, DOCX, XLSX, or slide decks -> use the matching document skill ### Expected inputs - `input_path`: PDF file or folder path - `output_dir`: optional target directory - `format`: optional output format, default `markdown` -
- Scheduling
- Goal
- Intent signature
- When to use
- When NOT to use
- Expected inputs
- Expected outputs
- Dependencies
- Control-flow features
- Structural Flow
- Entry
- Scenes
- Transitions
- Failure and recovery
uvx opendataloader-pdf "{input_path}" -f text --pages 1-3 --to-stdout -q # text-layer probe (no temp files)
uvx opendataloader-pdf "{input_path}" --format markdown --output-dir "{output_dir}"
uvx mdformat "{output_path}"
uvx --from "opendataloader-pdf[hybrid]" opendataloader-pdf-hybrid --port 5002 --force-ocr --ocr-lang "{languages}"
uvx opendataloader-pdf --hybrid docling-fast --hybrid-mode full "{input_path}" --format markdown --output-dir "{output_dir}"What does the oma-pdf skill do?
Convert PDF files to Markdown using opendataloader-pdf. Extracts text, tables, headings, lists, and images with correct reading order. Use for PDF parsing, PDF to Markdown conversion, document extraction, and AI-ready data preparation.
How do I install it?
Run `npx skills add first-fluke/oh-my-agent --skill oma-pdf --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 first-fluke/oh-my-agent, a repository with 1,204 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.