Design Tokens
DTCG-format JSON on a three-tier architecture, primitive, semantic, component. Colour, typography, spacing, shadows, borders, breakpoints, motion. Dark mode swaps semantics; primitives never move.
Design tokens, 50 component specs, WCAG 2.2 gates and code for any framework. A pure instruction and knowledge layer for AI agents. No build tools, no dependencies, no runtime.
Tokens, never hex codes
PRIMITIVE
SEMANTIC
COMPONENT
DTCG
TOKENS
The library
Every one of these ships as a DESIGN.md spec you can point the agent at.
Say make it feel like Linear and the tokens re-point, while accessibility holds.
Aesthetic archetypes with no address of their own, plus the handful of hosts that answer a headless browser with a consent wall instead of a homepage. Each still ships as a full spec.
and it drops into
any project.
$ npx ux-ui-agent-skills init
Installing full kit -> .
+ CLAUDE.md
+ tokens/ 13 files
+ components/ 50 specs
+ design-systems/ 138 systems
+ .claude/skills/ 17 skills
+ scripts/ the gates
Done. 259 copied, 0 skipped.
Open the folder in Claude Code, CLAUDE.md loads itself.
How to use
One command in the folder you are working in. Nothing to build, nothing to install, no runtime. The kit is instructions and knowledge, not a dependency.
$ npx ux-ui-agent-skills init
Only part of it? npx ux-ui-agent-skills add tokens taste design-systems.
Prefer a clone? git clone the repo and copy the folders you want.
There is no step to remember here. CLAUDE.md loads on its own and the agent picks up the
persona, the token rules, the eight states, the WCAG floor and the anti-slop doctrine, plus the
Request Router that pulls the right layer for the job and leaves the rest unread.
$ claude
No syntax to learn. Describe the outcome and the router loads the layers it needs.
Seventeen skills, invoked as slash commands. Six you start; eleven the agent reaches for on its own while it works.
/brandkitA whole brand foundation from a brief, tokens, light and dark, one
theme.css, WCAG-verified/redesignAudit-first upgrade of an existing UI without breaking it/image-to-codeA screenshot becomes token-driven, accessible code/a11y-auditWCAG 2.2 audit and real contrast checks/apply-aestheticApply an archetype or one of the 138 named systems/critiqueAn adversarial reviewer that argues for rejection, with
evidenceThe kit does not ask to be trusted. Its gates run against real files and real renders, and they exit non-zero when they fail. This is the actual output from running four of them against this page.
$ python3 scripts/validate_tokens.py
Parsed 14/14 token files, 450 tokens defined.
OK: all token files valid JSON.
$ python3 scripts/validate_contrast.py
OK: all required contrast pairs pass WCAG 2.2 minimums.
$ python3 scripts/lint_hardcodes.py public/site.css
OK: no hardcoded values found.
$ python3 scripts/check_no_emoji.py index.html public/site.css
OK: no emoji in UI output or taste files.
The full run is node scripts/accuracy_report.mjs, 37 gates as one
all-or-nothing check on a headless render in light and dark. One failure fails the whole thing, and
taste is never scored, only judged.
Questions
npx ux-ui-agent-skills init in the project folder, then open that folder in Claude
Code. CLAUDE.md loads on its own, so there is no configuration step. To take only part of
it, use npx ux-ui-agent-skills add tokens taste design-systems.node scripts/accuracy_report.mjs runs them as one all-or-nothing check with no partial
credit. The floor is WCAG 2.2 Level AA, with an AAA upgrade path documented.DESIGN.md specs covering products like Apple, Stripe, Linear,
Vercel, Notion and Spotify, alongside aesthetic archetypes such as brutalism, editorial and
glassmorphism. Ask for a direction by name and the tokens re-point to it while accessibility holds,
because taste serves the aesthetics tier and never overrides POUR.CLAUDE.md automatically; elsewhere the same files can be pointed at
by hand.ux-ui-agent-skills. The current release
is v2.5.1./critique is an adversarial reviewer that renders the work, screenshots it at 1280
and 390 in both themes, clicks every control and argues for rejection with evidence. A passing gate is
never evidence of taste.DTCG-format JSON on a three-tier architecture, primitive, semantic, component. Colour, typography, spacing, shadows, borders, breakpoints, motion. Dark mode swaps semantics; primitives never move.
Atoms to templates, each with anatomy, variants, the eight states, token mapping and an accessibility spec. A component is correct only when every variant times every state renders right, not just the resting default.
The Framework Adapter Protocol is a universal token-to-framework contract, so the agent can target a stack even with no dedicated file, and writes a new adapter on demand. Full references for React 19 + Tailwind v4, Next.js 15 App Router and SwiftUI 6; concise adapters for Vue, Svelte, Angular, Solid, Lit, React Native, Flutter, Jetpack Compose, vanilla CSS and CSS-in-JS.
Read the adapter protocolAn anti-slop doctrine with banned defaults, aesthetic archetypes, and a library of 138 brand-grade design systems, Apple, Linear, Stripe, Vercel, Notion, Spotify and more. Ask for the direction by name: make this dashboard feel like Stripe, and the tokens re-point while accessibility holds.
Browse all 138Contrast in default, hover and focus. axe-core roles and names. Focus traps, RTL mirroring, target size, keyboard operability, reduced motion, including content only an animation reveals. Not a checklist: a gate that exits non-zero.
A passing gate is never evidence of taste. /critique refuses to review from source alone -
it screenshots at 1280 and 390 in light and dark, clicks every control, and returns the three reasons a
senior designer would send the work back.