design-tokens-dtcglisted
Install: claude install-skill rustcircle/c101
# Design tokens (DTCG 2025.10)
Baseline (October 2026): Design Tokens Format Module, Color Module and Resolver Module **2025.10**
(Final Community Group Reports of the W3C Design Tokens Community Group, 28 Oct 2025; stable, not a
W3C Recommendation). Tools: style-dictionary 5.7, @terrazzo/cli 2.9, tailwindcss 4.3. Check
designtokens.org before using anything newer than this page; never invent `$` keys.
Deep material: [validator source](references/validator.md) |
[build pipelines](references/build-pipelines.md) |
[migrations and releases](references/migrations-release.md)
## 1. Three tiers and the naming grammar
| Tier | Example name | Holds | May alias | Consumed by |
|---|---|---|---|---|
| primitive | `color.pink.600`, `space.4` | literal values (a palette, a scale) | nothing (or other primitives) | semantic tokens only |
| semantic | `color.action.primary.bg`, `color.text.default` | role, swapped per mode | primitives, other semantics | components and app code |
| component | `button.primary.bg` | one component's decision | semantics only, **never primitives** | that component |
Grammar: `{category}.{property}.{variant}.{state}`, lowercase, kebab-case inside a segment.
`color.action.primary.bg` -> `color.action.primary.bg-hover` is a flat sibling; when a token needs
states, make it a group with a `$root` default: `bg: { "$root": {...}, "hover": {...} }`, aliased as
`{color.action.primary.bg.$root}` (Style Dictionary >= 5.7 names it `--color-action-primary-bg`).
Categ