Markitdown
ImCa0/just-laws
Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.
Convert documents to Markdown using Microsoft's MarkItDown CLI (markitdown).
Install Markitdown Skill
$ npx skills add infometa/workbuddyskills --skill markitdown-skill -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install infometa/workbuddyskills markitdown-skill --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/infometa/workbuddyskills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/markitdown-skill .claude/skills/markitdown-skill && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "markitdown-skill" agent skill from https://github.com/infometa/workbuddyskills/tree/main/skills/markitdown-skill into .claude/skills/markitdown-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "markitdown-skill", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/infometa/workbuddyskills/tree/main/skills/markitdown-skillType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add infometa/workbuddyskills --skill markitdown-skill -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install infometa/workbuddyskills markitdown-skill --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/infometa/workbuddyskills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/markitdown-skill .agents/skills/markitdown-skill && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "markitdown-skill" agent skill from https://github.com/infometa/workbuddyskills/tree/main/skills/markitdown-skill into .agents/skills/markitdown-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "markitdown-skill", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add infometa/workbuddyskills --skill markitdown-skill -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install infometa/workbuddyskills markitdown-skill --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/infometa/workbuddyskills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/markitdown-skill .cursor/skills/markitdown-skill && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "markitdown-skill" agent skill from https://github.com/infometa/workbuddyskills/tree/main/skills/markitdown-skill into .cursor/skills/markitdown-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "markitdown-skill", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/infometa/workbuddyskills.git --path skills/markitdown-skill--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add infometa/workbuddyskills --skill markitdown-skill -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install infometa/workbuddyskills markitdown-skill --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/infometa/workbuddyskills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/markitdown-skill .gemini/skills/markitdown-skill && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "markitdown-skill" agent skill from https://github.com/infometa/workbuddyskills/tree/main/skills/markitdown-skill into .gemini/skills/markitdown-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "markitdown-skill", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install infometa/workbuddyskills markitdown-skillInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add infometa/workbuddyskills --skill markitdown-skill -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/infometa/workbuddyskills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/markitdown-skill .github/skills/markitdown-skill && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "markitdown-skill" agent skill from https://github.com/infometa/workbuddyskills/tree/main/skills/markitdown-skill into .github/skills/markitdown-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "markitdown-skill", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add infometa/workbuddyskills --skill markitdown-skill -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install infometa/workbuddyskills markitdown-skill --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/infometa/workbuddyskills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/markitdown-skill .opencode/skills/markitdown-skill && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "markitdown-skill" agent skill from https://github.com/infometa/workbuddyskills/tree/main/skills/markitdown-skill into .opencode/skills/markitdown-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "markitdown-skill", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
markitdown-skill- GitHub stars
- 342
- Token cost
- ~841 tokens
- SKILL.md length
- 164 words
- Files
- 4 (incl. scripts, references)
- Skills in repo
- 235
- Repo updated
- First seen
- Licence
- None found
At a glance
Convert documents to Markdown using Microsoft's MarkItDown CLI (markitdown).
- A user wants to convert a file
- SKILL.md covers When to Use, Quick Start, Supported Formats and Installation, plus 5 more sections
- Runs Python scripts from its folder; calls markitdown, pip and python; reaches github.com
- URL to Markdown
What it does
Markitdown Skill is an agent skill from infometa/workbuddyskills. Convert documents to Markdown using Microsoft's MarkItDown CLI (markitdown). Supports PDF, Word, PowerPoint, Excel, images (OCR), audio (transcription), HTML, YouTube, and URLs. Use when a user wants to convert a file or URL to Markdown, extract text from PDFs/images, transcribe audio/video, or batch-convert documents.
Its SKILL.md is about 840 tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including scripts and reference files (for example `references/USAGE-GUIDE.md`, `references/reference.md` and `scripts/batch_convert.py`).
It sits in Documents & Office, covering Document parsing and Transcription. It works with MarkItDown, Microsoft PowerPoint, Microsoft Excel and YouTube. The repository describes itself as: WorkBuddy skills / connectors / experts archive for offline study.
When your agent uses it
- A user wants to convert a file
- URL to Markdown
- Extract text from PDFs/images
- Transcribe audio/video
Example prompts
- “/markitdown-skill”
Requirements
- Python 3
- Pre-approved tools (allowed-tools): Read, Write, Bash, Glob
What it can do on your machine
Read from SKILL.md and the folder at commit 9830caf. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves these tools, so the agent can use them without asking each time:
ReadWriteBashGlob
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 1 file in scripts/ (Python), which the agent can run.
Shell commands in SKILL.md call:
markitdownpippythonapt-getbrew
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
github.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Markitdown Skill loads about 841 tokens when it runs, and up to ~4.3k if it reads all its reference files. Until then it costs about 85 tokens; SKILL.md has 164 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check: notes
The automated check noted patterns worth knowing about, such as sudo or a known installer.
- NoteRuns commands with sudoSKILL.md:117
sudo apt-get install tesseract-ocr - NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
allowed-tools: Read, Write, Bash, Glob
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.
SKILL.md
Without a licence we can't republish the file, so here is its outline and opening line. It has 164 words (~841 tokens).
“Documentation and utilities for converting documents to Markdown using Microsoft's MarkItDown library.”
- name
- markitdown-skill
- allowed-tools
- Read, Write, Bash, Glob
- description_zh
- 文档转 Markdown(PDF/Word/PPT/图片OCR/音频转写/网页)
- description_en
- Convert documents to Markdown (PDF, Word, PPT, images, audio, URLs)
- version
- 1.0.1
- homepage
- https://github.com/microsoft/markitdown
Files
SKILL.md and 3 other files (scripts, references) in skills/markitdown-skill of infometa/workbuddyskills.
- SKILL.md
- references/USAGE-GUIDE.md
- references/reference.md
- scripts/batch_convert.py
Open the folder on GitHubat commit 9830caf
Compare with similar skills
Markitdown Skill next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Markitdown Skill this skillinfometa/workbuddyskills | 342 | — | ~841 | Automated safety check: Notes | None | |
| MarkitdownImCa0/just-laws | 781 | 14 repos | ~3.2k | Automated safety check: Notes | MIT | |
| Markitdownjimmc414/Kosmos | 594 | 2 repos | ~1.7k | Automated safety check: Pass | None | |
| Markdown Converterintellectronica/agent-skills | 295 | 4 repos | ~492 | Automated safety check: Pass | CC0-1.0 | |
| Document Converterwentorai/Research-Claw | 858 | — | ~1.3k | Automated safety check: Pass | Custom licence | |
| PDF To Markdownpamelafox/presentation-skills | 125 | — | ~372 | Automated safety check: Pass | MIT |
Similar skills
Markitdown
jimmc414/Kosmos
Convert various file formats (PDF, Office documents, images, audio, web content, structured data) to Markdown optimized for LLM processing.
Markdown Converter
intellectronica/agent-skills
Convert documents and files to Markdown using markitdown. An agent skill from intellectronica/agent-skills.
Document Converter
wentorai/Research-Claw
Convert Office documents (PPTX, DOCX, XLSX, PDF, HTML, CSV, JSON, XML, images) to Markdown using Microsoft MarkItDown.
PDF To Markdown
pamelafox/presentation-skills
Converts PDF files to Markdown using Microsoft's markitdown package.
To Markdown
Mathews-Tom/armory
Convert any file or URL to clean Markdown: PDF, DOCX, XLSX, PPTX, HTML, images (OCR), audio, CSV, YouTube.
More from infometa/workbuddyskills
All 235 skills in this repoCampus Event Playbook
infometa/workbuddyskills
This skill should be used when planning, coordinating, running, or reviewing student-led campus events, including club recruitment, freshman mixers, welcome activities, small talks, competitions…
Teachany
infometa/workbuddyskills
K-12 interactive courseware creation. An agent skill from infometa/workbuddyskills.
Weight Management HTML
infometa/workbuddyskills
A skill your agent uses when the adult weight-management MCP needs to be installed/set up in WorkBuddy (connector) or its result must be rendered as a standalone Chinese HTML plan.
Agent Browser
infometa/workbuddyskills
A skill your agent uses when the user needs browser automation, including opening web pages, taking screenshots, extracting page content, clicking elements, filling forms, or testing web flows.
AI Research Radar
infometa/workbuddyskills
定时任务：每日研究简报。漏掉重要论文和行业报告？每天帮你盯着，关键信息一条不漏 This skill should be used when the user asks about 定时任务：每日研究简报.
Check Deck
infometa/workbuddyskills
Investment banking presentation quality checker. An agent skill from infometa/workbuddyskills.
Related
Categories
Questions about Markitdown Skill
What does Markitdown Skill do?
Convert documents to Markdown using Microsoft's MarkItDown CLI (markitdown). Markitdown Skill is an agent skill from infometa/workbuddyskills. Convert documents to Markdown using Microsoft's MarkItDown CLI (markitdown).
When should I use Markitdown Skill?
Markitdown Skill fits situations like: A user wants to convert a file; URL to Markdown; extract text from PDFs/images; transcribe audio/video.
How do I install Markitdown Skill in Claude Code?
Run `npx skills add infometa/workbuddyskills --skill markitdown-skill -a claude-code`. Or copy the skill folder (skills/markitdown-skill in infometa/workbuddyskills) into .claude/skills/markitdown-skill in your project. Claude Code loads it when a task matches its description.
How do I install Markitdown Skill in Codex?
Run `npx skills add infometa/workbuddyskills --skill markitdown-skill -a codex`. Or copy the skill folder (skills/markitdown-skill in infometa/workbuddyskills) into .agents/skills/markitdown-skill in your project. Codex loads it when a task matches its description.
Can I use Markitdown Skill in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add infometa/workbuddyskills --skill markitdown-skill -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/markitdown-skill, .gemini/skills/markitdown-skill, .github/skills/markitdown-skill and .opencode/skills/markitdown-skill in your project.
What does Markitdown Skill need to run?
Going by SKILL.md and its folder, Markitdown Skill needs Python for the scripts in its folder and the command-line tools its instructions call (markitdown, pip, python, apt-get and brew). Our summary lists: Python 3. Its frontmatter pre-approves these tools: Read, Write, Bash, Glob.
Does Markitdown Skill access the network?
SKILL.md names 1 domain. In commands or code: github.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.
Is Markitdown Skill safe to install?
Our automated static check of SKILL.md found notes only (runs commands with sudo; pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
What licence does Markitdown Skill use?
No licence was found for Markitdown Skill or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.
How many tokens does Markitdown Skill use?
About 841 tokens (SKILL.md is roughly 3.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.5k tokens, read only when the agent opens those files.
What are the alternatives to Markitdown Skill?
Skills that share tags, products or a category with Markitdown Skill: Markitdown (ImCa0/just-laws, 781 stars), Markitdown (jimmc414/Kosmos, 594 stars), Markdown Converter (intellectronica/agent-skills, 295 stars) and Document Converter (wentorai/Research-Claw, 858 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Markitdown Skill?
infometa (a GitHub user) maintains it in infometa/workbuddyskills, which has 342 GitHub stars. The repository holds 235 skills in this directory. The repository was last updated on October 6, 2026.
Source: infometa/workbuddyskills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.