SKILL.md
Skill: Design Tokens
Produce and maintain DTCG ($type/$value) tokens following the project's 3-tier system.
Steps
- Read
.claude/rules/tokens-and-color.md → "Token System" + "Color Guidelines" and .claude/rules/typography-and-spacing.md for the rules (4px base, Major Third scale, OKLCH palette generation, dark-mode-at-semantic-layer).
- Read the relevant existing files in
tokens/ to match structure: colors.json, typography.json, spacing.json, shadows.json, borders.json, breakpoints.json, motion.json, gradients.json, opacity.json, blur.json, sizing.json, states.json, theming.json.
- Generate/extend tokens:
- Primitives = raw values (never used directly). Semantic = purpose aliases. Component = component-scoped. - New palettes: generate 11 OKLCH shades; verify 500 ≥ 4.5:1 on white (text), 600 ≥ 3:1 (UI) using the a11y-audit skill / scripts/contrast.py. - Multi-brand/density → theming.json.
- Validate: run
python3 scripts/validate_tokens.py (JSON validity + alias resolution).
Output
DTCG JSON. Preserve $description on every token. Reference, never hardcode.