Convert binary documents (PDF, DOCX, XLSX, PPTX, HTML, EPUB, images) to clean LLM-friendly Markdown using Microsoft's markitdown Python tool.
$ npx skills add Team-Commonly/commonly --skill markdown-converter -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install Team-Commonly/commonly markdown-converter --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/Team-Commonly/commonly.git skills-src && mkdir -p .claude/skills && cp -r skills-src/backend/commonly-bundled-skills/markdown-converter .claude/skills/markdown-converter && 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 "markdown-converter" agent skill from https://github.com/Team-Commonly/commonly/tree/main/backend/commonly-bundled-skills/markdown-converter into .claude/skills/markdown-converter/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "markdown-converter", 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/Team-Commonly/commonly/tree/main/backend/commonly-bundled-skills/markdown-converterType 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 Team-Commonly/commonly --skill markdown-converter -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install Team-Commonly/commonly markdown-converter --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Team-Commonly/commonly.git skills-src && mkdir -p .agents/skills && cp -r skills-src/backend/commonly-bundled-skills/markdown-converter .agents/skills/markdown-converter && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "markdown-converter" agent skill from https://github.com/Team-Commonly/commonly/tree/main/backend/commonly-bundled-skills/markdown-converter into .agents/skills/markdown-converter/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "markdown-converter", 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 Team-Commonly/commonly --skill markdown-converter -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install Team-Commonly/commonly markdown-converter --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Team-Commonly/commonly.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/backend/commonly-bundled-skills/markdown-converter .cursor/skills/markdown-converter && 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 "markdown-converter" agent skill from https://github.com/Team-Commonly/commonly/tree/main/backend/commonly-bundled-skills/markdown-converter into .cursor/skills/markdown-converter/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "markdown-converter", 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/Team-Commonly/commonly.git --path backend/commonly-bundled-skills/markdown-converter--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 Team-Commonly/commonly --skill markdown-converter -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install Team-Commonly/commonly markdown-converter --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Team-Commonly/commonly.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/backend/commonly-bundled-skills/markdown-converter .gemini/skills/markdown-converter && 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 "markdown-converter" agent skill from https://github.com/Team-Commonly/commonly/tree/main/backend/commonly-bundled-skills/markdown-converter into .gemini/skills/markdown-converter/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "markdown-converter", 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 Team-Commonly/commonly markdown-converterInstalls 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 Team-Commonly/commonly --skill markdown-converter -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/Team-Commonly/commonly.git skills-src && mkdir -p .github/skills && cp -r skills-src/backend/commonly-bundled-skills/markdown-converter .github/skills/markdown-converter && 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 "markdown-converter" agent skill from https://github.com/Team-Commonly/commonly/tree/main/backend/commonly-bundled-skills/markdown-converter into .github/skills/markdown-converter/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "markdown-converter", 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 Team-Commonly/commonly --skill markdown-converter -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install Team-Commonly/commonly markdown-converter --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Team-Commonly/commonly.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/backend/commonly-bundled-skills/markdown-converter .opencode/skills/markdown-converter && 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 "markdown-converter" agent skill from https://github.com/Team-Commonly/commonly/tree/main/backend/commonly-bundled-skills/markdown-converter into .opencode/skills/markdown-converter/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "markdown-converter", 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.
markdown-converterConvert binary documents (PDF, DOCX, XLSX, PPTX, HTML, EPUB, images) to clean LLM-friendly Markdown using Microsoft's markitdown Python tool.
Markdown Converter is an agent skill from Team-Commonly/commonly. Convert binary documents (PDF, DOCX, XLSX, PPTX, HTML, EPUB, images) to clean LLM-friendly Markdown using Microsoft's markitdown Python tool. Use when a user attaches a binary file and you need to read its contents.
Its SKILL.md is about 560 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Documents & Office, covering Markdown, Document parsing and Excel spreadsheets. It works with MarkItDown, Microsoft Excel, Microsoft Word and Microsoft PowerPoint. The repository describes itself as: Open-source room for humans + cross-vendor AI agents. Every agent gets its own name, memory, skills, and workstation. Any runtime, your infra — no per-agent fees. The licence is Apache-2.0.
Read from SKILL.md and the folder at commit e597fb4. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Shell commands in SKILL.md call:
markitdownpip3From the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md. Its commands use pip3, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Markdown Converter loads about 557 tokens when it runs. Until then it costs about 59 tokens; SKILL.md has 199 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.
The automated check found no risky patterns in SKILL.md.
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); files beside SKILL.md are not scanned.
The full file from Team-Commonly/commonly at commit e597fb4, republished under its Apache-2.0 licence (© Team-Commonly). 199 words, ~557 tokens.
.claude/skills/markdown-converter/SKILL.md (or your agent's skills folder).markitdown is installed via pip3 install markitdown and is on PATH. It
extracts text content from a wide range of binary formats and emits clean
markdown that's efficient for LLM context.
PDF, DOCX, XLSX, PPTX, HTML, EPUB, images (with OCR), CSV, JSON, audio transcripts, ZIP archives.
# Convert a single file to markdown on stdout
markitdown /workspace/$(basename "$PWD")/input.pdf
# Save to a markdown file
markitdown /workspace/$(basename "$PWD")/input.docx > /workspace/$(basename "$PWD")/input.md
# Convert and pipe directly into another tool
markitdown /workspace/$(basename "$PWD")/spec.xlsx | head -200Files attached by users are downloaded to the agent workspace by the gateway. Once you have a workspace path:
# 1. Convert the binary to markdown
markitdown /workspace/$(basename "$PWD")/uploads/report.pdf > /tmp/report.md
# 2. Read the markdown into your context
cat /tmp/report.mdThen summarize, answer questions about it, or feed sections back to the user.
| Flag | Effect |
|---|---|
--use-docintel <ENDPOINT> | Use Azure Doc Intelligence (requires API key) for OCR-heavy PDFs |
-o <file> | Write to file instead of stdout |
officecli or
pandic-office instead.pdf
skill.officecli view <file> html.© Team-Commonly, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Just SKILL.md in backend/commonly-bundled-skills/markdown-converter of Team-Commonly/commonly.
Open the folder on GitHubat commit e597fb4
Markdown Converter 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 |
|---|---|---|---|---|---|---|
| Markdown Converter this skillTeam-Commonly/commonly | 1.4k | — | ~557 | Automated safety check: Pass | Apache-2.0 | |
| Document ConverterBlackBeltTechnology/pi-agent-dashboard | 316 | — | ~999 | Automated safety check: Pass | MIT | |
| MarkitdownImCa0/just-laws | 781 | 14 repos | ~3.2k | Automated safety check: Notes | MIT | |
| Markdown Exporterbowenliang123/markdown-exporter | 271 | 1 repos | ~5.3k | Automated safety check: Pass | Apache-2.0 | |
| 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 |
BlackBeltTechnology/pi-agent-dashboard
Convert documents bidirectionally via the pi-doc-engine facade: ingest PDF/DOCX/PPTX/XLSX to provenance-stamped Markdown (with OCR), and produce templated DOCX/PDF from Markdown with diagrams, TOC…
ImCa0/just-laws
Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.
bowenliang123/markdown-exporter
Convert Markdown text to DOCX, PPTX, XLSX, PDF, PNG, SVG, HTML, IPYNB, MD, CSV, JSON, JSONL, XML files, and extract code blocks in Markdown to Python, Bash,JS and etc files.
jimmc414/Kosmos
Convert various file formats (PDF, Office documents, images, audio, web content, structured data) to Markdown optimized for LLM processing.
intellectronica/agent-skills
Convert documents and files to Markdown using markitdown. An agent skill from intellectronica/agent-skills.
wentorai/Research-Claw
Convert Office documents (PPTX, DOCX, XLSX, PDF, HTML, CSV, JSON, XML, images) to Markdown using Microsoft MarkItDown.
Team-Commonly/commonly
You are a member of a Commonly workspace — a shared space where humans and AI agents from any origin collaborate in pods (chat rooms with memory).
Team-Commonly/commonly
Interact with GitHub (issues, PRs, repos, releases) using the gh CLI.
Team-Commonly/commonly
A skill your agent uses when producing a polished, Commonly-branded deliverable (.docx brief / memo, .xlsx data matrix, .pptx deck) and you do not have specific brand guidance from the user.
Team-Commonly/commonly
Convert Markdown to PDF (or DOCX/EPUB/HTML) using the pandoc CLI.
Team-Commonly/commonly
Manipulate PDF files — extract text, count pages, render thumbnails, merge or split documents.
Team-Commonly/commonly
Manage long-running shell sessions with tmux — start a detached session, run a long task, reattach later, capture output.
Categories
Convert binary documents (PDF, DOCX, XLSX, PPTX, HTML, EPUB, images) to clean LLM-friendly Markdown using Microsoft's markitdown Python tool. Markdown Converter is an agent skill from Team-Commonly/commonly. Convert binary documents (PDF, DOCX, XLSX, PPTX, HTML, EPUB, images) to clean LLM-friendly Markdown using Microsoft's markitdown Python tool.
Markdown Converter fits situations like: A user attaches a binary file and you need to read its contents; tasks that involve Markdown; tasks that involve Document parsing.
Run `npx skills add Team-Commonly/commonly --skill markdown-converter -a claude-code`. Or copy the skill folder (backend/commonly-bundled-skills/markdown-converter in Team-Commonly/commonly) into .claude/skills/markdown-converter in your project. Claude Code loads it when a task matches its description.
Run `npx skills add Team-Commonly/commonly --skill markdown-converter -a codex`. Or copy the skill folder (backend/commonly-bundled-skills/markdown-converter in Team-Commonly/commonly) into .agents/skills/markdown-converter in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Team-Commonly/commonly --skill markdown-converter -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/markdown-converter, .gemini/skills/markdown-converter, .github/skills/markdown-converter and .opencode/skills/markdown-converter in your project.
Going by SKILL.md and its folder, Markdown Converter needs the command-line tools its instructions call (markitdown and pip3). Our summary lists: Python 3.
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
Markdown Converter is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 557 tokens (SKILL.md is roughly 2.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with Markdown Converter: Document Converter (BlackBeltTechnology/pi-agent-dashboard, 316 stars), Markitdown (ImCa0/just-laws, 781 stars), Markdown Exporter (bowenliang123/markdown-exporter, 271 stars) and Markitdown (jimmc414/Kosmos, 594 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Team-Commonly (a GitHub organization) maintains it in Team-Commonly/commonly, which has 1,359 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 7, 2026.
Source: Team-Commonly/commonly on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.
