跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
设计与 UI

design-tokens

Generate type scales, color palettes, spacing systems, WCAG contrast checks, and dark mode derivations with math. Use when setting up a design system, creating tokens, or building a Tailwind/CSS theme. Outputs CSS custom properties, Tailwind config, or JSON tokens.

dylanfeltus · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add dylanfeltus/skills --skill design-tokens

技能说明


name: design-tokens description: Generate type scales, color palettes, spacing systems, WCAG contrast checks, and dark mode derivations with math. Use when setting up a design system, creating tokens, or building a Tailwind/CSS theme. Outputs CSS custom properties, Tailwind config, or JSON tokens.

Design Tokens

Generate type scales, color palettes, spacing systems, and dark mode derivations with math — not guessing. Includes WCAG contrast checking, systematic spacing grids, and production-ready CSS/Tailwind output.

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 × ratio^step

Recommended Ratios

RatioNameValueBest for
Minor Second1.067Tight, minimal differenceDense UI, dashboards
Major Second1.125Subtle progressionApps, data-heavy interfaces
Minor Third1.200Balanced, versatileMost websites, SaaS
Major Third1.250Clear hierarchyMarketing sites, blogs
Perfect Fourth1.333Strong contrastEditorial, landing pages
Augmented Fourth1.414DramaticBold designs, portfolios
Perfect Fifth1.500Very dramaticHero-heavy designs

Generating the Scale

Given a base size (typically 16px) and a ratio:

Step -2: 16 / ratio² = xs
Step -1: 16 / ratio  = sm
Step  0: 16          = base
Step  1: 16 × ratio  = lg
Step  2: 16 × ratio² = xl
Step  3: 16 × ratio³ = 2xl
Step  4: 16 × ratio⁴ = 3xl
Step  5: 16 × ratio⁵ = 4xl
Step  6: 16 × ratio⁶ = 5xl

Round to nearest 0.5px or convert to rem (÷ 16).

Line Height Rules

Font SizeLine HeightUse
≤ 14px1.6–1.7Small text, captions
16–20px1.5–1.6Body text
20–32px1.3–1.4Subheadings
32–48px1.1–1.2Headings
48px+1.0–1.1Display/hero text

Rule of thumb: As font size increases, line height decreases.

Letter Spacing Rules

SizeLetter SpacingWhy
Small text (≤14px)0.01–0.02emSlightly open for readability
Body text0em (normal)Don't touch it
Subheadings-0.01emSlightly tighten
Headings-0.02em to -0.03emTighten as size grows
Display text-0.03em to -0.05emTight tracking at large sizes

Font Weight Pairing

RoleWeightTailwind
Body400 (Regular)font-normal
Body emphasis500 (Medium)font-medium
Subheading600 (Semibold)font-semibold
Heading700 (Bold)font-bold
Display800 (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:

TokenPurposeExample
primaryMain brand color, CTAsYour brand color
neutralText, borders, backgroundsGray (warm/cool/pure)
successPositive statesGreen
warningCaution statesAmber/yellow
errorDestructive statesRed
infoInformationalBlue (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:

StepLightness AdjustmentSaturation Adjustment
50+45%-30%
100+38%-25%
200+28%-15%
300+18%-5%
400+8%0%
5000% (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 × R_linear + 0.7152 × G_linear + 0.0722 × B_linear

WCAG Requirements

LevelRatioApplies to
AA Normal Text≥ 4.5:1Body text (< 18px or < 14px bold)
AA Large Text≥ 3:1≥ 18px regular or ≥ 14px bold
AAA
阅读完整来源 ↗