atelier-foundationslisted
Install: claude install-skill luminary19/atelier
# Atelier — Design-System Foundations
The engine of the suite. **"Expensive" is not a trick — it's a system showing through.** Coherent
color, spacing, and type tokens are what separate bespoke-looking work from a pile of one-off values.
This skill turns a Direction Doc into a real, reusable token system that `atelier-typography` and
`atelier-layout` (and your components) consume.
> **Inputs:** the Direction Doc from `atelier-direction` (palette mood, type voice, density, light/dark).
> **Outputs:** tokens as CSS vars / Tailwind v4 `@theme` / DTCG JSON. Deep reference:
> `references/fundamentals-deepdive.md` (§7 color, §8 spacing, §9 tokens).
---
## Token architecture (build in this order)
Three tiers, always. This is what makes theming and dark mode trivial later.
1. **Primitive / ramp** — raw values, no meaning: `--blue-50 … --blue-950`, `--space-1 … --space-12`.
2. **Semantic / alias** — intent, *referencing* primitives: `--bg`, `--surface`, `--border`, `--text`,
`--text-muted`, `--primary`, `--danger`. **This tier carries the brand and enables theming** —
dark mode = remap semantics, never touch components.
3. **Component** (optional) — component-scoped: `--button-bg`, `--card-padding`, referencing semantics.
Rule: components consume tier 2/3, **never hard-code a primitive**. Get this right and dark mode is a
20-line remap instead of a rewrite.
---
## 1. Color — build in OKLCH
Build the whole color system in **OKLCH**, not HSL/hex. HSL lies about lightness