raccioly

Markitdown Skill — Documentation skill for Claude Code

Documentation community

Claude Code Agent Skill: read Office docs (docx/pptx/xlsx/.

How to install Markitdown Skill

This entry records only its repository, not the path inside it, so there is no exact command to give. Open raccioly/markitdown-skill and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Markitdown Skill does

Claude Code Agent Skill: read Office docs (docx/pptx/xlsx/...) as Markdown via Microsoft MarkItDown — local, token-lean

Alternatives in Documentation

Pptx — Create, edit, and analyze PowerPoint presentations with layouts and templates 94.1k ★
OpenAI Docs — Provide authoritative guidance from OpenAI developer documentation 14.6k ★
Translate Doc Zh — Translate English documentation to Chinese 5.7k ★

README

markitdown-skill

A [Claude Code](https://claude.com/claude-code) **Agent Skill** that teaches the agent to read Office and structured documents (`.docx`, `.pptx`, `.xlsx`, `.csv`, `.html`, `.epub`, `.msg`, `.zip`, URLs…) by converting them to clean Markdown with [Microsoft MarkItDown](https://github.com/microsoft/markitdown) — one deterministic CLI command instead of ad-hoc extraction scripts.

**Why:** Markdown output is token-lean and keeps structure (headings, tables, slides), so the agent reads documents faster, cheaper, and more reliably. Everything runs **locally** — the conversion itself never calls an LLM API.

What's in the box

markitdown/
└── SKILL.md    ← the skill (works with Claude Code and any agent supporting Agent Skills)

Install (2 steps, ~2 minutes)

1. Install the MarkItDown CLI (one of these)

pipx install "markitdown[all]"     # recommended: isolated global install
# or
uv tool install "markitdown[all]"  # if you use uv

No pipx? `brew install pipx && pipx ensurepath` (macOS) or `pip install --user pipx`.

**Zero-install alternative:** if you have [uv](https://docs.astral.sh/uv/), the skill automatically falls back to `uvx "markitdown[all]"` — nothing to install at all.

Verify: `markitdown --version`

2. Install the skill

**Globally (all your projects):**

git clone https://github.com/raccioly/markitdown-skill.git
cp -r markitdown-skill/markitdown ~/.claude/skills/

**Or per-project (shared with your team via the repo):**

cp -r markitdown-skill/markitdown /.claude/skills/

**Or on claude.ai / Claude Desktop / Cowork (no terminal needed):**

Download markitdown-skill.zip from the latest release
In Claude: Settings → Capabilities → Skills → Upload skill and pick the zip
Done — in Cowork the skill installs the MarkItDown CLI inside the session sandbox automatically (`pip install "markitdo