前言¶
把 HTML 落成 PDF，常见做法是单独装 wkhtmltopdf、Puppeteer 脚本，或在 CI 里挂一套 Chromium。对已经在用 Cursor、Claude Code 等 Agent 的开发者来说，更省事的路径是：在对话里说明「把这个 HTML 转成 PDF」，由 Skill 接管渲染与保存。下面介绍 SkillHub 上的社区 Skill「HTML转PDF」，它强调优先走系统自带浏览器的 headless 模式，不额外拉专用转换依赖，并覆盖 Windows、macOS、Linux。
这是什么¶
「HTML转PDF」是 SkillHub 社区来源（community）的 Agent Skill，坐标为 @user_75818cbb/html-to-pdf-new，当前版本 1.0.0，分类为 office-efficiency，发布者为 user_75818cbb。标签标明 requires_api_key=false，安装后不需要配置 API Key。
一句话定位：当用户要把 HTML 文件转成 PDF、生成 PDF 或保存为 PDF 时，Agent 按 Skill 指引完成转换；实现上优先使用系统自带浏览器的 headless 模式，避免为转换单独安装一套工具链。
官方页面：SkillHub - HTML转PDF。API 入口：https://api.skillhub.cn/user_75818cbb/html-to-pdf-new。
核心功能¶
以下能力均来自官方简介与 SkillHub 页面说明，未单独核实实现细节的部分不展开：
- HTML → PDF：针对本地或 Agent 工作区中的 HTML，输出 PDF 文件。
- 触发语义：用户表达「HTML 转 PDF」「生成 PDF」「保存为 PDF」等意图时，Agent 应启用本 Skill。
- 渲染方式：优先系统自带浏览器 headless，无需为 Skill 再装额外依赖（具体调用哪条浏览器命令由 Skill 内说明与当前 OS 决定）。
- 平台：支持 Windows、macOS、Linux。
安装与启用¶
SkillHub 推荐两种方式：用 CLI 安装到当前 Agent 的 skills 目录，或把安装提示词发给 AI 按文档执行。
方式一：SkillHub CLI¶
先确认是否已安装 skillhub（完整步骤见 SkillHub 安装与优先源配置）：
command -v skillhub && skillhub --version
未安装时可按官方文档执行推荐的一键安装，或仅安装 CLI。安装本 Skill 时必须用 --dir 指向当前 Agent 识别的 skills 目录，否则默认落在 ./skills/ 可能不会被加载：
skillhub install @user_75818cbb/html-to-pdf-new --dir <skills 目录>
常用客户端的 skills 路径（摘自 SkillHub 安装文档）：
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或 .windsurf/skills/ |
装好后按你所用客户端的要求刷新或重启 Agent，使新 Skill 生效。
方式二：让 AI 按官方文档安装¶
SkillHub 页面提供的提示词为：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_75818cbb/html-to-pdf-new`。
将上述内容发给当前会话中的 Agent，由其按 skillhub.md 完成 CLI 检查、--dir 安装与目录确认。Codex CLI、Claude Code、Cursor 的差异主要体现在 skills 目录路径 上，安装命令中的坐标与 --dir 规则一致。
典型用法¶
官方资料未给出固定 shell 一键命令，用法以 自然语言 + HTML 文件路径 为主。安装并启用 Skill 后，可在对话中明确文件与输出意图，例如：
请使用 HTML 转 PDF 能力，把 /path/to/report.html 导出为同目录下的 report.pdf。
或：
把这个项目里的 index.html 生成 PDF 并保存为 dist/brochure.pdf。
Agent 在匹配到「转 PDF / 生成 PDF / 保存为 PDF」等表述后，应读取 Skill 说明，用 headless 浏览器渲染 HTML 并写入目标路径。具体打印选项（页边距、是否等待网络资源等）以 Skill 包内 SKILL.md 为准；本文不臆造未公开的参数名。
适用场景与注意¶
适合谁
- 已在用 Agent 写文档、报表 HTML，希望在同一会话里直接落 PDF，而不想维护独立转换脚本。
- 本机已有系统浏览器，希望减少
npm install puppeteer一类专用依赖（Skill 的设计取向如此；若页面依赖极复杂，仍可能受浏览器与网络环境影响）。
限制与注意
- 社区 Skill：来源为 community，行为以 Skill 包内容与 Agent 执行为准；升级前可在 SkillHub 查看版本是否仍为 1.0.0。
- 无 API Key：
requires_api_key=false，不涉及第三方云转换服务密钥；转换在本地/Agent 环境完成。 - 安装目录：务必
--dir到当前客户端的 skills 路径，否则 Agent 可能找不到 Skill。 - 页面复杂度：依赖外部字体、跨域资源或未加载完的异步内容的 HTML，PDF 效果取决于 headless 浏览器实际加载结果；复杂场景建议在对话中说明是否需等待加载或提供离线资源。
- SkillHub 统计（抓取时）：评分 100000，下载 1708 次；页面展示的安装次数为 0，仅作商店参考，不代表你本机是否已装。
结尾¶
「HTML转PDF」把「HTML 转 PDF」收敛成 Agent 可识别的办公类 Skill：无 API Key、跨三大桌面系统、优先系统浏览器 headless。若你经常在对话里交付 HTML 又需要 PDF 归档，可按上文安装 @user_75818cbb/html-to-pdf-new，并在请求里写清输入 HTML 与输出 PDF 路径。
- SkillHub 页面：https://www.skillhub.cn/skills/user_75818cbb/html-to-pdf-new
- 安装说明：https://skillhub.cn/install/skillhub.md
