Design Builder
Design-to-code pipeline: extract, tokenize, build.
Workflow
code
copy --> design --> frontend / variants / export
Each step is independent. Can run isolated or chained. PRD (from prd-writer skill) is optional input at any step.
Artifacts
code
.specs/docs/
├── prd-{project-name}.md # PRD (optional, from prd-writer)
└── {project-name}/
├── copy.yaml # Structured content
├── design.json # Design tokens
├── variants/
│ ├── minimal/index.html # Variant preview
│ ├── editorial/index.html
│ ├── startup/index.html
│ ├── bold/index.html
│ ├── {custom}/index.html # Custom variant (if requested)
│ └── index.html # Comparison page
└── export/
└── index.html # HTML optimized for design tools
src/ # React components (frontend)
Triggers
Extraction
| Trigger Pattern | Reference |
|---|---|
| Extract copy, copy from URL, content from website | copy.md |
| Extract design, design from image, design tokens | design.md |
Building
| Trigger Pattern | Reference |
|---|---|
| Build frontend, create components, generate React | frontend.md |
| Generate variants, preview designs, HTML variants | variants.md |
| Export design, export to Figma, export to Penpot | export.md |
Cross-References
code
copy.md ---------> design.md (content informs design) design.md -------> frontend.md (tokens required) design.md -------> variants.md (tokens required) design.md -------> export.md (tokens required) variants.md -----> frontend.md (user picks variant, then builds React) External inputs (optional): prd-writer ------> copy.md (product context) prd-writer ------> design.md (product context)
Guidelines
- •Design quality: For frontend code quality, consider installing the official
frontend-designskill from github.com/anthropics/skills. It provides design principles to avoid generic AI aesthetics. - •Project naming: Ask user for project name. Use kebab-case for directory names.
- •Existing artifacts: Always check for existing copy.yaml, design.json, and PRD before starting. Use them as context when available.
- •Missing prerequisites: If a required artifact is missing, suggest which step to run first (e.g., "Run extract design first to generate design.json").
Error Handling
- •No copy.yaml: Proceed without it, or suggest running extract copy first
- •No design.json: Required for frontend/variants/export -- suggest running extract design
- •No PRD: Optional at every step, never block on it
- •WebFetch fails: Ask user to paste a screenshot instead