前言¶

把 PDF、Office、网页快照等资料交给大模型分析时，往往要先落成 Markdown：结构清晰、token 更省，也方便后续检索与二次编辑。自己在本机装转换工具、维护依赖和脚本，会占用不少时间。下面介绍 SkillHub 上的 markdown-converter（页面名称：Markdown转换助手），通过标准 Skill 挂到 Cursor、Claude Code 等客户端，由 Agent 按技能说明完成转换相关步骤，减少手工搭环境。

这是什么¶

markdown-converter 是 SkillHub 坐标 @org-0ll53pt7/markdown-converter 下的办公效率类 Skill，当前版本 1.0.0，来源标注为 enterprise，分类为 office-efficiency。发布方为海口蓝羽兴体育文化发展有限公司。

官方简介为：针对 Markdown 提供转换能力，帮助用户快速完成相关任务并减少返工。技能标签标明 requires_api_key=false，使用时不需要单独配置 API Key。

SkillHub 页面：https://www.skillhub.cn/skills/org-0ll53pt7/markdown-converter
资料索引地址：https://api.skillhub.cn/zcwl/markdown-converter

核心功能¶

根据 SkillHub 公开信息，该 Skill 的定位是 Markdown 相关转换，具体格式支持、输出约定和边界条件写在技能包内的 SKILL.md 中；安装后由 Agent 读取并执行，而不是在文章里重复臆造命令行参数。

已可核实的能力边界包括：

• 面向「转成 Markdown / 在 Markdown 流程里减少返工」一类任务，由 Agent 按技能文档编排步骤。
• 不依赖外部 API Key（requires_api_key=false）。
• 与 SkillHub 生态一致：搜索、安装、升级走 skillhub CLI 或按安装文档交给 AI 处理。

安装与启用¶

SkillHub 官方安装说明见 https://skillhub.cn/install/skillhub.md。页面给出的安装提示为：让 AI 根据该文档安装 @org-0ll53pt7/markdown-converter。

1、确认 CLI¶

先检查本机是否已有 skillhub：

command -v skillhub && skillhub --version

若未安装，可按官方文档执行完整安装或仅安装 CLI（脚本地址见 skillhub.md 中的 install.sh 说明）。

2、安装到当前 Agent 的 skills 目录¶

安装时必须用 --dir 指向当前客户端识别的 skills 目录，否则默认落在 ./skills/，Agent 可能读不到。常见路径如下（摘自 SkillHub 安装文档）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

在 Cursor 中可执行：

skillhub install @org-0ll53pt7/markdown-converter --dir ~/.cursor/skills/

也可将 SkillHub 页面上的安装提示发给 AI，由其按 skillhub.md 完成安装与目录校验。Codex CLI、Claude Code 与 Cursor 的差异主要在 skills 目录路径；安装命令形式相同，替换 --dir 即可。

3、启用方式¶

Skill 基于通用 SKILL.md 格式。安装到对应目录后，在对话中说明要处理的文件与期望的 Markdown 输出，Agent 会按技能说明调用内置流程。是否需要重启客户端，以你当前 Agent 文档为准；SkillHub 文档提醒：装错目录时即使重启也不会生效。

典型用法¶

公开页面未附带独立示例仓库，可复现的用法是「安装技能 + 自然语言任务描述」：

1. 完成上一节的 skillhub install，确认 @org-0ll53pt7/markdown-converter 出现在 skills 目录。
2. 在对话中说明源文件路径（或上传附件）、目标（例如「转为 Markdown 并保留标题层级」）。
3. 由 Agent 读取 SKILL.md 执行转换；若有报错，根据技能内说明调整输入格式或路径权限。

若需核对技能细节，可在安装后本地打开该 Skill 目录下的 SKILL.md，与 Agent 行为对照。

适用场景与注意¶

适合谁

• 经常把各类办公文档、资料交给 AI 做摘要、改写或入库，希望统一走 Markdown 中间态的开发者或内容岗位。
• 已使用 SkillHub / Cursor 等支持 Skills 的环境，希望用商店里评分与下载量较高的办公类技能（SkillHub 页面统计：评分 100000，下载 19883 次）减少自写脚本。

注意

• 本文未展开具体支持的文件扩展名与转换引擎；以安装后的 SKILL.md 和 SkillHub 页面简介为准，避免假设未在官方资料中出现的实现细节。
• 企业来源（enterprise）技能的使用与更新策略，以 SkillHub 与你所在组织的合规要求为准。
• 处理含敏感信息的文件时，注意本地路径权限与是否允许将文件内容送入模型上下文。

结尾¶

markdown-converter 把 Markdown 转换能力封装成可安装的 Agent Skill，免去了为单次任务单独搭转换环境的成本；配合 requires_api_key=false，上手路径主要是装好 CLI、指向正确的 skills 目录、用对话描述任务。

官方 SkillHub 页面：https://www.skillhub.cn/skills/org-0ll53pt7/markdown-converter
资料 API：https://api.skillhub.cn/zcwl/markdown-converter