← Back to Skills Marketplace
markdown-converter
by
ModestyRichards
· GitHub ↗
· v1.0.2
· MIT-0
146
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install modesty-markdown-converter
Description
Convert documents and files to Markdown using markitdown. Use when converting PDF, Word (.docx), PowerPoint (.pptx), Excel (.xlsx, .xls), HTML, CSV, JSON, XM...
Usage Guidance
This skill appears to do document→Markdown conversion but has unclear requirements and will send data to api.skillboss.co if you provide SKILLBOSS_API_KEY. Before installing: (1) confirm whether 'uvx' (markitdown) is available in your environment or get explicit install instructions; (2) verify the skill registry metadata is updated to declare SKILLBOSS_API_KEY as a required env var if remote processing is needed; (3) only supply SKILLBOSS_API_KEY if you trust skillboss.co and are comfortable that documents (or their URLs) may be transmitted to that service; (4) ask the publisher for a homepage/source repo and a clear privacy statement about what is sent to SkillBoss; and (5) test with non-sensitive documents first.
Capability Analysis
Type: OpenClaw Skill
Name: modesty-markdown-converter
Version: 1.0.2
The skill provides a legitimate interface for converting various file formats to Markdown using the Microsoft 'markitdown' utility via 'uvx'. It includes an optional integration with the SkillBoss API (api.skillboss.co) for enhanced document processing, which requires a user-provided API key. The code and instructions in SKILL.md and README.md are transparent, align with the stated purpose, and do not exhibit signs of malicious intent, unauthorized data exfiltration, or prompt injection attacks.
Capability Tags
Capability Assessment
Purpose & Capability
SKILL.md describes a markdown conversion tool that can optionally call SkillBoss API Hub. That purpose is plausible, but the registry metadata claims no required env vars or binaries while the SKILL.md explicitly declares and uses SKILLBOSS_API_KEY and assumes the 'uvx' CLI ('uvx markitdown'). The mismatch between claimed requirements and actual instructions is incoherent and makes it unclear what the skill truly needs to function.
Instruction Scope
Runtime instructions tell the agent to run 'uvx markitdown' on local files/STDIN and also include a Python example that will POST documents/URLs to https://api.skillboss.co using SKILLBOSS_API_KEY. This means document contents or URLs can be transmitted to a third-party service. The SKILL.md also claims 'no installation required' while referring to caching dependencies and a CLI binary, creating ambiguity about what the agent will do at runtime.
Install Mechanism
There is no install spec (instruction-only), which is low-risk. However, the instructions depend on the external 'uvx' binary without declaring it as required or providing an install path. That mismatch may lead to the agent attempting to fetch or run unknown binaries outside the declared manifest.
Credentials
The SKILL.md requires SKILLBOSS_API_KEY (used to call api.skillboss.co), which is proportionate to the optional remote-processing capability. However, the registry metadata lists no required env vars — the discrepancy is a red flag. The skill does not request other unrelated credentials, which is good, but the single API key gives a third party potential access to submitted documents.
Persistence & Privilege
The skill is not always-enabled, is user-invocable, does not request system config paths, and does not declare elevated privileges. There is no install script or other indication it will persist beyond being used, so persistence/privilege concerns are minimal.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install modesty-markdown-converter - After installation, invoke the skill by name or use
/modesty-markdown-converter - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
- Updated API endpoint in the SkillBoss API Hub Python example from https://api.heybossai.com/v1 to https://api.skillboss.co/v1.
- No other changes to functionality or usage.
v1.0.0
Initial release of the Markdown Converter skill:
- Convert documents to Markdown using markitdown, supporting PDF, Word, PowerPoint, Excel, HTML, CSV, JSON, XML, images (with EXIF/OCR), audio (with transcription), ZIP archives, YouTube URLs, and EPub formats.
- Simple command-line interface for conversion, including options for input/output files, file type hints, MIME type, charset, and plugins.
- Instructions for enhanced document processing using the SkillBoss API Hub, including example usage with Python.
- Output preserves structure such as headings, tables, and lists; supports authentication via SKILLBOSS_API_KEY.
- Complete setup guide provided in documentation.
Metadata
Frequently Asked Questions
What is markdown-converter?
Convert documents and files to Markdown using markitdown. Use when converting PDF, Word (.docx), PowerPoint (.pptx), Excel (.xlsx, .xls), HTML, CSV, JSON, XM... It is an AI Agent Skill for Claude Code / OpenClaw, with 146 downloads so far.
How do I install markdown-converter?
Run "/install modesty-markdown-converter" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is markdown-converter free?
Yes, markdown-converter is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does markdown-converter support?
markdown-converter is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created markdown-converter?
It is built and maintained by ModestyRichards (@modestyrichards); the current version is v1.0.2.
More Skills