| name | web-prototype |
| description | General-purpose desktop web prototype. Single self-contained HTML file built
by copying the seed `assets/template.html` and pasting section layouts from
`references/layouts.md`. Default for any landing / marketing / docs / SaaS
page when no more specific skill matches.
|
| triggers | ["prototype","mockup","landing","single page","marketing page","homepage"] |
| od | {"mode":"prototype","platform":"desktop","scenario":"design","preview":{"type":"html","entry":"index.html"},"design_system":{"requires":true,"sections":["color","typography","layout","components"]}} |
Web Prototype Skill
Produce a single, self-contained HTML prototype using the bundled seed and layout library โ not by writing CSS from scratch. The seed already encodes good defaults (typography, spacing, accent budget). Your job is to compose it.
Resource map
web-prototype/
โโโ SKILL.md โ you're reading this
โโโ assets/
โ โโโ template.html โ seed: tokens + class system + chrome (READ FIRST)
โโโ references/
โโโ layouts.md โ 8 paste-ready section skeletons
โโโ checklist.md โ P0/P1/P2 self-review
Workflow
Step 0 โ Pre-flight (do this once before writing anything)
- Read
assets/template.html end-to-end โ at minimum through the <style> block. The class inventory at the top of references/layouts.md lists every class that must be defined there; if one is missing, add it to <style> rather than re-defining it inline on every section.
- Read
references/layouts.md so you know which section skeletons exist. Don't write a section type that isn't covered โ pick the closest layout and adapt.
- Read the active DESIGN.md (already injected into your system prompt). Map its colors to the six
:root variables in the seed; don't introduce new tokens.
Step 1 โ Prepare index.html from the seed
Use assets/template.html as the seed for the canonical project file, normally index.html.
Replace the six :root variables with the active design system's tokens. Replace the page <title> and the topnav brand.
Step 2 โ Plan the section list
Pick layouts before writing copy. Default rhythms (from layouts.md):
| Page kind | Default rhythm |
|---|
| Landing | 1 hero โ 3 features โ 4 stats or 5 quote โ custom split โ 6 cta |
| Marketing / editorial | 1 hero-center โ 7 log list โ 6 cta |
| Pricing | 1 hero-center โ 8 comparison table โ 6 cta |
| Docs index | 1 hero-center โ 7 log list (sections of docs) โ 6 cta |
State the chosen list in one sentence to the user before writing โ they can redirect cheaply now and not after 200 lines of HTML.
Step 3 โ Paste and fill
For each chosen layout, copy the <section> block from layouts.md into <main id="content"> of the project HTML. Replace bracketed [REPLACE] strings with real, specific copy from the user's brief. No filler โ if a slot is empty, the section is the wrong choice; pick a different layout.
Step 4 โ Self-check
Run through references/checklist.md top to bottom. Every P0 item must pass before you move on. P1 items should pass; P2 are bonus.
Step 5 โ Write the project file
Write the completed HTML to the canonical project file, normally index.html. Then send one short ordinary assistant summary naming the file and describing what's there. Do not output the full HTML source in chat.
Hard rules (the seed protects most of these โ don't fight it)
- Single accent, used at most twice per screen. Eyebrow + primary CTA is the default budget.
- Display font is serif (Iowan Old Style / Charter / Georgia in the seed). Sans for body. Mono for numerics, captions, eyebrows.
- Image placeholders, not external URLs. Use the
.ph-img class โ never link to a stock photo CDN.
- Mobile reflow already works via the seed's media query at 920px. Don't break it by adding fixed widths.
data-od-id on every <section> so comment mode can target it.
Output contract
Filesystem runs use project files as the source of truth:
index.html
Open Design derives the preview from the written project file. Do not also emit a source-code <artifact> block for the same generation turn.
One short summary after writing the file. Nothing after.
