← Back to Skills Marketplace
MarkItDown Skill
by
karmanverma
· GitHub ↗
· v1.0.1
2030
Downloads
0
Stars
10
Active Installs
2
Versions
Install in OpenClaw
/install markitdown-skill
Description
OpenClaw agent skill for converting documents to Markdown. Documentation and utilities for Microsoft's MarkItDown library. Supports PDF, Word, PowerPoint, Excel, images (OCR), audio (transcription), HTML, YouTube.
Usage Guidance
This skill appears to do what it says: documentation + a small batch conversion helper that relies on the markitdown pip package. Before installing: 1) Verify you're installing the official 'markitdown' package on PyPI (typosquatting is a general pip risk). 2) Install in a Python virtual environment to avoid affecting system packages (python -m venv .venv; source .venv/bin/activate). 3) Only install the extras you need (avoid 'markitdown[all]' if you only need PDFs) to reduce dependency surface. 4) If you enable LLM features (--llm-model) or Azure DocInt, know that those will make network calls and require credentials (OPENAI API key, AZURE_DOCUMENT_INTELLIGENCE_KEY); provide those only to trusted code and review usage. 5) If you need higher assurance, inspect the upstream markitdown PyPI package and its GitHub repo to confirm maintainership and release history before installing.
Capability Analysis
Type: OpenClaw Skill
Name: markitdown-skill
Version: 1.0.1
The OpenClaw AgentSkills skill bundle 'markitdown-skill' is classified as benign. Its primary purpose is to convert various document types to Markdown using the legitimate 'markitdown' library. The `scripts/batch_convert.py` script and all documentation (SKILL.md, POST_INSTALL.md, USAGE-GUIDE.md, reference.md) consistently support this functionality, detailing file processing, optional integration with OpenAI or Azure Document Intelligence for enhanced features, and system dependencies like Tesseract OCR. There is no evidence of intentional harmful behavior such as data exfiltration, unauthorized command execution, persistence mechanisms, or malicious prompt injection attempts against the agent. All file and network access capabilities are directly aligned with the stated document conversion and processing goals.
Capability Assessment
Purpose & Capability
Name/description align with what is provided: documentation, examples, a small batch script, and a pip install spec for the markitdown CLI. The required binaries (python3, pip, markitdown) and the pip install of markitdown[all] are proportional to the stated purpose.
Instruction Scope
SKILL.md and the included docs stay on-topic (markitdown CLI/API usage). The batch script optionally imports the OpenAI client when an LLM model is requested and the docs reference using an Azure Document Intelligence endpoint (AZURE_DOCUMENT_INTELLIGENCE_KEY). Those LLM/DocInt integrations are optional, but they introduce network calls and use credentials that are not declared in requires.env — the script will attempt to create an OpenAI client if the --llm-model flag is used.
Install Mechanism
The install uses pip to install 'markitdown[all]' which is the expected distribution method. Pip installs execute package setup code and can pull many dependencies (the [all] extras), so installing in a virtualenv is recommended; no downloads from untrusted URLs or extract-from-arbitrary-URL patterns are present in the skill itself.
Credentials
The skill does not require any environment variables by default (none listed), which is fine. However, documentation references optional credentials (e.g., AZURE_DOCUMENT_INTELLIGENCE_KEY and implicit OpenAI credentials used by the openai client). These optional credentials are reasonable for the optional features, but they are not declared in requires.env — users should be aware enabling LLM or Azure features will use those secrets.
Persistence & Privilege
The skill does not request always:true, does not modify other skills or system-wide configs, and contains only a small helper script. It is user-invocable and may be invoked autonomously per platform defaults, which is expected.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install markitdown-skill - After installation, invoke the skill by name or use
/markitdown-skill - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
Fixed metadata: added requires.bins, clarified skill provides docs + batch script (converter is Microsoft's pip package)
v1.0.0
OpenClaw agent skill for converting documents to Markdown. Supports PDF, Word, Excel, images, audio, YouTube.
Metadata
Frequently Asked Questions
What is MarkItDown Skill?
OpenClaw agent skill for converting documents to Markdown. Documentation and utilities for Microsoft's MarkItDown library. Supports PDF, Word, PowerPoint, Excel, images (OCR), audio (transcription), HTML, YouTube. It is an AI Agent Skill for Claude Code / OpenClaw, with 2030 downloads so far.
How do I install MarkItDown Skill?
Run "/install markitdown-skill" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is MarkItDown Skill free?
Yes, MarkItDown Skill is completely free (open-source). You can download, install and use it at no cost.
Which platforms does MarkItDown Skill support?
MarkItDown Skill is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created MarkItDown Skill?
It is built and maintained by karmanverma (@karmanverma); the current version is v1.0.1.
More Skills