Skill 指南

用一条 npx 命令安装部署 Skill，或下载 Skill 文件。安装后对 AI 说“部署到 htmlto.link”即可发布；匿名页面约保留 24 小时，登录后可长期管理。

第一步

安装 Skill

在项目根目录运行此命令。它会从 htmlto.link 获取最新 Skill，并写入 OpenCode / Claude Code / Codex 兼容目录。

安装命令

npx htmlto-link-skill

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

下载 Skill 文件查看 npm 包下载 Markdown Skill

第二步

使用方法

1

确认安装

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

2

对 Agent 说一句话

在 AI 编程工具中发送：把这个项目部署到 htmlto.link

3

获取公开链接

Agent 会打包 zip、调用部署接口，并且只返回可分享的链接。

推荐对 Agent 说

把这个项目部署到 htmlto.link

Markdown 变体

安装 Markdown Skill

发布独立的 Markdown 文档是单独的 Skill。在包含 .md 文件的目录下运行此命令。

安装命令

npx htmlto-link-md-skill

将 Markdown 文件发布为公开页面；未指定 templateId 时默认使用简洁模板。

查看 npm 包

Markdown 流程

如何发布 Markdown

1

确认安装

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

2

对 Agent 说一句话

在 AI 编程工具中发送：把这个 Markdown 文档发布到 htmlto.link

3

获取公开链接

Agent 读取 .md 文件、调用发布接口，并且只返回可分享的链接。

推荐对 Agent 说

把 README.md 发布到 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. 自动排除 .htmltolink.json、node_modules、.git、.next、dist/cache 等凭证或无关目录
4. 将项目打包成 zip 后调用 https://htmlto.link/api/skill/deploy
5. 成功后只返回最终公开分享链接
6. 创建或更新 .htmltolink.json，写入返回的 shareUrl、updateToken、temporary 和 expiresAt，并确保 .gitignore 包含 .htmltolink.json；不得向用户展示 updateToken，最终只返回 shareUrl

当前为匿名模式

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