Design System Architect

Define design tokens, components, and governance for scalable design systems.

34|7|Updated Oct 22, 2025
One-click install
npx skills add https://github.com/daffy0208/ai-dev-standards --skill design-system-architect
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Design System Architect
Source: https://github.com/daffy0208/ai-dev-standards/tree/main/SKILLS/design-system-architect
Command: npx skills add https://github.com/daffy0208/ai-dev-standards --skill design-system-architect

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires style-dictionary, @storybook/react-vite, @storybook/addon-links, @storybook/addon-essentials, @storybook/addon-interactions, @storybook/addon-a11y, storybook-addon-designs, jest, @testing-library/react, jest-axe, rollup, @rollup/plugin-typescript, rollup-plugin-postcss, typescript, chromatic.

What problem does it solves? This Skill solves the problem of inconsistent user experiences and slow development cycles by establishing a single source of truth for design and code, enabling teams to build products faster and maintain brand consistency at scale.

Core Features & Use Cases

  • Design Tokens: Defines atomic design values (colors, spacing, typography) as data, ensuring platform-agnostic consistency and easy theming.
  • Component Architecture: Guides the creation of a reusable component library using Atomic Design principles, complete with TypeScript types and scoped styles.
  • Storybook Documentation: Sets up comprehensive, interactive documentation for all components, showcasing variants, states, and usage guidelines.

Quick Start

Fastest path to design system:

  1. Create design tokens: npm install --save-dev style-dictionary
    • Define primitives (colors, spacing, typography)
    • Define semantic tokens (background-primary, text-secondary)
    • Build to CSS variables
  2. Set up component library:
    • Use atomic design (atoms → molecules → organisms)
    • TypeScript for type safety
    • CSS modules for scoping
  3. Add Storybook: npx storybook@latest init
    • Document all components
    • Show all variants and states
    • Add accessibility addon

Frequently Asked Questions about Design System Architect

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

FAQPage Schema
How do I create a design system with design tokens and component library?

Design tokens define atomic values like colors and spacing as data, ensuring consistency across products. Combine Style Dictionary to build tokens into CSS variables, Atomic Design principles for component architecture, and TypeScript for type safety to establish a scalable, single source of truth.

Can I use Storybook to document and showcase component variants?

Yes. Storybook provides interactive documentation for all components, displaying variants, states, and usage guidelines. The accessibility addon enables compliance checking, and integrations like Chromatic support versioned releases and contributor governance across your component library.

What's the best way to implement multi-brand theming at scale?

Use semantic design tokens layered on top of primitive tokens to define brand-specific values. Style Dictionary transforms these tokens into platform-agnostic outputs like CSS variables, enabling consistent theming across products without duplicating component code.

Do I need TypeScript and CSS modules for a component library?

TypeScript provides type safety and improves developer experience, while CSS modules scope styles to prevent conflicts in larger libraries. Together they support the governance and maintainability required for teams scaling design systems across multiple products.

How do design tokens enable faster development and brand consistency?

Design tokens centralize design decisions as reusable data, eliminating manual updates across codebases. When tokens change, all dependent components update automatically, reducing development cycles and ensuring consistent user experiences across all products and platforms.

What accessibility checks should I include in a component library?

Storybook's accessibility addon and jest-axe detect WCAG violations during development. Automated testing catches common issues early, while comprehensive Storybook documentation of component states ensures contributors understand accessible usage patterns.