DESIGN.md is a structured markdown file that defines your project's brand spec — tokens (colors, typography, spacing, radius), voice, narrative, principles, personas, states, and motion. AI coding agents (Claude Code, Codex, OpenCode, Cursor) read it as authoritative context before generating any UI, so the output looks like your brand instead of generic 'modern minimalist' slop.

How does oh-my-design work?

Run `npx oh-my-design-cli install-skills` once in your project. It installs 17 skills (core flow + live-capture + asset + the v0.2 agent layer: orchestrator, kr-writer, locale-adapter, designer-review, final-qa, codex-image), 16 sub-agents (master orchestrator + 15 specialists), 4 hooks, and 221 reference DESIGN.md files. After restarting your AI coding agent, you just talk in natural language — skills route to the right sub-agents automatically.

Does it call any AI provider during install?

No. The install is a pure markdown copy — zero API calls, zero data leaves your machine. Your AI coding agent (Claude Code, Codex, OpenCode, or Cursor) is the inference layer; install just teaches it where to look.

Which AI coding agents are supported?

Claude Code, Codex, OpenCode, and Cursor — Cursor has a dedicated install channel (--agent cursor) that writes the .cursor/rules shim plus the shared reference catalog. The skill markdown files are agent-agnostic; hooks ship for Claude Code specifically.

What is the design harness?

The omd-harness skill runs a 10-phase design pipeline (Discovery → Research → IA → Wireframes → Design system → Components → Asset sourcing → Microcopy → Validation → Handoff). It dispatches sub-agents in parallel where independent, asks 3 mandatory user checkpoints, and emits a v0/Cursor-ready package. Trigger it by saying things like 'design the entire onboarding from scratch' or '/omd-harness '.

Yes — MIT licensed, open source, no signup, no API key, no paid tier. The references in the bundle belong to their respective companies and are reproduced for educational reference only.

DESIGN.md · brand DNA for AI agents

Generate DESIGN.md
from 221 real company design systems.

One DESIGN.md spec. 221 real brands extracted. Any AI coding agent (Claude Code, Cursor, Codex, OpenCode) ships UI that actually looks like Stripe, Toss, Linear — not slop. Free, MIT, zero AI calls during install.

$npx oh-my-design-cli install-skills

Open Builder Star on GitHub

references/toss/DESIGN.md

# DESIGN.md

## Brand: Toss

primary: #3182f6

radius: 8px

weight.heading: 700

## Voice

솔직하고 다정하게,

금융용어 없이.

## Forbidden

- Get Started

- Click here

- Submit

auto · brand cycle

Live proof

Same prompt. Five brands. One file decides.

Prompt

build me a hero card for the landing

↓ DESIGN.md context loaded: Stripe

Stripe

Built for scale

Move money for businesses around the world. From day one.

Toss

송금, 더 쉽게

복잡한 절차 없이 3초 안에 보내세요.

Linear

Issue tracking, finally fast

Built for high-velocity software teams.

Notion

Your wiki, docs & projects. Together.

One workspace. Every team.

Vercel

Ship. Then iterate.

The frontend cloud for builders.

DESIGN.md → Stripe: voice: clear, technical, confidence-led

The wall

221 systems. All real. All extracted.

Every tile is a real brand with a full DESIGN.md your AI agent can read — browse them all in the catalog.

11st

17live

29cm

3o3

91app

abema

ably

accupass

adobe

airbnb

airtable

alipay

amazingtalker

appier

apple

baemin

banksalad

bilibili

bithumb

bmw

brandi

bunjang

cakeresume

cal

catchtable

cathay

channeltalk

class101

classting

classum

claude

clay

clickhouse

cloudflare

cohere

coinbase

coinone

composio

cookpad

coupang

cursor

dabang

danawa

dcard

dell

devsisters

discord

dji

drnow

dropbox

duolingo

elevenlabs

expo

fastcampus

ferrari

figma

finda

firstory

flex

flo

framer

freee

fugle

funnow

gangnamunni

genie

github

gmarket

gogolook

gogoro

google

greenvines

greeting

grip

hahow

hashicorp

hogangnono

hyperconnect

hyundaicard

ibm

ichef

ikala

imweb

inflearn

intercom

jandi

jkopay

jobkorea

jumpit

kakao

kakaobank

kakaopay

kakaot

karrot

kbank

kdan

kintone

kkbox

kkday

kmong

krafton

kraken

krds

kream

kurly

laftel

lamborghini

laundrygo

layerx

lezhin

line

linear.app

loom

lovable

lunit

mastercard

meituan

melon

mercari

mercury

What an agent ships without vs with DESIGN.md

Same prompt to the same model. The only difference: one read yourDESIGN.mdfirst.

Without DESIGN.mdPrimary CTA

Generic Tailwind defaults · stock voice · zero brand recognition.

→

With · TossPrimary CTA

voice ·솔직하고 다정하게

§01 Toss Voice §10 — 솔직하고 다정하게, 금융용어 없이. Forbidden: 'Get Started'.

Without DESIGN.mdEmpty state

No data available.

Generic Tailwind defaults · stock voice · zero brand recognition.

→

With · AnthropicEmpty state

Nothing here yet — and that's a good place to begin.

Tell Claude what you want this page to feel like.

voice ·warm, literary, human-first

§02 Anthropic Voice §10 — warm, human, literary. Empty isn't empty — it's a doorway.

Without DESIGN.mdError toast

Error 500: Internal Server Error

Generic Tailwind defaults · stock voice · zero brand recognition.

→

With · LinearError toast

Sync paused — we'll retry in 4 seconds.⌘.

voice ·precise, unhurried

§03 Linear Voice §10 — precise, no panic, builder-to-builder. Mono numerals, no exclamation marks.

Without DESIGN.mdAuth form

Generic Tailwind defaults · stock voice · zero brand recognition.

→

With · VercelAuth form

Continue with Vercel

voice ·ship, then iterate

§04 Vercel Voice §10 — minimal, primitive-first. Text size shrinks. Buttons are pills.

CLI

One install. Every AI coding agent sees the same brand.

That's the only command you'll run. After that, you just talk to your agent.

Read the docs

~/project

$ npx oh-my-design-cli install-skills

✓ Installed 17 skills + 16 sub-agents

✓ Wrote .claude/skills, .agents/skills, .opencode/skills, .cursor/rules

✓ Bundled 221 reference DESIGN.md files

✓ Hooked CLAUDE.md, AGENTS.md, .cursor/rules

Restart your agent. Then just talk: “Set up the design system for a calm B2B fintech dashboard.”

Tokens get you halfway. Voice takes you home.

Every reference ships with a full brand-philosophy layer — Voice · Narrative · Principles · Personas · States · Motion.

Move your cursor

Open source · MIT · zero AI calls

Help shape oh-my-design.

No signup, no API key, no cost — but every brand we add, every bug we squash, comes from someone like you reaching out.

Open the Builder Star on GitHub

$npx oh-my-design-cli install-skills

or read the docs

Or reach out directly

Tell us what to build next

Open

Request a brand

Want your favorite DS extracted?

Open

Special thanks

Say hi · share what you shipped

Open

Generate DESIGN.mdfrom 221 real company design systems.

Same prompt. Five brands. One file decides.

221 systems. All real. All extracted.

What an agent ships without vs with DESIGN.md

One install. Every AI coding agent sees the same brand.

Tokens get you halfway. Voice takes you home.

Help shape oh-my-design.

Generate DESIGN.md
from 221 real company design systems.