skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
ryanthedev/design-for-ai62 installs

prototype

Produces self-contained HTML/CSS mockups and wireframes from design tokens and page specs — the output is always a viewable .html file, not guidance or code. Use when the request is to see a design, make a mock, build or show a prototype, create a wireframe, render a preview, or visualize what a page looks like before writing production code. Reads DESIGN.md tokens and JOURNEY.md page specs when present; uses greyscale wireframe defaults when absent. Renders via the browser MCP and returns a screenshot path when connected; emits the .html with an open note when not. Not for: choosing or defining fonts, colors, visual identity, or design tokens (use core design); critiquing, auditing, or reviewing an existing design (use core audit); planning IA, flows, or page specs (use journey); building a design token system or component library (use design-systems).

How do I install this agent skill?

npx skills add https://github.com/ryanthedev/design-for-ai --skill prototype
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The 'prototype' skill is a safe utility designed to generate HTML/CSS mockups from local design tokens and journey specifications. It utilizes a browser tool to render these local files and capture screenshots for analysis by a subagent, following established security best practices for resource management and subagent isolation.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

What does this agent skill do?

Prototype turns design tokens and page specs into a viewable artifact — a single self-contained .html file that opens in any browser with no build step.

When this applies

  • "Show me what it looks like" / "make a mock" / "build a prototype" / "render a wireframe"
  • Visualizing a page from a JOURNEY.md page spec
  • Checking token application before writing production code
  • Supplying a screenshot for the design-review-agent to critique

Procedure

1. Gather inputs

Collect three inputs:

InputSourceIf absent
TokensDESIGN.md at the project root (the CSS custom-property block from palette.mjs)Wireframe mode: greyscale defaults
Page specJOURNEY.md page spec section, or user descriptionScaffold a generic page skeleton
FidelityUser request; "wireframe" = structure only, "styled" = full tokensDefault to styled when DESIGN.md present, wireframe when not

If DESIGN.md is absent, note it and proceed in wireframe mode — emit the .html with a comment: <!-- No DESIGN.md found — wireframe mode: greyscale defaults. Run /design-for-ai to establish tokens. -->.

2. Build the mock

Load references/mock-recipe.md. Follow the recipe for the chosen fidelity:

  • Wireframe: HTML structure + CSS custom properties defaulting to greys; semantic sectioning (<header>, <main>, <nav>, <section>, <aside>, <footer>); placeholder labels ([Hero headline], [Body copy], [CTA]); no color, no imagery.
  • Styled: All DESIGN.md tokens applied to :root as CSS custom properties; type scale, color, spacing, and surface constraints from DESIGN.md honored. Webfont <link> included when DESIGN.md names one.

Both fidelities: single file, all CSS in <style>, prefers-reduced-motion media query suppressing transitions, touch targets ≥44×44px on mobile surfaces, semantic HTML.

Write the file to <project-root>/mocks/<page-name>.html (create mocks/ if needed), or to ./mock.html when no project root is clear.

3. Render and screenshot (graceful protocol)

When the browser MCP is connected:

  1. browser_connect(mode: "launch", channel: "chrome", headless: true) — or reuse existing connection.
  2. browser_navigate(url: "file://<absolute-path-to-html>", allow_internal: true) — local file render; allow_internal is required.
  3. browser_screenshot() — returns {path} (a PNG).
  4. Dispatch a Haiku subagent to read the PNG and return a text summary (payload discipline: large artifact stays out of main context).
  5. Return: the .html path, the screenshot path, and the Haiku summary.

When the browser MCP is not connected (graceful fallback):

Emit the .html path and note: "Open <path> in your browser to view — browser MCP not connected so no screenshot was captured." No error. The mock is still the deliverable.

Detection: if browser_connect fails, fall to the fallback. Never block on MCP availability.

4. Handoff

Suggest running /design-for-ai:mock (which dispatches the design-review-agent) to critique the rendered result, or build for a full gated review.

References

Reference fileLoad when
references/mock-recipe.mdBuilding any mock — the HTML/CSS recipe, token mapping, surface-constraint table, fidelity specs, and prefers-reduced-motion rule

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/ryanthedev/design-for-ai/prototype">View prototype on skillZs</a>