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.md frontmatter (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 / --accent is omitted, its *-foreground is
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 an
on-X / X role 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.
1---2name: omd-brand-look3description: |4 Repaint one screen with the measured tokens of verified real-company references (verified_v2 only),5 render it at 1440·1024·768·390 in a real browser, and report rule-by-rule PASS/FAIL with the cause of6 each FAIL. Output: per-brand themed copies, a same-screen × N-brands grid, 4:5 Threads cards and7 report.md. It never invents a value: every slot is a declared frontmatter value, an unfillable slot is8 omitted (the user's own variable stays), and fonts carry the G3 labels (brand face / substitute — not9 the brand face / safe default (not the brand face)). It does not edit the user's source, render logos,10 or bootstrap DESIGN.md (that is omd-init). MVP: the shipped sample screen only.11 트리거: "/omd-brand-look", "브랜드 룩으로 칠해 봐", "토스·당근·Linear 룩으로 비교",12 "같은 화면 다섯 브랜드", "repaint this screen in Toss / Linear / Apple look", "brand look grid".13x-omd-channels: claude-code codex opencode14metadata:15 source: https://skillmd.com/skills/kwakseongjae/omd-brand-look16 internal: true17 author: 곽성재18 version: "0.1.0"19---2021# omd-brand-look2223Design: `docs/SKILL_BRAND_LOOK_DESIGN_2026-11-09.md` (decisions D1–D8, token mapping §3, checks §4, grid §5).24Internal until the W2 launch: not in `package.json` "files", not counted on llms / cli-docs / faq.2526## What it promises, and what it does not2728- **Measured values only.** Every CSS variable it writes is a string declared in a verified_v229 reference's `DESIGN.md` frontmatter (`colors.*`, `rounded.*`, `components.*.*`, `typography.body.fontFamily`),30 with its source path in a comment (`/* colors.canvas */`). No palette steps, hover shades or tints.31- **Omit, don't fill.** A slot no declared key can fill is left out, so the screen keeps its own value; the32 omitted list is printed and counted in the grid caption. Omission can create a FAIL; that FAIL is33 reported as `mapping`, never patched with an invented value. A surface and the text copied onto it go34 together: when `--card` / `--popover` / `--secondary` / `--accent` is omitted, its `*-foreground` is35 omitted too (the reference declares its foreground for its canvas, not for a surface it never declared;36 writing half the pair drew light text on the screen's white cards for Linear).37- **verified_v2 only** (`data/reference-quality.json`). A partial or legacy id exits 3 with the reason.38- **Fonts follow G3.** Four cases, each labelled wherever the face is named or rendered: A public brand face39 (loaded as itself), B measured substitute ("substitute — not the brand face"), C OS system family per the40 reference, D no substitute ("safe default (not the brand face)", Noto Sans KR/JP/TC/SC). A private brand41 face is referenced by name only, never bundled.42- **Not a brand clone.** No logos, wordmarks, illustrations or brand copy. Company names appear only as43 caption text. No "official" / "Toss theme" wording.44- **Never edits the user's source.** Each brand gets a copy of the target with one45 `<style data-omd-brand-look>` block (`:root:root { … }`, specificity 0,2,0) before `</head>`.4647## Run4849Needs Node ≥ 18 and playwright-core (`PW_CORE=<dir containing node_modules/playwright-core>`; inside the50oh-my-design repo that is `web`). Fonts load from Google Fonts / jsDelivr / rsms.me, so the run needs network.5152```bash53# 1. tokens only (no browser): one reference -> shadcn variable block54node skills/omd-brand-look/scripts/tokens.mjs toss # --format auto|hex|hsl, --lang ko|ja|zh-TW|zh-CN|en, --json, --assign5556# 2. repaint + shoot + grid + Threads cards57PW_CORE=$PWD/web node skills/omd-brand-look/scripts/look.mjs --sample [<id> …] --out .omd/brand-look/<run-id>58# no ids = the W2 default set: toss karrot ohouse linear.app apple (owner 2026-11-09)5960# 3. checks -> report.md / report.json in the same folder61PW_CORE=$PWD/web node skills/omd-brand-look/scripts/check.mjs .omd/brand-look/<run-id>62```6364`look.mjs` options: `--widths 1440,1024,768,390`, `--lang ko`, `--card id,id,id,id,id` (repeatable; one651080×1350 card of 390px columns per set, default = all brands), `--assign` (apply the reassignment66suggestions; off by default, design doc §7 Q3).6768## Output6970```71<out>/72 run.json inputs, brands, widths, engines, reference paths + verified_at, font checks73 baseline/shots/<w>.png the sample before repainting74 <id>/tokens.css, tokens.json tokens.mjs output (labels, omitted, contrast, suggestions)75 <id>/index.html themed copy76 <id>/shots/<w>.png first viewport at each width (deviceScaleFactor 2)77 grid.html, grid.png rows = brands, columns = widths; captions are text only78 threads/01-390x<N>[-<n>].png 1080×1350 cards, the 390px column side by side79 report.md, report.json written by check.mjs80```8182## Checks (`check.mjs`)8384| | Source | Verdict |85|---|---|---|86| 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 |87| 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) |88| C3 layout | `breakCheck` spill / clip / sideways | any: FAIL |89| 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 |90| C6 font fidelity | new (CDP `CSS.getPlatformFontsForNode`) | the face that actually painted Latin and Hangul must be the one the label names |9192Every FAIL carries one cause:93- **inherited**: the reference itself declares the pair (the same `components.<x>` fill and text, or an94 `on-X` / `X` role pair, or a declared text colour on the declared canvas). brand-look reports it and95 leaves it as measured.96- **mapping**: our slot assignment made the pair, including a pair with an omitted side (the screen's own97 value kept next to a brand value).98- **layout**: C2 / C3, i.e. what the font swap did to line breaks and widths.99100A pair whose two sides are both the screen's own values (both slots omitted), or a layout fault the unthemed101screen already has, is **screen** and only a WARN.102103Fixes are only ever *suggestions* to reassign a slot to another declared colour of the same kind (danger for104`--destructive`, primary for `--primary`, canvas/surface for a surface, never the page canvas itself; rule in105`report.md`); nothing is lightened, darkened or mixed. `--assign` applies them.106107## Not in the MVP108109User HTML files and dev-server URLs (design doc L1/L2), component geometry such as the primary button's110height and pill radius (L3), restraint R3/R7 (C4), dark blocks (L5), public-font lookup by exact name (L6),111the `resolve.ts` key-list drift test (L7), `--pick 5 --task`, `--adopt`.