前言¶

把 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