Skill 指南

用一条 npx 命令安装同一个 Skill。是 Markdown 还是 HTML，由 Skill 自己判断。匿名页面约保留 24 小时，登录后可长期管理。

第一步

安装 Skill

在项目根目录运行此命令。它会从 htmlto.link 获取最新 Skill。Markdown 文档和 HTML 项目都用这一条。

安装命令

npx htmlto-link-skill

零依赖、无交互。也可下载 SKILL.md 后手动放入 skills 目录。

下载 Skill 文件查看 npm 包

第二步

使用方法

1

确认安装

确认 .opencode/skills、.claude/skills 或 .agents/skills 下已出现 html-to-link-deploy。

2

对 Agent 说一句话

在 AI 编程工具中发送：把这个项目部署到 htmlto.link。如果是 Markdown，直接说把这份 Markdown 发布到 htmlto.link。

3

获取公开链接

Agent 会自己判断：Markdown 走分享接口，HTML 项目打包后走部署接口，并且只返回可分享的链接。

推荐对 Agent 说

把这个项目部署到 htmlto.link

匿名与登录模式

匿名（未登录）

无需 token。创建约 24 小时的临时页面；使用 .htmltolink.json 中的 shareUrl + updateToken 可更新同一链接并重置有效期。

账户（已登录）

设置 HTML_TO_LINK_TOKEN（登录本页后可获取），即可创建长期页面、在“我的页面”管理，并通过 shareUrl 发布新版本。

支持匿名使用

未登录也能使用

匿名 Agent 可发布约 24 小时的临时页面，并使用 .htmltolink.json 中的项目凭证更新同一链接。登录后可获得 API token 并长期管理。

登录以长期保存

备选方案：不安装 Skill，直接复制提示词

适合快速试用。提示词包含完整部署说明；已登录用户的 token 在页面上会被遮盖。

可直接复制

备选部署提示词

请把当前项目部署到 https://htmlto.link 。

要求：
1. 不要发送 Authorization 或 x-api-token；这是匿名发布
2. 如果 .htmltolink.json 同时包含 shareUrl 和 updateToken，就分别作为 share_url 和 update_token 更新这个项目自己的临时页面；否则创建新页面
3. 如果要发布的是 Markdown 文档（.md 或一段 Markdown），不要打包 zip。按 Skill 里的 Markdown 路径调用 https://htmlto.link/api/shares。
4. 自动排除 .htmltolink.json、node_modules、.git、.next、dist/cache 等凭证或无关目录
5. 将项目打包成 zip 后调用 https://htmlto.link/api/skill/deploy
6. 成功后只返回最终公开分享链接
7. 创建或更新 .htmltolink.json，写入返回的 shareUrl、updateToken、temporary 和 expiresAt，并确保 .gitignore 包含 .htmltolink.json；不得向用户展示 updateToken，最终只返回 shareUrl

当前为匿名模式

无需账户 token。发布后请将 .htmltolink.json 加入 .gitignore，切勿泄露 updateToken。