markitdown

markitdown is a skill for Claude Code, Codex from seed-forge/harness-ai-kit. It costs 73 tokens per session (643 once invoked), scanned A, original, Apache-2.0.

A local document-conversion guide built around MarkItDown, a tool that turns files such as DOCX, PDF, PPTX, XLSX, images, HTML, and CSV into Markdown text.

In plain words
What is it for?
Use it to convert documents in batches, create Markdown copies for analysis, check the conversion output, and prepare files for an Obsidian project.
Why use it?
It provides a verified way to convert source files into text that people and language models can inspect, while reducing problems with missing commands or unstable dependencies.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/seed-forge/harness-ai-kit/markitdown
Any agent
npx skills add seed-forge/harness-ai-kit --skill markitdown
Clone the repo
git clone --depth 1 https://github.com/seed-forge/harness-ai-kit

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for markitdown

README.md
[![agentmods](https://agentmods.dev/badge/skills/seed-forge/harness-ai-kit/markitdown.svg)](https://agentmods.dev/skills/seed-forge/harness-ai-kit/markitdown)
Your own site
<a href="https://agentmods.dev/skills/seed-forge/harness-ai-kit/markitdown"><img src="https://agentmods.dev/badge/skills/seed-forge/harness-ai-kit/markitdown.svg" alt="Measured on agentmods" height="20"></a>
Per session 73 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 643 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00073 $0.00643
Opus 5 $0.00036 $0.00321
Sonnet 5 $0.00015 $0.00129
Haiku 4.5 $0.00007 $0.00064

Measured 5d ago against content hash e3cfecb3bbcb, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

markitdown scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/markitdown/SKILL.md · 77 lines

What it actually says

MarkItDown

这是当前项目的本地化 markitdown 技能入口。

它基于上游全局 Skill,但这里补上了本环境下已经验证过的稳定用法,避免每次重复处理安装和命令路径问题。

Use This Skill For

  • docxpdfpptxxlsx 转成 markdown
  • 批量把资料转换成更适合 LLM 处理的文本格式
  • 在 Obsidian 项目里落地文档转写结果

Environment Notes

  • 当前环境已验证 python -m markitdown 可用
  • 建议优先调用本地包装命令:
    • .\.agents\tools\markitdown.cmd
  • 如果直接输入 markitdown 失败,通常是因为 Python 的 Scripts 目录不在 PATH

Stable Invocation

.\.agents\tools\markitdown.cmd input.docx -o output.md

或:

python -m markitdown input.docx -o output.md

Verified Dependency Strategy

本环境里不建议直接依赖:

pip install "markitdown[all]"

因为实测可能把主包错误回退到旧版本。

更稳的方式是:

python -m pip install --upgrade markitdown==0.1.5
python -m pip install azure-ai-documentintelligence azure-identity openpyxl pandas pydub python-pptx speechrecognition youtube-transcript-api openai pathvalidate puremagic mammoth olefile xlrd pdfminer-six pdfplumber

Workflow

  1. 确认源文件存在,并避免覆盖现有 .md
  2. 优先输出到新文件名,例如 *.markitdown.md
  3. 转换后抽查文件头部,确认不是空文件
  4. 如需给 Obsidian 使用,再做一轮 markdown 清洗

推荐输出格式

执行完毕后按以下结构输出:

状态:✅ 成功 / ⚠️ 部分成功 / ❌ 失败

<输入→输出文件/格式/路径> <值/状态> 说明

下一步:<可执行动作>

Practical Notes

  • DOCX 已在当前环境验证通过
  • PDF、PPTX、XLSX、音频、YouTube 转写依赖已补齐
  • Azure Document Intelligence 和 OpenAI 增强能力仍需各自凭证
Files

What ships with it

3 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 5d ago First seen · 77 lines · 73 tokens per session scan A e3cfecb3bbcb

Subscribe to this mod's changes

markitdown is a skill published in the GitHub repository seed-forge/harness-ai-kit (21 stars, last pushed 4d ago), licensed Apache-2.0. It adds 73 tokens to every session and 643 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

liteparse

Parse documents into LLM-ready content entirely on the local machine — PDF / DOCX / XLSX / PPTX / images → Markdown, structured JSON (with bounding boxes), or page screenshots, via the lit CLI. No cloud, no LLM, works offline. Use whenever the user attaches or points to a document that must be read before reasoning…

Prismer-AI/PrismerCloud · 90 tokens

office-artifacts

Generate real DOCX, PPTX, XLSX, PDF, CSV files using python-docx / python-pptx / openpyxl / reportlab by writing them into the dispatch artifacts dir, then explicitly deliver each one with cloud deliver . Use whenever the user asks for documents, slides, spreadsheets, reports, or PDFs.

Prismer-AI/PrismerCloud · 75 tokens

historical-data-manager

Extract, clean, and organize legacy construction data from archives. Migrate historical project data, cost records, and schedules into modern formats.

datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction · 32 tokens

pdf-report-generator

Automatically generate PDF reports from construction data. Create formatted project reports with charts and tables.

datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction · 21 tokens

cwicr-report-generator

Generate professional cost estimation reports from CWICR calculations. HTML, PDF, Excel outputs with charts and breakdowns.

datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction · 29 tokens

google-apps-script

Build Google Apps Script automation for Sheets and Workspace. Custom menus, triggers (onEdit / time-driven / form submit), dialogs, sidebars, email batches, PDF export, external API. Use whenever the user wants to automate a Google Sheet, build a Sheets menu / sidebar / dialog, hit a Sheets row from email or a…

jezweb/claude-skills · 89 tokens