前言¶

做演示稿時，常見路徑是：先有一份 Word、網頁或會議紀要，再手工拆成「一頁一個要點」。中間要刪廣告、補層級、想每頁講什麼，還要對照下游工具要求的 Markdown 結構。若下游走 ppt-master 的 Strategist 管線，輸入格式不對，後面改頁和配圖會反覆返工。

下面介紹 SkillHub 上的 ppt-master文檔助手（@user_633c893d/md-format，v2.1.0）：在 Agent 裏把文檔、網頁或粘貼文本轉成面向 ppt-master 的 Markdown，而不是從零手寫幻燈大綱。

這是什麼¶

ppt-master文檔助手 是社區來源（community）的 Agent Skill，發佈者爲 user_633c893d，分類爲 office-efficiency。它不直接生成 .pptx，而是把任意輸入整理成 ppt-master 最優輸入格式 的 Markdown：去噪、結構化精煉、YAML 意圖聲明、頁級拆分和圖表標註，輸出面向 ppt-master 的 Strategist 管線。

標籤 requires_api_key=false，安裝後無需額外 API Key 即可按 Skill 說明使用。

SkillHub 頁面顯示：評分 100000，累計下載 19394 次（截至頁面展示數據）。

核心功能¶

依據官方簡介，Skill 在 Agent 側完成以下處理（均針對「給 ppt-master 用的 Markdown」）：

1. 輸入多樣：支持文檔、網頁文章或用戶粘貼的純文本。
2. 去噪與精煉：去掉與演示無關的噪聲，保留可講的主線信息。
3. 結構化：把長文整理成層次清晰的 Markdown，便於後續按頁編排。
4. YAML 意圖聲明：在輸出中附帶 YAML，聲明演示意圖（具體字段以安裝後的 SKILL.md 爲準）。
5. 頁級拆分：按幻燈頁粒度切分內容，而不是一整段長文。
6. 圖表標註：對適合可視化的位置做標註，方便 Strategist 後續處理圖表需求。

在對話中可用官方給出的觸發詞喚起，例如：生成PPT素材、提煉成PPT、文檔轉PPT、轉爲幻燈格式、doc-to-slides。

安裝與啓用¶

官方頁面要求按 SkillHub 安裝文檔操作，並安裝座標 @user_633c893d/md-format。

1. 檢查或安裝 SkillHub CLI¶

先確認本機是否已有 skillhub：

command -v skillhub && skillhub --version

若未安裝，可使用 SkillHub 文檔中的推薦方式（完整安裝 CLI 與默認 Skill）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

僅需要 CLI 時：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

2. 安裝到當前 Agent 的 skills 目錄¶

安裝 Skill 時必須用 --dir 指向當前 Agent 識別的 skills 目錄；裝到默認 ./skills/ 可能不會被 Agent 加載。

skillhub install @user_633c893d/md-format --dir <你的 Agent skills 目錄>

常見路徑示例（以 SkillHub 安裝文檔爲準）：

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

對應 Cursor 可寫成：

skillhub install @user_633c893d/md-format --dir ~/.cursor/skills/

安裝完成後，按你所用客戶端的要求重啓或刷新 Agent，使新 Skill 生效。也可將官方安裝說明發給 AI，讓其按文檔完成安裝：

請根據 https://skillhub.cn/install/skillhub.md，安裝 @user_633c893d/md-format。

典型用法¶

官方未單獨給出逐步截圖示例，可復現的用法如下。

1. 確認 Skill 已出現在當前 Agent 的 skills 目錄並完成加載。
2. 在對話中提供材料：上傳文檔、給出網頁 URL，或直接粘貼正文。
3. 使用觸發詞說明目標，例如：「文檔轉PPT，按 ppt-master 格式輸出」或「提煉成PPT 素材」。
4. 檢查 Agent 輸出的 Markdown：是否包含 YAML 意圖塊、是否已按頁拆分、是否對圖表位置有標註。
5. 將輸出作爲 ppt-master Strategist 管線的輸入，繼續生成或調整幻燈。

若輸出結構與預期不符，可在同一會話中補充約束（頁數、受衆、必須保留的章節），讓 Agent 在 Skill 規則下重新整理。

適用場景與注意¶

適合誰

• 已有 ppt-master 工作流，希望把「長文 → Strategist 輸入」交給 Agent 標準化。
• 經常從報告、博客、會議紀要做彙報，需要先去噪再分頁，而不是手工複製粘貼。

注意

• 本 Skill 產出的是 Markdown 素材，不替代 ppt-master 本身的渲染與 Strategist 後續步驟；兩端格式要對齊，以 Skill 說明與 ppt-master 文檔爲準。
• 網頁與長文檔的真實內容以你提供的來源爲準；Agent 可能漏刪噪聲或誤拆頁，交付前建議人工過一遍頁級大綱與 YAML 意圖。
• 安裝路徑錯誤是常見坑：務必 --dir 到當前客戶端的 skills 目錄。
• 評分與下載量來自 SkillHub 頁面展示，會隨時間變化，以安裝前頁面爲準。

結尾¶

ppt-master文檔助手 把「文檔 / 網頁 / 粘貼文本 → 去噪、結構化、YAML、分頁、圖表標註」收斂成一條 Agent 指令，減少爲 Strategist 手寫輸入格式的時間。需要安裝或查看版本時，以 SkillHub 爲準：

• Skill 頁面：https://www.skillhub.cn/skills/user_633c893d/md-format
• 安裝說明：https://skillhub.cn/install/skillhub.md
• 座標：@user_633c893d/md-format（v2.1.0）