Skip to main content
skill CX Codex

design-html — Claude Code skill: mockup to HTML/CSS with Pretext

design-html turns a design mockup into production HTML/CSS. Works from /design-shotgun output, a plan, or a freeform brief.

MIT 215 installs ★ 35 updated 2026-10-21

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add podo/design-agent-skills --skill design-html -a claude-code
Open on GitHub

What design-html does

Part of Garry Tan's gstack: takes an approved mockup (from /design-shotgun), a plan, or a text brief and generates HTML/CSS using Pretext. Text reflows on resize rather than staying fixed. Runs a live-preview loop with verification screenshots, extracts design tokens at the end.

Installs as part of gstack — the skill calls shared gstack tooling from ~/.claude/skills/gstack/bin/. The ./setup script builds binaries, downloads Chromium (~185 MB), and registers a Stop hook in Claude settings. Requires Bun. If you want instructions only without gstack binaries, install via npx skills add garrytan/gstack --full-depth --skill design-html.

What it helps with

  • turn a mockup into adaptive HTML/CSS
  • finalize code from a design, plan, or brief
  • run a live-preview refinement loop with screenshots
  • extract design tokens from finalized markup

Example prompts for the agent

  • Build HTML from the mockup that /design-shotgun produced
  • Code the page from the plan in brief.md
  • Implement the design with live preview

How to install design-html

1Skills CLI (Vercel)

npx skills add podo/design-agent-skills --skill design-html -a claude-code

2Manually: put the files in place

~/.claude/skills/design-html/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/design-html/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about design-html

How to install design-html in Claude Code?

The skill is part of gstack; install the whole repository: git clone --single-branch --depth=1 https://github.com/garrytan/gstack.git ~/.claude/skills/gstack, then cd ~/.claude/skills/gstack && ./setup.

What does design-html do?

Turns a design mockup (from /design-shotgun, a plan, or a brief) into production HTML/CSS using Pretext. Text reflows on resize. The skill runs a live-preview loop with verification screenshots and extracts design tokens.

What does design-html require?

Bun and Claude Code. The skill calls shared gstack tooling from ~/.claude/skills/gstack/bin/, so it installs as part of gstack rather than as a standalone skill.

Source text

SKILL.md · MIT
---
name: design-html
description: |
  Finalize a design as production-ready HTML/CSS. Garry Tan's gstack
  design-html skill generates Pretext-native HTML/CSS (computed text layout,
  so text reflows and heights adjust on resize) from an approved mockup, a
  plan, or a freeform brief.
triggers:
  - "design html"
  - "design to HTML"
  - "implement design"
  - "mockup to code"
  - "HTML from design"
  - "production HTML"
das:
  category: figma-code
  upstream: "https://github.com/garrytan/gstack"
  upstream_path: "design-html/SKILL.md"
  version: latest
  install: false
---

# design-html

> Catalogue stub — part of [garrytan/gstack](https://github.com/garrytan/gstack) (`design-html`)

<!-- das:install:start — generated from stub.yaml by `npm run generate`; edit stub.yaml, not this block -->
## Decision tree

1. **Is the full skill already installed?**
   - `f=~/.claude/skills/gstack/design-html/SKILL.md; [ -e "$f" ] && ! grep -qs "^das:" "$f" && echo "installed" || echo "pointer"`
   - `installed` → invoke it and proceed
   - `pointer` → go to step 2

2. **Install** (the skills CLI cannot install this one):

   This skill is part of gstack and calls gstack's shared tooling (`~/.claude/skills/gstack/bin/…`), so install gstack itself rather than the single skill. `./setup` needs Bun, builds binaries, downloads Chromium and registers a Stop hook in your Claude settings; ask the user before running it.

   ```bash
   git clone --single-branch --depth=1 https://github.com/garrytan/gstack.git ~/.claude/skills/gstack
   cd ~/.claude/skills/gstack && ./setup
   ```

**Heads-up**

- **Requires:** Bun; Claude Code
- **License:** MIT
- **Large download (~185 MB):** the skills CLI gives up cloning after 300 s; if it times out, retry with `SKILLS_CLONE_TIMEOUT_MS=900000`.
<!-- das:install:end -->

## Invoke after install

- Skill name: `design-html` (upstream's own phrases: "build the design", "code the mockup", "make design real")
- Trigger phrases: "design html", "design to HTML", "implement design", "mockup to code"
- It works best after gstack's `/design-shotgun` has produced an approved mockup; it can also work from a plan or a freeform brief
- Lighter, degraded alternative (instructions only, without gstack's `bin/` helpers): `npx skills add garrytan/gstack --full-depth --skill design-html`

## What it does

Part of Garry Tan's gstack: turns an approved design into finalized, production-quality HTML/CSS. Its engine is Pretext, so text layout is computed rather than approximated and text reflows on resize. It detects its input (an approved mockup from `/design-shotgun`, a plan, a freeform brief, or an earlier output to evolve), analyses the design, generates the HTML (vanilla or for the detected framework), runs a live-preview refinement loop with verification screenshots, and extracts design tokens at the end. Figma is not a documented input, and the skill relies on gstack's shared tooling and workflow.

## When NOT to use

- A Figma file or spec is the source of truth → use `figma-official-skills`
- You are still defining the visual language and design system → use `design-consultation`
- You want a design review of a plan or live UI before building → use `plan-design-review` or `design-review-garrytan`

© podo · MIT · podo/design-agent-skills

Similar skills

All skills for Frontend and UI →

From the same set108

The whole set →
guizang-ppt guizang-ppt turns an article, outline, or Markdown file into a single HTML web deck. Use it for swipe navigation, presenter notes, and rehearsal screens. CX Codex +1 217installs claudedesignskills claudedesignskills — a collection of 22 skills covering WebGL, 3D graphics, and motion libraries from Three.js to Rive. Useful for complex creative frontend workflows. CX Codex +1 216installs design-engineering-catalogue design-engineering-catalogue — a guide to skills for visual design, mobile interfaces, typography, and components. Use it to find a tool that matches a design task. CX Codex +1 215installs accessibility-agents accessibility-agents is a Claude Code skill that routes accessibility checks to specialists and combines findings in a WCAG 2.2 AA report. CX Codex +1 215installs tui-design-skill The tui-design-skill skill designs and reviews terminal UIs and CLIs for Go, Rust, Python, and TypeScript. Use it when an interface needs clear navigation and interaction. CX Codex +1 215installs humanize-text humanize-text grades a piece of writing on seven scales from 1 to 10 and returns a rewritten version without the usual AI tells. CX Codex +1 214installs p5js-hermes p5js-hermes is a Claude Code skill for creating generative and interactive p5.js visuals with noise, particles, flow fields and shaders, and exporting sketches to PNG, GIF or MP4. CX Codex +1 214installs open-design open-design is a Claude Code skill with a local daemon, web UI, and MCP server for generating prototypes, landing pages, dashboards, and other design assets through a coding agent. CX Codex +1 214installs

Project sponsors

Companies that keep this analytics open