ui-prototype

A process for creating a UI prototype: a visual mock-up of a proposed interface change placed inside the product's existing page and navigation context.

In plain words
What is it for?
Use it to show proposed UI changes with mock data and simulated interactions, without connecting to real services or changing the product.
Why use it?
It lets users and developers agree on the intended layout and interaction before production frontend code is written.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/buildrai/buildr/ui-prototype
Any agent
npx skills add BuildrAI/Buildr --skill ui-prototype
Clone the repo
git clone --depth 1 https://github.com/BuildrAI/Buildr

Made for: Claude Code, Codex.

Per session 56 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,319 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00056 $0.01319
Opus 5 $0.00028 $0.00660
Sonnet 5 $0.00011 $0.00264
Haiku 4.5 $0.00006 $0.00132

Measured 3d ago against content hash 521c0dcf92c3, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

ui-prototype scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

projects/product/services/buildr/resources/workspace/skills/buildr/ui-prototype/SKILL.md · 77 lines

How it starts

The opening of the file, as written. The whole thing — 77 lines — stays where its author put it; the contents beside it link to each section on GitHub.

UI Prototype

本 Skill 只生成“界面原型(UI Prototype)”:它把当前提案或设计中的 UI 变化放回系统现有完整页面中,供用户、设计师和后续 Agent 在正式开发前对齐预期。

它不是正式设计稿、生产原型、像素级验收标准、Planning Identity、canonical spec 或 Task Verification evidence,也不在真实前端工程中实现编码式原型。正式行为与验收继续由 specs、design、项目实现和正式验证事实决定。

1. 确认执行前提

只有当前对话中存在用户对本次任务“需要 UI Prototype”的明确确认,才继续执行。拒绝、没有回答、只说继续任务或历史任务曾经需要原型都不构成确认;此时返回 not-requested,不创建占位文件、不写 waiver/Result/Receipt,也不阻塞原任务。

读取当前 Task 的 intent、Project/Service scope、关联 Change,以及适用的 proposal、design、delta specs 和 current knowledge。正式 Task 需要在 Buildr Web 中展示时,必须已有 Task 关联 OpenSpec Change;文件写入该 Change 内由当前任务决定的目录。不得为原型新增 Task Record 字段、数据库状态、descriptor/schema、CLI 或固定目录。

2. 调查现有真实界面

先建立与本次变化直接相关的现有 UI 事实:

  • 读取 Project/Service AGENTS.md 与前端运行、构建和验证说明;
  • 查找真实页面入口、route、组件树、布局、样式 token、组件库、文案和交互;
  • 按需要启动或复用现有前端,在浏览器中查看目标页面及其完整上下文;
  • 记录本次变化会保留、移动、增加或替换的页面内容,以及必须覆盖的关键状态。

不要把调查笔记放进原型页面。若页面、运行环境或必要 UI 事实不可访问,先向用户说明缺失事实和影响,停止生成;不得凭空声称延续了现有产品。

3. 确定最小原型范围

按当前方案选择真正需要展示的页面和状态,不固定文件数量、目录或状态切换方式。只修改一个模块时,也必须把它放回现有导航、页面框架、相邻模块和真实信息层级中,交付修改后的完整页面,不能只交付孤立组件。

核心流程可以由一个页面和本地状态切换完整表达时生成一个页面;流程跨越多个页面、且不能由单页可靠表达时,必须生成多个原型页面。使用静态/mock 数据,不连接真实后端,不读取 secret,不执行真实写入。原型中的按钮、筛选、Tab、弹层或状态切换可以用本地 JavaScript 模拟关键交互。

4. 生成自包含 HTML

每个页面必须:

  • 是含 <!doctype html><html><head>、用户可读 <title><body> 的完整 HTML;
  • 在文件中包含精确发现标记 <!-- buildr:ui-prototype -->
  • 将必要 CSS 与 JavaScript 内联,将图片、字体和媒体限制为内联或 data: / blob: 资源;
  • 不引用 CDN、远程脚本、远程字体、远程 API 或机器绝对路径;
  • 延续调查所得的信息架构、页面框架、视觉语言、组件习惯和交互方式;
  • 清楚表达必要的 loading、empty、error、disabled 或其他关键状态,但不虚构与提案无关的平台能力。

后续 Agent 可直接读取完整文件。不要把截图替代为交付物,也不要把调查事实、测试日志或解释文案覆盖在页面上。

5. 浏览器验证

使用当前 runtime 可用的浏览器能力逐一打开每个 HTML 文件:

  1. 确认完整页面可见,没有依赖外部资源才能成立的缺口;
  2. 操作本次提案的核心交互与关键状态;
  3. 检查常用桌面 viewport;任务明确涉及窄屏时再检查对应 viewport;
  4. 发现问题时修正 HTML 并重新验证。

没有浏览器能力或部分核心状态无法验证时,必须明确报告未验证范围,不能描述为已完整验证。不要用源代码检查或静态截图冒充浏览器交互验证。

6. 返回结果

返回:

status: generated | blocked | not-requested
task: <task-id or none>
change: <project/change or none>
files: <portable paths or none>
pagesAndStates: <每个文件覆盖的页面、交互和状态>
browserVerification: <浏览器、viewport、已验证交互>
unverified: <none or explicit gaps>
referenceBoundary: 非正式设计、非生产原型、非像素级验收

Read the full file on GitHub · 77 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 77 lines · 56 tokens per session scan A 521c0dcf92c3

Subscribe to this mod's changes

ui-prototype is a skill published in the GitHub repository BuildrAI/Buildr (24 stars, last pushed 3d ago), licensed MIT. It adds 56 tokens to every session and 1,319 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

systematic-debugging

Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes.

obra/superpowers · 21 tokens

brainstorming

You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation.

obra/superpowers · 37 tokens

auto-perf-optimize

Run agent-driven VS Code performance or memory investigations. Use when asked to launch Code OSS, automate a VS Code scenario, run the Chat memory smoke runner, capture renderer heap snapshots, take workflow screenshots, compare run summaries, or drive a repeatable scenario before heap-snapshot analysis.

microsoft/vscode · 62 tokens

chat-perf

Run chat perf benchmarks and memory leak checks against the local dev build or any published VS Code version. Use when investigating chat rendering regressions, validating perf-sensitive changes to chat UI, or checking for memory leaks in the chat response pipeline.

microsoft/vscode · 51 tokens

chat-pet-sprite-creation

Use when creating or changing VS Code chat pet sprite art, sprite sheets, state animations, eye treatments, Stable/Insiders variants, or pet transitions under src/vs/workbench/contrib/chat/browser/widget/media/chatPet.

microsoft/vscode · 53 tokens

cpu-profile-analysis

Analyze V8/Chrome CPU profiles (.cpuprofile) and DevTools trace files (Trace-.json). Use when: profiling performance, investigating slow functions, comparing code paths, finding bottlenecks, analyzing timeToRequest, understanding call trees from sampling profiler data, analyzing layout/paint/rendering, investigating…

microsoft/vscode · 71 tokens