← Back to Skills Marketplace
huangesun

md-docx

by huangesun · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
360
Downloads
0
Stars
4
Active Installs
1
Versions
Install in OpenClaw
/install md-docx
Description
这是一个用于md文件与docx文件相互转换的技能。支持Markdown转Word文档,以及Word文档转Markdown格式。
Usage Guidance
This skill appears to do what it says: local Markdown ↔ Word conversions using a bundled Python script. Before installing or running it: (1) run the script in an isolated environment (or inspect it yourself) and ensure python-docx and markdown are installed; (2) be aware it will read input files and write output files (creates converted/ by default); (3) it does not request credentials or perform network calls in the provided code, but if you modify the script or run a version that adds network libraries (requests), re-audit for external uploads; (4) for large or sensitive documents, run conversions on a trusted machine or sandbox to avoid accidental exposure. The minor mismatches to note: SKILL.md lists memory tools and environment variables as configurable, but the script does not strictly depend on them—this is likely harmless but worth confirming in your deployment.
Capability Analysis
Type: OpenClaw Skill Name: md-docx Version: 1.0.0 The skill is a legitimate utility for converting between Markdown and Word (DOCX) formats. The core logic in `scripts/converter.py` uses standard libraries like `python-docx` and `markdown` to process files locally, with no evidence of data exfiltration, network calls, or malicious command execution. The instructions in `SKILL.md` are transparent and align with the stated purpose of the tool.
Capability Assessment
Purpose & Capability
Name and description (md ↔ docx conversion) align with the included converter.py and test.md. The Python script uses python-docx and markdown to implement both directions and creates a local output directory for results. Required capabilities are proportional to the task.
Instruction Scope
SKILL.md instructs the agent to accept uploads, validate paths, and call converter.py — that's consistent. It also lists tools (memory_read/memory_write) that the converter.py code does not appear to need; this is likely a minor mismatch in tooling declarations rather than malicious scope creep. The instructions do not request reading unrelated system files or sending data to external endpoints.
Install Mechanism
There is no install spec (instruction-only with a bundled script), so nothing is downloaded at install time. The Python script requires external packages (python-docx, markdown) but these are standard and documented in the script header; no arbitrary remote download URLs or extract operations are present.
Credentials
SKILL.md documents optional environment variables (OUTPUT_DIR, CONVERSION_MODE, KEEP_IMAGES) but the registry shows no required env vars. The converter.py constructor accepts output_dir and keep_images but does not appear to read environment variables directly; this is a minor inconsistency (declared optional env vs. actual code usage) but not a credential or privacy risk. No secrets or unrelated credentials are requested.
Persistence & Privilege
always is false and the skill does not request elevated/system-wide persistence. It creates local output directories for converted files (expected behavior) and does not modify other skills' configs or global agent settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install md-docx
  3. After installation, invoke the skill by name or use /md-docx
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
md-docx 1.0.0 初始版本 - 支持Markdown (.md) 与 Word (.docx) 文件的相互转换,包含批量转换功能 - 自动识别用户需求(md→docx、docx→md),并引导上传文件 - 转换过程会尽可能保留标题、列表、表格、代码块及图片等格式 - 提供转换结果的下载链接或文件路径,并支持后续转化请求 - 输出目录、转换模式、图片保留等均可通过环境变量配置 - 支持最大50MB文件,自动创建输出文件夹并避免文件覆盖
Metadata
Slug md-docx
Version 1.0.0
License MIT-0
All-time Installs 4
Active Installs 4
Total Versions 1
Frequently Asked Questions

What is md-docx?

这是一个用于md文件与docx文件相互转换的技能。支持Markdown转Word文档,以及Word文档转Markdown格式。 It is an AI Agent Skill for Claude Code / OpenClaw, with 360 downloads so far.

How do I install md-docx?

Run "/install md-docx" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is md-docx free?

Yes, md-docx is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does md-docx support?

md-docx is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created md-docx?

It is built and maintained by huangesun (@huangesun); the current version is v1.0.0.

💬 Comments