前言¶
在 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
