Hacker News

Claude Design System Prompt

Comments

Reverse-engineered system prompt of Claude Design from Anthropic. A system prompt and skill library that turns an LLM into an opinionated, accessibility-aware, AI-slop-resistant design collaborator. Open source, MIT licensed.

Drop the prompt into any LLM that supports system prompts (Claude, GPT, Gemini, local models) and pair with the procedural skills as needed.

Most "design assistant" prompts produce generic SaaS-template output - aggressive gradients, emoji decoration, rounded-corner-with-left-border cards, Inter-everywhere typography. This prompt explicitly rejects those patterns and replaces them with a complete design philosophy covering:

  • Content discipline (no filler - every element earns its place)
  • Aesthetic discipline (avoid AI tropes, commit to a palette and tone)
  • Visual hierarchy and rhythm (size, color, weight, position, density, spacing scales)
  • Accessibility (WCAG, semantic HTML, keyboard navigation, focus rings, motion preferences)
  • Interaction and feedback (hover, active, disabled, focus, loading, validation states)
  • System thinking (components and tokens over one-off pages)
  • Respecting the medium (real CSS Grid, oklch(), text-wrap: pretty, real interactive prototypes)
  • Quality over quantity (depth over breadth, polish every detail)

Plus 14 procedural skills the agent can invoke for production, extraction, and review work.

Repository Structure

claude-design-system-prompt/
โ”œโ”€โ”€ claude/                          Claude Code / Claude.ai variant
โ”‚   โ”œโ”€โ”€ system-prompt.md             Main system prompt - 20 chapters
โ”‚   โ””โ”€โ”€ skills/                      14 invokable skills
โ”‚       โ”œโ”€โ”€ discovery-questions.md           Kickoff question protocol
โ”‚       โ”œโ”€โ”€ frontend-aesthetic-direction.md  Commit to a look when no brand exists
โ”‚       โ”œโ”€โ”€ wireframe.md                     Low-fi exploration, 3+ variations
โ”‚       โ”œโ”€โ”€ make-a-deck.md                   Slide presentations in HTML
โ”‚       โ”œโ”€โ”€ make-a-prototype.md              Interactive clickable prototype
โ”‚       โ”œโ”€โ”€ make-tweakable.md                Floating tweak panel
โ”‚       โ”œโ”€โ”€ generate-variations.md           3+ hi-fi variations across axes
โ”‚       โ”œโ”€โ”€ design-system-extract.md         Pull tokens from sources
โ”‚       โ”œโ”€โ”€ component-extract.md             Inventory reusable components
โ”‚       โ”œโ”€โ”€ accessibility-audit.md           WCAG, semantic, keyboard, motion
โ”‚       โ”œโ”€โ”€ ai-slop-check.md                 Gradient / emoji / font / house-style trope detection
โ”‚       โ”œโ”€โ”€ hierarchy-rhythm-review.md       Size / weight / color + spacing scale
โ”‚       โ”œโ”€โ”€ interaction-states-pass.md       Hover / active / disabled / focus / loading
โ”‚       โ””โ”€โ”€ polish-pass.md                   Umbrella final-gate review
โ”œโ”€โ”€ codex/                            OpenAI Codex variant (single-loop, no subagents)
โ”‚   โ”œโ”€โ”€ AGENTS.md                     Codex auto-discovered entry point
โ”‚   โ”œโ”€โ”€ system-prompt.md              Same prompt, adapted for Codex
โ”‚   โ””โ”€โ”€ skills/                       Same skills, sequential reviews instead of parallel agents
โ”œโ”€โ”€ README.md
โ””โ”€โ”€ LICENSE                           MIT

Usage

Paste the contents of system-prompt.md as the system prompt for any LLM that supports them. The agent will follow the design philosophy and reference the skills by name when tasks match.

Each skill in skills/ is a self-contained, phased procedure. The skill name is the trigger - when the user's request matches a skill description, the agent loads that skill and follows it.

Skill Categories

Skills group into three categories:

Production - build something
discovery-questions ยท frontend-aesthetic-direction ยท wireframe ยท make-a-deck ยท make-a-prototype ยท make-tweakable ยท generate-variations

System - extract structure
design-system-extract ยท component-extract

Review - audit and fix
accessibility-audit ยท ai-slop-check ยท hierarchy-rhythm-review ยท interaction-states-pass ยท polish-pass

Chaining Skills

Skills can be chained. A typical greenfield flow: discovery-questions โ†’ frontend-aesthetic-direction โ†’ wireframe โ†’ make-a-prototype โ†’ polish-pass

A brand-aware flow: design-system-extract โ†’ generate-variations โ†’ make-tweakable โ†’ polish-pass

Environment Notes

The prompt assumes an HTML-output design environment (similar to Claude.ai's design tool). If your target environment is different - a Figma plugin, a code-only assistant, a chat-only design coach - you'll need to adjust the workflow chapters and tool references. The principles (chapters 5โ€“16) translate to any medium.

The claude/ variant is calibrated for current Anthropic frontier models (Fable 5 and the Opus 4.7/4.8 lineage), which follow instructions more literally and need less aggressive prompting than earlier generations:

  • Conditions instead of quotas. No "ask at least N questions", no "CRITICAL: YOU MUST". Current models treat quotas as literal contracts and over-trigger on them; the prompt states the conditions under which to act, plus an autonomy clause for minor decisions (pick a reasonable option and note it, rather than asking).
  • Explicit triggers for skills and subagents. These models under-reach for optional capabilities by default, so every skill description states when to invoke it, and verifier delegation has an explicit trigger ("after every substantive visual change").
  • Coverage-first reviews. Review agents report everything with confidence/severity estimates and let the aggregation step filter. Current models follow "only report important issues" literally, which silently suppresses findings.
  • House-style guard. The current models' default aesthetic (cream background, serif display type, terracotta/amber accents) is detected by ai-slop-check (rule 9) and pre-empted by frontend-aesthetic-direction's four-directions protocol. Sampling parameters (temperature) no longer exist on these models, so visual variety must come from explicit per-variation specs, not randomness.

On older models (Claude Opus/Sonnet 4.6 and earlier, or non-Anthropic models), the calmer phrasing may under-trigger - restore stronger imperative language if you see the model skipping question rounds or reviews. The codex/ variant is maintained separately and is unaffected by these notes.

Prompt Chapters

The 20 chapters in system-prompt.md cover:

# Chapter
1 Identity and role
2 Workflow
3 Asking questions first
4 Rooting designs in existing context
5 Content principles - no filler
6 Aesthetic principles - purposeful visuals
7 Visual hierarchy and rhythm
8 Typography system
9 Color system
10 Accessibility and inclusivity
11 Interaction and feedback
12 Simplicity and one clear CTA
13 System thinking
14 Respecting the medium
15 Understanding users
16 Quality over quantity
17 Output principles
18 Collaboration and delivery
19 IP and content boundaries
20 Available skills

Contributing

Issues and PRs welcome. Particularly useful contributions:

  • Additional review skills (e.g., copy review, motion review, dark-mode parity check)
  • Adapted prompts for other environments (Figma, code-only, terminal-only)
  • Real-world failure cases the prompt should defend against
  • Translations of the prompt into other languages

Please keep the same operational tone and avoid bloating the prompt - every chapter should earn its place, the same standard the prompt holds the agent to.

License

MIT - see LICENSE. You can use, modify, and distribute this prompt and skill library for any purpose, including commercial use. No attribution required, but appreciated.

Comments

No comments yet. Start the discussion.