前言¶
报告、对账单、导出页这类内容，很多团队先用 HTML 排版：改样式快、和 Web 栈一致。真要发给客户或走打印流程时，往往还要再出一版 PDF。自己接 headless 浏览器或排版引擎，要处理字体、分页和 CSS 差异，维护成本不低。若你已经在 Cursor、Claude Code 等环境里用 Skills 扩展 Agent 能力，可以把「HTML → PDF」交给专门技能，用对话描述输入输出即可。
下面介绍 SkillHub 社区技能 HTML转PDF（通用版）（坐标 @user_e60b9cd9/html-to-pdf-pro），说明它解决什么问题、如何安装，以及使用时需要留意的边界。
这是什么¶
HTML转PDF（通用版） 是 SkillHub 上的社区技能（来源：community，分类：office-efficiency），当前版本 1.0.0，由发布者 user_e60b9cd9 维护。
官方简介中的定位是：将 HTML 文件转换为高质量 PDF；支持中文、CSS 样式保留、A4 页面设置；适用于报告、文档、发票等需要打印或分享的场景；当需要将 HTML 转换为 PDF 时使用此技能。
技能标签标明 requires_api_key=false，即按 SkillHub 公示信息，不依赖额外 API Key 即可使用。
核心功能¶
以下能力均来自 SkillHub 页面与抓取资料中的简介，未在公开页展开的实现细节（例如具体依赖哪套渲染引擎）不在本文中臆测。
- HTML 输入 → PDF 输出：以 HTML 文件为源，生成 PDF 文件。
- 中文与样式：说明中明确支持中文，并尽量保留 CSS 样式，便于版式与 Web 预览接近。
- 页面规格：默认面向 A4 页面设置，贴合常见打印与归档习惯。
- 场景导向：面向报告、文档、发票等需要打印或分发的内容。
安装与启用¶
SkillHub 官方页面给出的安装提示是：按 SkillHub 安装文档 安装坐标 @user_e60b9cd9/html-to-pdf-pro。
1、安装 SkillHub CLI（若尚未安装）¶
先检查本机是否已有 skillhub：
command -v skillhub && skillhub --version
若未安装，可按安装文档执行完整安装（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 目录¶
安装文档要求：安装时必须用 --dir 指向当前 Agent 实际读取的 skills 目录，否则默认会装到 ./skills/，Agent 可能识别不到。
常见路径示例（以安装文档为准）：
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
在 Cursor 中安装本技能可执行：
skillhub install user_e60b9cd9/html-to-pdf-pro --dir ~/.cursor/skills/
Claude Code、Codex 等环境将 --dir 换成上表中对应路径即可。安装后若 Agent 未立刻加载新技能，按你所用客户端的说明重启或重新打开会话。
也可将官方安装句发给 AI，让其按文档代为执行：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_e60b9cd9/html-to-pdf-pro`。
典型用法¶
公开 SkillHub 详情页未附带独立的命令行示例或脚本片段；技能以通用 SKILL.md 形式向 Agent 提供操作指引。启用后，用法本质是：在已安装技能的 Agent 会话中，说明 HTML 源路径与期望的 PDF 输出。
可复现的交互方式示例（路径请换成你本机真实文件）：
请使用 HTML转PDF 技能，把 /path/to/report.html 转成 PDF，输出到 /path/to/report.pdf，保持现有 CSS，按 A4 排版。
若 HTML 引用了相对路径的图片或样式表，建议在提示中写明工作目录或要求 Agent 先检查资源是否可被正确加载，避免 PDF 缺图或样式丢失——这与「CSS 样式保留」目标一致，但具体行为以技能内说明及 Agent 执行环境为准。
适用场景与注意¶
适合谁
- 需要在 Agent 工作流里快速把 HTML 导出为 PDF，又不想每次手写渲染脚本的同学。
- 输出以中文报告、文档、发票类版式为主，且希望页面规格贴近 A4 的场景。
使用上可留意的点
- 技能为 community 来源，安装前可按 SkillHub 惯例自行确认版本与说明；当前公示版本为 1.0.0。
- 复杂 CSS（多栏、固定定位、自定义字体）在不同渲染后端上表现可能不一致；若版式极敏感，应对照生成的 PDF 做一次目视验收。
- 抓取资料显示该技能 requires_api_key=false；若你所在环境对出站网络或本地二进制有沙箱限制，转换步骤仍可能受环境影响，需在真实项目中试跑一次。
结尾¶
HTML转PDF（通用版） 把「HTML 文件 → 带中文与样式、A4 取向的 PDF」收敛成一条 Agent 技能，适合报告、文档、发票等打印与分享场景。安装走 SkillHub CLI，坐标 @user_e60b9cd9/html-to-pdf-pro，无需 API Key（按 SkillHub 标签）。
- SkillHub 页面：https://www.skillhub.cn/skills/user_e60b9cd9/html-to-pdf-pro
- API 条目：https://api.skillhub.cn/user_e60b9cd9/html-to-pdf-pro
- 安装说明：https://skillhub.cn/install/skillhub.md
