← 返回 Skills 市场
markdown-converter
作者
ModestyRichards
· GitHub ↗
· v1.0.2
· MIT-0
146
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install modesty-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...
安全使用建议
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.
功能分析
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.
能力标签
能力评估
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.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install modesty-markdown-converter - 安装完成后，直接呼叫该 Skill 的名称或使用
/modesty-markdown-converter触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
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.
元数据
常见问题
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... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 146 次。
如何安装 markdown-converter？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install modesty-markdown-converter」即可一键安装，无需额外配置。
markdown-converter 是免费的吗？
是的，markdown-converter 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
markdown-converter 支持哪些平台？
markdown-converter 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 markdown-converter？
由 ModestyRichards（@modestyrichards）开发并维护，当前版本 v1.0.2。
推荐 Skills