前言¶
技术分享、方案评审或内部分享,常见路径是先把长文整理成 PPT,再逐页排版。文章、Wiki、KM 里往往已经有完整结构,再手工拆页和套模板会占掉不少时间。若目标只是「能全屏翻页演示、单文件易分发」,直接生成 HTML 幻灯片往往更省事。
下面介绍 SkillHub 上的 htmlppt.skill(坐标 @user_5982371c/articletodeck):在 Agent 对话里把文章、链接或粘贴文本转成全屏翻页 HTML,并写入工作区;按 Skill 说明,还可经企微把结果发给用户。
这是什么¶
htmlppt.skill 是社区来源(community)的 Agent Skill,当前版本 1.0.0,发布者为 user_5982371c,在 SkillHub 分类为 office-efficiency。标签标明 requires_api_key=false,安装后不需要额外配置 API Key。
一句话定位:当用户希望把任意文章或文档做成「幻灯片风格」的全屏 HTML 演示时,由 Agent 按 Skill 流程拉取或读取内容、生成 HTML 文件并落盘。
官方入口:
- Skill 包地址:
https://api.skillhub.cn/user_5982371c/articletodeck - SkillHub 页面:
https://www.skillhub.cn/skills/user_5982371c/articletodeck
核心功能¶
以下能力均来自 SkillHub 简介与页面说明,未单独列出的细节不作延伸。
- 内容输入:支持文章链接、Markdown、直接粘贴的文本;并写明支持 iWiki 链接、KM 链接、本地文件路径 等来源。
- 输出形态:生成全屏翻页的 HTML 演示文件,呈现为幻灯片风格。
- 落盘与交付:HTML 保存到本地工作区;Skill 说明中写明可通过企微直接发送给用户。
- 触发方式:当用户表达「要做演示 / 转幻灯片 / 转 HTML deck」等意图时由 Agent 选用该 Skill。官方给出的触发示例包括:
- 帮我把这篇文章做成 PPT
- 转成演示文档
- 生成 HTML 幻灯片
- 做个演示
- 转成可以演示的格式
- article to deck
- make a slide
安装与启用¶
该 Skill 遵循通用 SKILL.md 格式。SkillHub 页面建议将安装提示发给 AI,并引用安装文档;也可在本机用 skillhub CLI 安装到当前 Agent 的 skills 目录(装错目录时 Agent 可能无法加载,需按环境选对路径)。
1、安装 skillhub CLI(若尚未安装)¶
先检查是否已有 CLI:
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、安装 htmlppt.skill¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录。以 Cursor 为例,常用路径为 ~/.cursor/skills/:
skillhub install @user_5982371c/articletodeck --dir ~/.cursor/skills/
其他客户端在 SkillHub 安装文档中列出的 skills 路径包括(按你实际使用的工具择一):
- Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或项目下的.agents/skills/ - Gemini CLI:
~/.gemini/skills/
安装完成后,按你所用 Agent 的惯例重新加载或重启会话,使新 Skill 生效。页面未单独区分 Cursor / Codex / Claude Code 的安装包差异时,以上路径与坐标安装方式即可复用。
也可在对话中直接说明:请根据 https://skillhub.cn/install/skillhub.md 安装 @user_5982371c/articletodeck。
典型用法¶
官方资料未提供逐步截图或固定样例仓库,可复现的用法是:在已启用 Skill 的 Agent 里,用自然语言带上内容来源,并命中上述触发意图。
-
粘贴正文或 Markdown
例如:「把下面这篇 Markdown 生成 HTML 幻灯片,全屏翻页。」随后粘贴全文。 -
给出链接
例如:「这是 iWiki / KM 链接,帮我转成可以演示的 HTML。」并附上链接(Skill 简介中明确支持 iWiki、KM)。 -
本地文件
在工作区内给出可读路径,例如:「把docs/design.md转成演示文档。」Agent 按 Skill 读取文件并生成 HTML。 -
查看结果
生成文件会保存在当前本地工作区;若你使用企微协作,可按 Skill 说明由 Agent 经企微发送 HTML。
具体分页规则、主题样式等以 Skill 包内 SKILL.md 为准;本文不臆测未公开的实现细节。
适用场景与注意¶
适合谁
- 已有长文、Wiki 或 KM 文档,需要快速得到可演示的单文件 HTML。
- 希望减少「先做 PPT 再对齐原文」的重复劳动,且接受浏览器全屏演示而非
.pptx。
使用上注意
- requires_api_key=false 仅表示 SkillHub 标签未要求 API Key;企微发送、内网 Wiki/KM 访问仍取决于你所在环境与 Agent 权限。
- 内网链接与本地路径能否读取,由 Agent 运行环境决定;无法访问时需在对话中改用粘贴正文或可访问的副本。
- SkillHub 统计(截至页面抓取):评分 100000,下载 2402,安装 57;选用时可结合社区来源自行评估维护节奏。
结尾¶
htmlppt.skill 把「文章 / 文档 → 全屏 HTML 幻灯片」收敛成 Agent 内可触发的流程:多来源输入、工作区落盘、可选企微交付。若你经常在 Cursor 等环境里做内部分享,可先按上文安装到对应 skills 目录,再用触发语带上链接或正文试一轮。
SkillHub 页面:https://www.skillhub.cn/skills/user_5982371c/articletodeck
Skill 包:https://api.skillhub.cn/user_5982371c/articletodeck