- name
SKILL.md
The skill file stays in the publisher's repository.
Paste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add omagents/omagents --skill markitdown-converter -a cursor -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add omagents/omagents --skill markitdown-converter -a claude-code -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add omagents/omagents --skill markitdown-converter -a codex -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add omagents/omagents --skill markitdown-converter -a grok -ySend the copied message in a Grok Bot chat. The Bot fetches this SKILL.md from GitHub and adds it to the skills all your Bots share.
Install this skill: https://github.com/omagents/omagents/tree/HEAD/packages/core/skills/markitdown-converterFrom the publisher
Use MarkItDown to convert documents to Markdown for reading and text extraction.
The simplest way: run markitdown directly on a file.
markitdown input.pdf
markitdown input.docx -o output.md
Stdin is also supported: cat input.xlsx | markitdown -x .xlsx
For programmatic use or when processing multiple files:
from markitdown import MarkItDown
md = MarkItDown()
result = md.convert("document.pdf")
print(result.text_content)
Convert from URL:
result = md.convert("https://example.com/report.pdf")
print(result.text_content)
MarkItDown runs in the omagents Python venv (see agents-python-tools skill for setup and cross-platform paths):
# Check installation through the base interpreter
~/.venvs/omagents/bin/python -c "from markitdown import MarkItDown; print('OK')"
# Install only if the import check fails
~/.venvs/omagents/bin/python -m pip install markitdown
>
---name: markitdown-converterdescription: >---# packages/core/skills/markitdown-converter/SKILL.mdFAQ
Download packages/core/skills/markitdown-converter/SKILL.md from the publisher, or copy the path and open the repository. PlugMCP lists the skill and does not host the file.
The publisher keeps it at https://github.com/omagents/omagents.
Claude, Cursor, Codex, and Grok Build can read a SKILL.md you add from the publisher's repository. Grok Bot installs it when you send the skill's GitHub folder link in a chat.