前言¶
把历史文档迁进知识库、给 RAG 做语料，或让 Agent 直接读正文时，.doc、.wps 和带复杂排版的 .docx 往往卡在格式上。纯靠 pandoc 或手工复制，中文乱码和 WPS 专有格式是常见坑。下面介绍 SkillHub 社区技能 tomark-skill：在 Agent 侧按固定管线批量输出 Markdown，并针对中文与 WPS 场景做了专门处理。
这是什么¶
tomark-skill（坐标 @user_f474679a/tomark-skill）是发布者 user_f474679a 在 SkillHub 上架的社区 Skill，分类为 office-efficiency，当前版本 1.0.0。标签 requires_api_key=false，不依赖外部 API Key。
一句话定位：批量将 .doc、.docx、.wps 转为 Markdown。官方简介给出的转换路径为：
.docx→ mammoth.doc/.wps→ WPS COM →.docx→ mammoth
特色说明里强调：尽量解决中文乱码，并支持 WPS 专有格式。
核心功能¶
依据 SkillHub 页面与技能简介，可核实的能力如下。
- 批量转换：面向多文件场景，而不是单次单文件演示。
- 多后缀支持：
.doc、.docx、.wps三类输入。 - 分路径处理：Office 系 docx 走 mammoth；旧版
.doc与 WPS 格式先经 WPS COM 落成 docx，再走 mammoth。 - 中文与 WPS：针对乱码与 WPS 格式做了针对性设计（具体实现以技能包内 SKILL 说明为准）。
安装与启用¶
安装流程遵循 SkillHub 通用说明（skillhub.md）。官方页面给出的安装提示为：按该文档安装 @user_f474679a/tomark-skill。
1、检查或安装 skillhub CLI¶
先确认本机是否已有 CLI：
command -v skillhub && skillhub --version
若未安装，可使用官方脚本（完整安装含默认 Skill；仅需 CLI 时加 --cli-only）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2、安装 tomark-skill 到当前 Agent 的 skills 目录¶
安装技能时必须用 --dir 指向当前客户端识别的 skills 目录，否则默认落在 ./skills/，Agent 可能读不到。
skillhub install @user_f474679a/tomark-skill --dir <你的 skills 目录>
常用路径示例（来自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可在对话中把官方安装说明交给 AI，让其按 skillhub.md 完成安装。安装后若客户端要求重启或重新加载 skills，按各自产品说明操作。
典型用法¶
公开简介未附带独立 CLI 子命令列表，用法以「启用 Skill 后由 Agent 按技能说明执行批量转换」为主。可复现的意图示例：
- 指定一个目录，要求将该目录下所有
.doc、.docx、.wps转为 Markdown。 - 说明输出目录或命名规则，让 Agent 按 tomark-skill 的管线（docx→mammoth；doc/wps→WPS COM→docx→mammoth）逐文件处理。
- 对曾出现乱码的 WPS 或旧
.doc样本，先小批量试转，确认正文与标题层级后再扩大批量。
具体参数、脚本入口以安装到本地的 SKILL.md 及技能包内文件为准。
适用场景与注意¶
适合谁
- 需要把存量 Word / WPS 文档沉淀为 Markdown 的开发者或文档维护者。
- 知识库、笔记仓库、静态站点源文件以
.md为主，但来源仍是 Office / WPS 的场景。 - 在 Linux 或自动化环境里，希望由 Agent 驱动批量转换而非手工点选导出。
限制与注意
.doc/.wps路径依赖 WPS COM，通常意味着运行环境需具备 WPS 及可用的 COM 自动化能力；纯 Linux 无 WPS 时，该路径可能无法按设计工作，需自行验证环境。- mammoth 擅长从 docx 提取结构与正文，复杂版式、文本框、部分嵌入对象可能与 Word 所见不一致，转换后宜人工抽检。
- 社区来源（source: community），升级与问题反馈依赖发布者与 SkillHub 生态，生产环境建议固定版本并保留样本回归。
结尾¶
tomark-skill 把「docx 直转」与「经 WPS 再转」两条链路写进同一 Skill，面向中文与 WPS 文档的 Markdown 批量产出。无需 API Key，通过 SkillHub 安装到 Cursor、Claude Code、Codex 等客户端的 skills 目录即可使用。
- SkillHub 页面：https://www.skillhub.cn/skills/user_f474679a/tomark-skill
- API 坐标页：https://api.skillhub.cn/user_f474679a/tomark-skill
- 安装说明：https://skillhub.cn/install/skillhub.md
