design-tokens
Generate WCAG-checked type, color, spacing, and dark-mode tokens, or consolidate Tailwind v4 tokens with identical rendering. Triggers "design tokens", "type scale", "color palette", "theme setup", "reduce tokens", "dedupe tokens", "consolidate tokens".
darkroomengineering · 已有 AI 审核记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add darkroomengineering/cc-settings --skill design-tokens技能说明
name: design-tokens argument-hint: "[generate|consolidate]" description: Generate WCAG-checked type, color, spacing, and dark-mode tokens, or consolidate Tailwind v4 tokens with identical rendering. Triggers "design tokens", "type scale", "color palette", "theme setup", "reduce tokens", "dedupe tokens", "consolidate tokens". context: fork
Design Tokens
When to Use
- User is setting up a new project's design system
- User asks for a type scale, color palette, or spacing system
- User needs WCAG-compliant color combinations
- User wants dark mode colors derived from a light palette
- User asks for "design tokens" or "theme setup"
- Building a Tailwind config or CSS custom properties
Core Philosophy
- Math over taste. Scales should follow ratios, not arbitrary values.
- Accessibility by default. Every text/background combo must pass WCAG AA.
- Systematic. Every value should be derivable from a base + ratio.
- Portable. Output as CSS custom properties, Tailwind config, or JSON tokens.
Type Scale Generation
The Formula
fontSize = baseFontSize x ratio^step
Recommended Ratios
| Ratio | Name | Value | Best for |
|---|---|---|---|
| Minor Second | 1.067 | Tight, minimal difference | Dense UI, dashboards |
| Major Second | 1.125 | Subtle progression | Apps, data-heavy interfaces |
| Minor Third | 1.200 | Balanced, versatile | Most websites, SaaS |
| Major Third | 1.250 | Clear hierarchy | Marketing sites, blogs |
| Perfect Fourth | 1.333 | Strong contrast | Editorial, landing pages |
| Augmented Fourth | 1.414 | Dramatic | Bold designs, portfolios |
| Perfect Fifth | 1.500 | Very dramatic | Hero-heavy designs |
Generating the Scale
Given a base size (typically 16px) and a ratio:
Step -2: 16 / ratio^2 = xs
Step -1: 16 / ratio = sm
Step 0: 16 = base
Step 1: 16 x ratio = lg
Step 2: 16 x ratio^2 = xl
Step 3: 16 x ratio^3 = 2xl
Step 4: 16 x ratio^4 = 3xl
Step 5: 16 x ratio^5 = 4xl
Step 6: 16 x ratio^6 = 5xl
Round to nearest 0.5px or convert to rem (/ 16).
Line Height Rules
| Font Size | Line Height | Use |
|---|---|---|
| <= 14px | 1.6-1.7 | Small text, captions |
| 16-20px | 1.5-1.6 | Body text |
| 20-32px | 1.3-1.4 | Subheadings |
| 32-48px | 1.1-1.2 | Headings |
| 48px+ | 1.0-1.1 | Display/hero text |
Rule of thumb: As font size increases, line height decreases.
Letter Spacing Rules
| Size | Letter Spacing | Why |
|---|---|---|
| Small text (<=14px) | 0.01-0.02em | Slightly open for readability |
| Body text | 0em (normal) | Don't touch it |
| Subheadings | -0.01em | Slightly tighten |
| Headings | -0.02em to -0.03em | Tighten as size grows |
| Display text | -0.03em to -0.05em | Tight tracking at large sizes |
Font Weight Pairing
| Role | Weight | Tailwind |
|---|---|---|
| Body | 400 (Regular) | font-normal |
| Body emphasis | 500 (Medium) | font-medium |
| Subheading | 600 (Semibold) | font-semibold |
| Heading | 700 (Bold) | font-bold |
| Display | 800 (Extrabold) | font-extrabold |
Output Example (CSS Custom Properties)
:root {
--font-size-xs: 0.694rem; /* 11.1px */
--font-size-sm: 0.833rem; /* 13.3px */
--font-size-base: 1rem; /* 16px */
--font-size-lg: 1.2rem; /* 19.2px */
--font-size-xl: 1.44rem; /* 23px */
--font-size-2xl: 1.728rem; /* 27.6px */
--font-size-3xl: 2.074rem; /* 33.2px */
--font-size-4xl: 2.488rem; /* 39.8px */
--font-size-5xl: 2.986rem; /* 47.8px */
}
Color Palette Generation
Step 1: Choose Base Colors
Every palette needs:
| Token | Purpose | Example |
|---|---|---|
primary | Main brand color, CTAs | Blue, purple, etc. |
neutral | Text, borders, backgrounds | Gray (warm/cool/pure) |
success | Positive states | Green |
warning | Caution states | Amber/yellow |
error | Destructive states | Red |
info | Informational | Blue (can overlap primary) |
Step 2: Generate Shade Scale (50-950)
For each base color, generate a 10-step shade scale. The base color is typically the 500 step.
Method: HSL manipulation
Starting from the base HSL:
| Step | Lightness Adjustment | Saturation Adjustment |
|---|---|---|
| 50 | +45% | -30% |
| 100 | +38% | -25% |
| 200 | +28% | -15% |
| 300 | +18% | -5% |
| 400 | +8% | 0% |
| 500 | 0% (base) | 0% (base) |
| 600 | -8% | +5% |
| 700 | -18% | +5% |
| 800 | -28% | 0% |
| 900 | -38% | -10% |
| 950 | -45% | -20% |
Clamp all values: lightness 0-100%, saturation 0-100%.
Step 3: Semantic Token Mapping
Map shade steps to semantic roles:
/* Light mode */
--color-bg: var(--neutral-50);
--color-bg-subtle: var(--neutral-100);
--color-bg-muted: var(--neutral-200);
--color-border: var(--neutral-200);
--color-border-strong: var(--neutral-300);
--color-text-muted: var(--neutral-500);
--color-text-subtle: var(--neutral-600);
--color-text: var(--neutral-900);
--color-text-heading: var(--neutral-950);
--color-primary: var(--primary-600);
--color-primary-hover: var(--primary-700);
--color-primary-bg: var(--primary-50);
--color-primary-text: white;
WCAG Contrast Checking
The Formula
Contrast ratio = (L1 + 0.05) / (L2 + 0.05)
Where L1 = lighter relative luminance, L2 = darker.
Relative Luminance
For each channel (R, G, B):
sRGB = channel / 255
linear = sRGB <= 0.04045 ? sRGB / 12.92 : ((sRGB + 0.055) / 1.055) ^ 2.4
L = 0.2126 x R_linear + 0.7152 x G_linear + 0.0722 x B_linear
WCAG Requirements
| Level | Body text | Large text (18pt+/14pt+ bold) | Non-text UI |
|---|---|---|---|
| AA | 4.5:1 | 3:1 | 3:1 |
| AAA | 7:1 | 4.5:1 | — |
Canonical standards: Claude reads ~/.claude/rules/accessibility.md.
Standalone Codex reads the installed AGENTS.md accessibility section and its
native installed rules; it must not reach into `~/.clau