kwakseongjae/oh-my-design / skills/omd-brand-look
omd-brand-look
VerifiedRepaint one screen with the measured tokens of verified real-company references (verified_v2 only), render it at 1440·1024·768·390 in a real browser, and report rule-by-rule PASS/FAIL with the cause of each FAIL. Output: per-brand themed copies, a same-screen × N-brands grid, 4:5 Threads cards and report.md. It never invents a value: every slot is a declared frontmatter value, an unfillable slot is omitted (the user's own variable stays), and fonts carry the G3 labels (brand face / substitute — not the brand face / safe default (not the brand face)). It does not edit the user's source, render logos, or bootstrap DESIGN.md (that is omd-init). MVP: the shipped sample screen only. 트리거: "/omd-brand-look", "브랜드 룩으로 칠해 봐", "토스·당근·Linear 룩으로 비교", "같은 화면 다섯 브랜드", "repaint this screen in Toss / Linear / Apple look", "brand look grid".
omd-brand-look
Design: docs/SKILL_BRAND_LOOK_DESIGN_2026-11-09.md (decisions D1–D8, token mapping §3, checks §4, grid §5).
Internal until the W2 launch: not in package.json "files", not counted on llms / cli-docs / faq.
What it promises, and what it does not
- Measured values only. Every CSS variable it writes is a string declared in a verified_v2
reference's
DESIGN.mdfrontmatter (colors.*,rounded.*,components.*.*,typography.body.fontFamily), with its source path in a comment (/* colors.canvas */). No palette steps, hover shades or tints. - Omit, don't fill. A slot no declared key can fill is left out, so the screen keeps its own value; the
omitted list is printed and counted in the grid caption. Omission can create a FAIL; that FAIL is
reported as
mapping, never patched with an invented value. A surface and the text copied onto it go together: when--card/--popover/--secondary/--accentis omitted, its*-foregroundis omitted too (the reference declares its foreground for its canvas, not for a surface it never declared; writing half the pair drew light text on the screen's white cards for Linear). - verified_v2 only (
data/reference-quality.json). A partial or legacy id exits 3 with the reason. - Fonts follow G3. Four cases, each labelled wherever the face is named or rendered: A public brand face (loaded as itself), B measured substitute ("substitute — not the brand face"), C OS system family per the reference, D no substitute ("safe default (not the brand face)", Noto Sans KR/JP/TC/SC). A private brand face is referenced by name only, never bundled.
- Not a brand clone. No logos, wordmarks, illustrations or brand copy. Company names appear only as caption text. No "official" / "Toss theme" wording.
- Never edits the user's source. Each brand gets a copy of the target with one
<style data-omd-brand-look>block (:root:root { … }, specificity 0,2,0) before</head>.
Run
Needs Node ≥ 18 and playwright-core (PW_CORE=<dir containing node_modules/playwright-core>; inside the
oh-my-design repo that is web). Fonts load from Google Fonts / jsDelivr / rsms.me, so the run needs network.
# 1. tokens only (no browser): one reference -> shadcn variable block
node skills/omd-brand-look/scripts/tokens.mjs toss # --format auto|hex|hsl, --lang ko|ja|zh-TW|zh-CN|en, --json, --assign
# 2. repaint + shoot + grid + Threads cards
PW_CORE=$PWD/web node skills/omd-brand-look/scripts/look.mjs --sample [<id> …] --out .omd/brand-look/<run-id>
# no ids = the W2 default set: toss karrot ohouse linear.app apple (owner 2026-11-09)
# 3. checks -> report.md / report.json in the same folder
PW_CORE=$PWD/web node skills/omd-brand-look/scripts/check.mjs .omd/brand-look/<run-id>
look.mjs options: --widths 1440,1024,768,390, --lang ko, --card id,id,id,id,id (repeatable; one
1080×1350 card of 390px columns per set, default = all brands), --assign (apply the reassignment
suggestions; off by default, design doc §7 Q3).
Output
<out>/
run.json inputs, brands, widths, engines, reference paths + verified_at, font checks
baseline/shots/<w>.png the sample before repainting
<id>/tokens.css, tokens.json tokens.mjs output (labels, omitted, contrast, suggestions)
<id>/index.html themed copy
<id>/shots/<w>.png first viewport at each width (deviceScaleFactor 2)
grid.html, grid.png rows = brands, columns = widths; captions are text only
threads/01-390x<N>[-<n>].png 1080×1350 cards, the 390px column side by side
report.md, report.json written by check.mjs
Checks (check.mjs)
| Source | Verdict | |
|---|---|---|
| C1 contrast | test-v2/tools/text-contrast.mjs (glyph pixels vs the background under them) at all four widths | any text element with > 5% of glyph pixels under 4.5:1 (3:1 large) FAILs; focus ring 3:1 |
| C2 broken words | skills/hangul/scripts/break.mjs breakCheck (kind: broken) | in a heading, button, label or badge: FAIL; in body prose: WARN (HG-10) |
| C3 layout | breakCheck spill / clip / sideways | any: FAIL |
| C5 palette fidelity | new | every painted colour must be a mapped value or a kept (omitted-slot) value; the primary button's fill must equal --primary (FAIL), other strays WARN, alpha mixes and shadcn radius offsets are "derived" WARN |
| C6 font fidelity | new (CDP CSS.getPlatformFontsForNode) | the face that actually painted Latin and Hangul must be the one the label names |
Every FAIL carries one cause:
- inherited: the reference itself declares the pair (the same
components.<x>fill and text, or anon-X/Xrole pair, or a declared text colour on the declared canvas). brand-look reports it and leaves it as measured. - mapping: our slot assignment made the pair, including a pair with an omitted side (the screen's own value kept next to a brand value).
- layout: C2 / C3, i.e. what the font swap did to line breaks and widths.
A pair whose two sides are both the screen's own values (both slots omitted), or a layout fault the unthemed screen already has, is screen and only a WARN.
Fixes are only ever suggestions to reassign a slot to another declared colour of the same kind (danger for
--destructive, primary for --primary, canvas/surface for a surface, never the page canvas itself; rule in
report.md); nothing is lightened, darkened or mixed. --assign applies them.
Not in the MVP
User HTML files and dev-server URLs (design doc L1/L2), component geometry such as the primary button's
height and pill radius (L3), restraint R3/R7 (C4), dark blocks (L5), public-font lookup by exact name (L6),
the resolve.ts key-list drift test (L7), --pick 5 --task, --adopt.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |