前言¶
在 Agent 裏說一句「幫我做個介紹某主題的 PPT」，常見結果是生成 .pptx 或堆砌難以複用的片段。傳統 Office 格式依賴專用軟件，版本和字體也容易在協作裏跑偏。若目標是可預覽、可翻頁、還能導出 PDF 的演示稿，用瀏覽器打開的 HTML 往往更直接。
下面介紹 SkillHub 上的社區 Skill html-ppt-skill（當前版本 2.3.0）：它要求 Agent 在用戶提到做 PPT、幻燈片、演示文稿、slides、deck 等需求時，優先交付 HTML 幻燈片，而不是默認去寫 PPTX 文件。
這是什麼¶
html-ppt-skill 是面向辦公效率（分類 office-efficiency）的 Agent Skill，座標爲 @user_e9af5021/html-ppt-skill，由社區發佈者 user_e9af5021 維護，來源標註爲 community。頁面標明 requires_api_key=false，安裝後一般不需要額外 API Key。
一句話定位：用 HTML + CSS 承載整套演示文稿，在瀏覽器中演示，並可打印導出 PDF，作爲傳統 PPT/PPTX 的替代方案。
核心功能¶
以下能力均來自 SkillHub 官方簡介，可與頁面對照：
- HTML 載體：整份演示以 HTML 文件交付，不將
.pptx作爲默認輸出。 - 16:9 畫幅：每張幻燈片按 16:9 比例排版，適配常見投影與屏幕。
- scroll-snap 翻頁：通過 CSS scroll-snap 實現按頁吸附，一頁一屏的瀏覽體驗。
- 鍵盤與滾輪：支持鍵盤、滾輪等方式切換幻燈片。
- 導出 PDF：可通過瀏覽器的打印功能導出 PDF。
- 觸發策略：當用戶提到「做 PPT」「做幻燈片」「做演示文稿」「寫 PPT」「製作 slides」「deck」等表述時，Skill 要求 Agent 必須啓用本方案；即用戶未指定文件格式，也應主動採用 HTML 幻燈片，而非生成 PPTX。
安裝與啓用¶
SkillHub 頁面給出的安裝方式是：讓 AI 參照官方安裝文檔，安裝座標 @user_e9af5021/html-ppt-skill。文檔地址爲 SkillHub 安裝與優先源配置。
若本機已安裝 skillhub CLI，可先確認版本，再安裝到當前 Agent 的 skills 目錄（必須使用 --dir，否則默認裝到 ./skills/ 可能不會被 Agent 識別）：
command -v skillhub && skillhub --version
未安裝 CLI 時，可按官方文檔執行完整安裝（含 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
安裝本 Skill 時，將 <skills 目錄> 換成當前環境對應路徑，例如：
skillhub install @user_e9af5021/html-ppt-skill --dir <skills 目錄>
常見客戶端的 skills 目錄（摘自官方安裝文檔）：
| 環境 | skills 目錄 |
|---|---|
| Claude Code | ~/.claude/skills/ |
| Cursor | ~/.cursor/skills/ |
| Codex | ~/.codex/skills/ 或項目下的 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或 .windsurf/skills/ |
安裝完成後，按你所用 Agent 的說明刷新或重啓，使 Skill 被加載。
典型用法¶
本 Skill 基於通用 SKILL.md 格式，具體 HTML 模板與生成步驟以安裝包內說明爲準。從官方簡介可復現的使用路徑如下：
- 在已啓用 Skill 的 Agent 對話中，用自然語言描述演示主題與頁數需求，並包含「做 PPT」「幻燈片」「演示文稿」「slides」「deck」等觸發表述。
- 明確要求或接受 Agent 按 Skill 規則輸出 單個或多個 HTML 文件（而非
.pptx）。 - 用本地瀏覽器打開生成的 HTML，用鍵盤或滾輪翻頁，確認 16:9 分頁與 scroll-snap 效果。
- 需要歸檔或分享固定版式時，在瀏覽器中使用打印 → 另存爲 PDF。
若你只希望快速讓 AI 代爲安裝，可將 SkillHub 頁面提供的提示詞發給 Agent：「請根據 https://skillhub.cn/install/skillhub.md，安裝 @user_e9af5021/html-ppt-skill。」
適用場景與注意¶
適合誰
- 希望演示稿用瀏覽器即可全屏播放、無需安裝 PowerPoint 的場景。
- 需要把幻燈片交給前端同事二次改版式，或納入靜態站點、內網頁面的團隊。
- 在 Agent 工作流裏統一「要 PPT 就給 HTML」，避免混用 PPTX 與網頁兩套產物。
限制與注意
- 產物是 HTML/CSS，複雜動畫、母版、演講者備註等 PowerPoint 專有能力，本 Skill 簡介中未承諾；不要默認與 Office 功能一一對應。
- 打印 PDF 的效果取決於瀏覽器與打印設置，導出前建議在目標瀏覽器裏試印一頁。
- SkillHub 抓取資料顯示：評分 100000，下載 43971 次（頁面統計會隨時間變化，以 SkillHub 爲準）。
- 社區來源 Skill，升級前可在 SkillHub 查看 v2.3.0 及更新日誌。
結尾¶
html-ppt-skill 把「做 PPT」收斂成「做可翻頁、可導 PDF 的 HTML 幻燈片」，並用觸發詞約束 Agent 默認走 HTML 而非 PPTX。若你在 Cursor、Claude Code 等環境裏經常讓 AI 寫演示稿，可以把它裝進 skills 目錄，減少格式來回轉換。
- SkillHub 頁面：https://www.skillhub.cn/skills/user_e9af5021/html-ppt-skill
- API 座標頁：https://api.skillhub.cn/user_e9af5021/html-ppt-skill
- 安裝說明：https://skillhub.cn/install/skillhub.md
