design-system

Generate typography scales and OKLCH color palettes as canonical design tokens.

Updated Jul 10, 2026
One-click install
npx skills add https://github.com/subvisual/the-a-team --skill design-system-subvisual
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: design-system
Source: https://github.com/subvisual/the-a-team/tree/main/.claude/skills/design-system
Command: npx skills add https://github.com/subvisual/the-a-team --skill design-system-subvisual

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Establishing a project's visual foundation from scratch — typography scale, color palette, spacing — often produces ad-hoc values that drift over time and fail accessibility checks. This Skill generates canonical design tokens (typography, OKLCH tint scales, spacing) with WCAG contrast validation, either interactively or derived from existing design context in the A-Team pipeline. ## Core Features & Use Cases - Typography scale generation: Compute type sizes, line-heights, and spacing from a base size and ratio, with an anti-collision rule that snaps values to a 4px grid and warns on tight collisions. - OKLCH palette generation: Generate 10-step perceptually uniform tint scales (brand, neutral, accent, semantic colors) from a hue/chroma seed, with hex fallbacks and a WCAG nudge loop that adjusts lightness until AA contrast passes. - shadcn theme bridge: Bind shadcn/ui role variables (--background, --primary, --ring, etc.) to scale steps with contrast-checked foreground/background pairs. - Use Case: A new project has no design system. Run the skill to produce scale.ts, palette.ts, and shadcn-theme.css under docs/product/design-system/, plus Tailwind config and CSS variable blocks for a lofi prototype — all gate-reviewed and never silently overwritten. ## Quick Start Ask the AI to set up the design system by generating typography and color tokens for the project, providing a brand color seed or describing the product's domain and mood.

Frequently Asked Questions about design-system

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a color palette from a brand color?▼

Provide a brand seed as a hex value, hue, or brand name, and the skill converts it into an OKLCH hue/chroma pair, then generates a 10-step tint scale (50 through 900) using generate-scale.mjs. Neutral, accent, and semantic scales are derived around the brand hue.

How to create a typography scale with a modular ratio?▼

Run generate-scale.mjs typography with a base size and ratio, or pick a curated preset (Compact, Balanced, Relaxed, Spacious). The script snaps sizes to multiples of 4, applies an anti-collision rule anchored on body text, and returns matching line-heights and spacing tokens.

Does the generated palette meet WCAG contrast requirements?▼

Yes, the skill checks brand-500 against neutral-50 in both directions against the AA 4.5:1 bar using the contrast subcommand. If a pair fails, it regenerates with lightness adjusted down 0.02, up to two nudges, and surfaces the failure rather than shipping low-contrast tokens.

Can I use the design tokens with shadcn/ui and Tailwind?▼

Yes, the skill writes a shadcn-theme.css binding shadcn role variables like --primary and --ring to OKLCH scale steps, plus a tailwind.config.mjs referencing CSS custom properties. The CSS variables are version-agnostic across Tailwind v3 config and v4 @theme.

When should I not regenerate a design system?▼

Never regenerate when docs/product/design-system/ already exists or a config points at a real token source — consume the existing tokens as settled facts instead. Regeneration only happens on an explicit human instruction, never spontaneously.

Does the design system support dark mode?▼

No, version 1 is light mode only. Dark mode is recorded as an open item in research-plan.md rather than inventing an unreviewed dark palette.