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 15 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 100+ 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 (via .cursor/rules). 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 50+ real company design systems.

One DESIGN.md spec. 108 real brands extracted. Your AI agent (Claude Code, Codex, OpenCode, Cursor) 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

Browse the 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

100+ systems. All real. All extracted.

Move your cursor across the wall. Click any tile to immerse in that brand and read the DESIGN.md excerpt your AI agent uses.

Logos belong to their respective companies. Reproduced for educational reference only.

Same prompt · Different brain

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. Claude Code, Codex, OpenCode, Cursor all see 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 15 skills + 16 sub-agents

✓ Wrote .claude/skills, .codex/skills, .opencode/agents

✓ Bundled 108 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 50+ real company design systems.

Same prompt. Five brands. One file decides.

100+ systems. All real. All extracted.

What an agent ships without vs with DESIGN.md

One install. Claude Code, Codex, OpenCode, Cursor all see the same brand.

Tokens get you halfway. Voice takes you home.

Help shape oh-my-design.

Generate DESIGN.md
from 50+ real company design systems.