前言¶
项目收尾、周报月报、调研结论，常见交付物仍是 Word 或 Markdown：能写清内容，但对外展示时要再排版、找模板，或交给设计做一页式网页。自己写 HTML/CSS 成本高，通用 PPT 又容易和「数据看板、流程说明」这类结构错位。
下面介绍 SkillHub 上的社区 Skill「HTML汇报生成器」：在支持 Skills 的 Agent 里用自然语言描述材料，由 Skill 约束生成带主题与动效的单页 HTML，并可导出 PDF。本文事实来自 SkillHub 公开页与安装文档，安装与路径以官方说明为准。
这是什么¶
HTML汇报生成器（坐标 @user_622dd231/html-report-generator-v2，版本 1.0.1）是 SkillHub community 来源、分类为 office-efficiency 的技能，发布者为 user_622dd231。页面标注 requires_api_key=false，不依赖额外 API Key。
定位可以概括为：不写前端代码，把项目总结、工作汇报、研究报告、技术文档、提案、数据看板等内容，生成可浏览器打开的精美 HTML 页面；生成后还可通过内置能力调整配色与样式，并支持 PDF 导出。
- SkillHub 技能页：https://www.skillhub.cn/skills/user_622dd231/html-report-generator-v2
- API 坐标入口：https://api.skillhub.cn/user_622dd231/html-report-generator-v2
核心功能¶
以下能力均来自 SkillHub 简介与技能页描述，不做外延推断。
| 能力 | 说明 |
|---|---|
| 内容形态 | 面向项目总结、工作汇报、研究报告、技术文档、提案、数据看板等文本型输入 |
| 主题与视觉 | 12 种主题；11 种背景动效；9 种鼠标特效；10 种边框样式 |
| 交互与排版 | 实时调色器；毛玻璃卡片式布局 |
| 导出 | 支持 PDF 导出 |
| 生成后编辑 | 生成结果可继续自由调色 |
官方列出的常见触发表述包括：项目总结、工作汇报、PPT、生成报告、做个总结、HTML文档、数据报告、流程文档、会议纪要、技术文档、研究报告、数据看板、提案、做个展示页、帮我做个汇报、文档生成等。在对话里用接近上述意图的表述即可唤起 Skill 所附流程（具体章节结构由 Skill 内 SKILL.md 约束，以你本地安装后的文件为准）。
安装与启用¶
SkillHub 页面给出的安装指引是：按 https://skillhub.cn/install/skillhub.md 安装 @user_622dd231/html-report-generator-v2。下面是与该文档一致的可执行步骤摘要。
1、安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 CLI：
command -v skillhub && skillhub --version
未安装时，可用官方脚本（完整安装含默认 Skill；仅需 CLI 时加 --cli-only）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装本 Skill 到当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向当前 Agent 实际读取的 skills 目录；默认装到 ./skills/ 时，部分客户端不会加载，且通常需要重启客户端后生效。
skillhub install @user_622dd231/html-report-generator-v2 --dir <skills 目录>
常用客户端 skills 路径（摘自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/ - Windsurf：
~/.codeium/windsurf/skills/或项目下的.windsurf/skills/ - Gemini CLI：
~/.gemini/skills/
在 Cursor 中，示例为：
skillhub install @user_622dd231/html-report-generator-v2 --dir ~/.cursor/skills/
若你不使用 CLI，也可将 SkillHub 页面上的安装提示词发给 Agent，让其按同一安装文档完成安装；路径仍须对齐上述目录规则。
典型用法¶
经过上面的安装与重启（如客户端要求）后，在 Agent 对话中说明你要做的汇报类型，并附上已有要点或全文。用法上没有单独的「命令行子工具」：核心是 自然语言 + 触发意图，由 Skill 指导模型产出 HTML 文件。
可复现的对话起点示例（意图与官方触发词一致，内容请换成你的真实材料）：
- 说明任务类型，例如：「帮我做个工作汇报，生成 HTML 文档。」
- 粘贴或概述结构：本周完成项、风险、下周计划；或研究报告的摘要、方法、结论。
- 若需要特定观感，可在同轮对话中提及主题、动效或边框偏好（Skill 简介中列有可选数量，具体选项以生成页内控件或 Skill 指引为准）。
- 在浏览器中打开生成的 HTML 检查排版；需要归档时使用页面提供的 PDF 导出。
不建议在对话中要求编造未提供的指标或案例；输入事实越完整，生成页越接近可直接对外使用的版本。
适用场景与注意¶
更适合谁
- 需要快速把已有文字整理成单页展示型 HTML 的开发者、项目经理、研究或运营同学。
- 希望减少手写 CSS、但仍要主题、动效、毛玻璃卡片等「汇报页」观感，且接受在 Agent 里迭代文案与结构的人。
- 环境已支持 Skills，且愿意通过 SkillHub 安装 community 技能的用户。
限制与注意
- 技能来源为 community，质量与更新节奏依赖发布者 user_622dd231；升级可用
skillhub在对应目录执行更新类操作（以 SkillHub CLI 当前命令为准）。 - 动效、鼠标特效会抬高页面复杂度；对内网演示、低配设备或「纯阅读」场景，宜在对话中要求简化动效或静态背景。
- 简介强调「不用写一行代码」，指的是你侧不必手写 HTML；仍须在对话中提供准确内容与结构，并自行核对敏感信息与合规要求。
- SkillHub 页面展示的下载量、评分等会变动；撰写时页面为评分 100000、下载 4247（以你打开技能页时为准）。
结尾¶
HTML汇报生成器把「写材料」和「做展示页」合成一步：在 Agent 里用触发意图描述汇报类型，借助多主题、动效、调色与 PDF 导出，得到可分享的 HTML。若你使用 Cursor 等支持 Skills 的客户端，可按本文安装到对应 skills 目录后试用。
官方技能页：https://www.skillhub.cn/skills/user_622dd231/html-report-generator-v2
