Skip to content
Back to search

html-prototype-skill

Portable Agent Skill for interactive, offline, single-file HTML product prototypes.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/osborn001--html-prototype-skill/badge.svg)](/listings/osborn001--html-prototype-skill)

HTML

<a href="/listings/osborn001--html-prototype-skill"><img src="/api/listings/osborn001--html-prototype-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

用 Skills CLI 安装

在工作项目里运行以下命令,选择正在使用的 Agent。需要 Node.js 22.20 或以上版本。默认装到当前项目,追加 `-g` 可安装到用户范围。[Skills CLI 安装文档](https://github.com/vercel-labs/skills#install-a-skill)

npx skills add osborn001/html-prototype-skill --skill html-prototype

若工具自动选中了其他客户端,可追加 `--agent codex`、`--agent claude-code`、`--agent cursor` 或 `--agent opencode`。

手动安装

下载仓库 ZIP 并解压。把整个 `html-prototype/` 文件夹复制到客户端的 Skills 目录,确认最终结构是 `skills/html-prototype/SKILL.md`。已有同名版本时先备份,再替换整个目录。

| 客户端 | 项目目录 | 用户目录 | |---|---|---| | Codex | `.agents/skills/` | `~/.agents/skills/` | | Claude Code | `.claude/skills/` | `~/.claude/skills/` | | Cursor | `.agents/skills/` | `~/.agents/skills/` | | OpenCode | `.agents/skills/` | `~/.agents/skills/` | | 其他兼容 Agent | 以客户端支持的 Skills 目录为准 | 以客户端支持的 Skills 目录为准 |

`~` 代表运行 Agent 的用户目录。在 Windows 原生客户端或 WSL 里使用时,分别按对应环境的用户目录安装。[Codex](https://learn.chatgpt.com/docs/build-skills#where-codex-loads-local-skills) · [Claude Code](https://code.claude.com/docs/en/skills#choose-where-skills-load) · [Cursor](https://cursor.com/docs/skills#skill-directories) · [OpenCode](https://opencode.ai/docs/skills/#discovery)

以下命令假定当前目录下有解压得到的 `html-prototype/`。要装到另一个项目,可在目标项目中执行,并把源路径换成解压后该文件夹的绝对路径。Claude Code 把命令里的 `.agents/skills` 改成 `.claude/skills`。

**Windows PowerShell**

$skillRoot = '.agents/skills'
$destination = Join-Path $skillRoot 'html-prototype'
if (Test-Path -LiteralPath $destination) { throw 'html-prototype already exists' }
New-Item -ItemType Directory -Path $skillRoot -Force -ErrorAction Stop | Out-Null
Copy-Item -LiteralPath './html-prototype' -Destination $destination -Recurse -ErrorAction Stop

**macOS / Linux / WSL**

skill_root=".agents/skills"
destination="$skill_root/html-prototype"
if [ -e "$destination" ] || [ -L "$destination" ]; then
  printf '%s\n' 'html-prototype already exists' >&2
else
  mkdir -p "$skill_root" && cp -R ./html-prototype "$destination"
fi

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 86 lines
  1. # HTML Prototype Skill
  2. [![Verify skill](https://github.com/osborn001/html-prototype-skill/actions/workflows/verify.yml/badge.svg)](https://github.com/osborn001/html-prototype-skill/actions/workflows/verify.yml)
  3. [English guide](README.en.md)
  4. 把需求做成**可点击、可离线打开的单文件 HTML 产品原型**。这个 Skill 遵循 [Agent Skills 开放规范](https://agentskills.io/specification),适用于支持该格式的 Agent。同一个 Skill 覆盖截图测量、可编辑页面还原、交互实现和浏览器验收,按需读取参考和运行脚本。业务规则由用户或原页面提供。
  5. | 任务 | 产出 |
  6. |---|---|
  7. | 从截图还原 | 确定尺寸和视口,测量锚点,用真实 HTML 和 CSS 重建页面 |
  8. | 从需求做新原型 | 用户能从入口走到结果,关键状态可触发 |
  9. | 在原页面上做局部迭代 | 先还原或复用原页面,再加功能。同视口检查原图、基线稿与迭代稿 |
  10. | 验收现有原型 | 验证保存、回显、取消和数据联动,核对单文件离线交付 |
  11. ## 安装
  12. ### 用 Skills CLI 安装
  13. 在工作项目里运行以下命令,选择正在使用的 Agent。需要 Node.js 22.20 或以上版本。默认装到当前项目,追加 `-g` 可安装到用户范围。[Skills CLI 安装文档](https://github.com/vercel-labs/skills#install-a-skill)
  14. ```sh
  15. npx skills add osborn001/html-prototype-skill --skill html-prototype
  16. ```
  17. 若工具自动选中了其他客户端,可追加 `--agent codex`、`--agent claude-code`、`--agent cursor` 或 `--agent opencode`。
  18. ### 手动安装
  19. 下载仓库 ZIP 并解压。把整个 `html-prototype/` 文件夹复制到客户端的 Skills 目录,确认最终结构是 `skills/html-prototype/SKILL.md`。已有同名版本时先备份,再替换整个目录。
  20. | 客户端 | 项目目录 | 用户目录 |
  21. |---|---|---|
  22. | Codex | `.agents/skills/` | `~/.agents/skills/` |
  23. | Claude Code | `.claude/skills/` | `~/.claude/skills/` |
  24. | Cursor | `.agents/skills/` | `~/.agents/skills/` |
  25. | OpenCode | `.agents/skills/` | `~/.agents/skills/` |
  26. | 其他兼容 Agent | 以客户端支持的 Skills 目录为准 | 以客户端支持的 Skills 目录为准 |
  27. `~` 代表运行 Agent 的用户目录。在 Windows 原生客户端或 WSL 里使用时,分别按对应环境的用户目录安装。[Codex](https://learn.chatgpt.com/docs/build-skills#where-codex-loads-local-skills) · [Claude Code](https://code.claude.com/docs/en/skills#choose-where-skills-load) · [Cursor](https://cursor.com/docs/skills#skill-directories) · [OpenCode](https://opencode.ai/docs/skills/#discovery)
  28. 以下命令假定当前目录下有解压得到的 `html-prototype/`。要装到另一个项目,可在目标项目中执行,并把源路径换成解压后该文件夹的绝对路径。Claude Code 把命令里的 `.agents/skills` 改成 `.claude/skills`。
  29. **Windows PowerShell**
  30. ```powershell
  31. $skillRoot = '.agents/skills'
  32. $destination = Join-Path $skillRoot 'html-prototype'
  33. if (Test-Path -LiteralPath $destination) { throw 'html-prototype already exists' }
  34. New-Item -ItemType Directory -Path $skillRoot -Force -ErrorAction Stop | Out-Null
  35. Copy-Item -LiteralPath './html-prototype' -Destination $destination -Recurse -ErrorAction Stop
  36. ```
  37. **macOS / Linux / WSL**
  38. ```sh
  39. skill_root=".agents/skills"
  40. destination="$skill_root/html-prototype"
  41. if [ -e "$destination" ] || [ -L "$destination" ]; then
  42. printf '%s\n' 'html-prototype already exists' >&2
  43. else
  44. mkdir -p "$skill_root" && cp -R ./html-prototype "$destination"
  45. fi
  46. ```
  47. ## 试一次
  48. 在 Agent 里通过技能选择器选中 `html-prototype`,或直接在提示中点名。Codex 可输入 `$html-prototype`,Claude Code 可输入 `/html-prototype`。仅支持读取项目文件的 Agent,也可直接请它阅读 `html-prototype/SKILL.md` 并按其中的流程执行。
  49. > 使用 html-prototype 做一份社区工坊预约原型。管理员可以分别设置木工室和陶艺室的预约提示,访客只看到选中房间启用后的提示。演示保存、取消、停用与分房间生效,交付能离线打开的单文件 HTML。
  50. [示例需求与验收步骤](examples/README.md) · [示例 HTML 源文件](examples/workshop-booking.html)
  51. ![虚构社区工坊预约原型的桌面管理界面](examples/workshop-preview.png)
  52. ## 本地验证
  53. Skill 自带可选验证脚本。Agent 也可以直接使用所在客户端的浏览器工具。
  54. | 工具 | 检查内容 |
  55. |---|---|
  56. | [静态资源检查](html-prototype/scripts/check_offline.py) | 查找常见的外链脚本、相对图片、字体和样式依赖 |
  57. | [离线浏览器检查](html-prototype/scripts/verify_browser.cjs) | 在隔离目录按指定视口打开,截图、测量位置、检查请求与错误,并运行操作断言 |
  58. | [图片差异检查](html-prototype/scripts/compare_images.py) | 对比同尺寸截图,排除明确的改动区域并量化其余差异 |
  59. [按参数复跑截图、交互和差异检查](html-prototype/references/verification.md) · [运行公开样例](examples/README.md)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.