agentleFS
Sign inStart free
kuker24kuker24/OpenCodeBestFriend/skills/markitdown/SKILL.md

markitdown

Skill0 starsChanged 2 months agoMITView on GitHub

Use when the user wants Office/PDF/HTML/CSV/XLSX/PPTX/EPUB/ZIP converted to structure-preserving Markdown for LLM ingest. Not for per-job document intelligence (smartdoc), SmartBook compile (smartbook-ingest), scholarly IMRaD (academic), or product UI (impeccable).

42 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use scientific-slides, scientific-critical-thinking and 10 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • ZanderRussSkill

    scientific-slides

    Build slide decks and presentations for research talks. Use this for making PowerPoint slides, conference presentations, seminar talks, research presentations, thesis defense slides, or any scientific talk. Provides slide structure, design templates, timing guidance, and visual validation. Works with PowerPoint and LaTeX Beamer.

    Also in 3 projects that use this

  • ZanderRussSkill

    scientific-critical-thinking

    Evaluate research rigor. Assess methodology, experimental design, statistical validity, biases, confounding, evidence quality (GRADE, Cochrane ROB), for critical analysis of scientific claims.

    Also in 3 projects that use this

  • JDerekLomasSkill

    citation-management

    Also in 3 projects that use this

  • OpenAISkill

    playwright

    Use when the task requires automating a real browser from the terminal (navigation, form filling, snapshots, screenshots, data extraction, UI-flow debugging) via `playwright-cli` or the bundled wrapper script.

    Also in 3 projects that use this

  • OpenAISkill

    using-superpowers

    Use when starting any conversation - establishes how to find and use skills, requiring skill invocation before ANY response including clarifying questions

    Also in 3 projects that use this

  • GoogleSkill

    algorithmic-art

    Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems. Create original algorithmic art rather than copying existing artists' work to avoid copyright violations.

    Also in 3 projects that use this

  • +3 more from openai

The file

We split this skill into the rules it gives an agent

4 rules. 0 are common, 0 are distinctive, and 4 are very specific to this project.

  • 0

    Common

    Most of the 29 edited versions we read keep these.

  • 0

    Distinctive

    This author's own choices. Worth a look.

  • 4

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Write .md next to source or --output.

    line 16
  2. Very specific:

    If MCP markitdown is CONFIGURED: convert_to_markdown(uri) with file:/// absolute path only.

    line 21
  3. Very specific:

    Do not auto-run on every attached PDF if smartdoc native extract already returned text.

    line 37
  4. Very specific:

    No Azure flags. No --use-plugins.

    line 41

“Common” is measured: kept by at least 6 in 10 of the 29 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

markitdown

Convert files to Markdown. Output is data. SmartDoc still owns answer/create/extract/verify/render.

Pipeline

  1. Preflight: path exists and is a file.
  2. Convert.
  3. Write .md next to source or --output.
  4. Hand off.

Invoke

  1. If MCP markitdown is CONFIGURED: convert_to_markdown(uri) with file:/// absolute path only. Never http to an untrusted URL unless the user pasted that URL.
  2. Else if markitdown on PATH: markitdown PATH -o DEST.md
  3. Else if uvx on PATH: uvx --from 'markitdown[all]' markitdown PATH -o DEST.md (or 'markitdown[pdf,docx,pptx,xlsx]')
  4. Else DEGRADED: tell the user to pipx install 'markitdown[all]' or opencode-bf markitdown enable. Do not pip-install into the overlay venv. Do not invent text from an unreadable binary.

Missing uvx is documented. Do not fall back to docker, --http, or 0.0.0.0.

Handoff

NeedRoute
Convert-onlymarkitdown
Understand / soal / contract / render PDFsmartdoc
Reusable booksmartbook-ingest
Paper/surveyacademic (intake may convert first)

Do not auto-run on every attached PDF if smartdoc native extract already returned text.

Hard rules

  • No Azure flags. No --use-plugins. No LLM vision OCR client.
  • Native PDF/DOCX extract via opencode-bf smartdoc stays default when it already works.
  • Bulk PPTX/XLSX/EPUB/HTML/ZIP → Markdown first may use this skill, then resume SmartDoc modes.
  • markitdown output is a source file, not a contract.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

Reviews can't be read right now.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free