design-system-patterns

Establish scalable design system foundations with semantic tokens and React theming.

Updated May 3, 2026
One-click install
npx skills add https://github.com/miethe/boxbrain-2 --skill design-system-patterns-miethe
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-system-patterns
Source: https://github.com/miethe/boxbrain-2/tree/main/.claude/skills/design-system-patterns
Command: npx skills add https://github.com/miethe/boxbrain-2 --skill design-system-patterns-miethe

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps teams avoid inconsistent UI, duplicated styling decisions, fragile component APIs, and difficult-to-maintain themes by providing a structured approach to design system foundations.

Core Features & Use Cases

  • Design Tokens: Define organized primitive, semantic, and component tokens for color, typography, spacing, shadows, and platform-specific outputs.
  • Theming Infrastructure: Implement light, dark, system, and multi-brand themes with CSS custom properties and React providers.
  • Component Architecture: Build reusable components using compound components, polymorphic APIs, slots, headless patterns, controlled state, and type-safe variants.
  • Governance and Accessibility: Establish token versioning, deprecation workflows, contrast validation, reduced-motion support, high-contrast modes, and SSR safeguards.
  • Use Case: Apply the Skill when creating a scalable component library for a React application that needs consistent styling, theme switching, responsive variants, and accessible composition patterns.

Quick Start

Use the design-system-patterns skill to design a token hierarchy and React component architecture for a scalable light-and-dark themed application.

Frequently Asked Questions about design-system-patterns

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

FAQPage Schema
How do I structure design tokens for a scalable React component library?

Structure design tokens by defining organized primitive, semantic, and component tokens for color, typography, spacing, and shadows. This hierarchy establishes a scalable foundation that unifies visual outputs and prevents duplicated styling decisions across your React application.

What is the best way to implement light and dark mode theming with CSS custom properties?

Implement light and dark mode theming using CSS custom properties paired with React providers. This infrastructure supports system, multi-brand, and high-contrast themes while maintaining consistent styling and enabling seamless theme switching across your web application.

Can I use compound components and headless patterns for accessible React architecture?

Yes, you can build reusable components using compound components, polymorphic APIs, slots, and headless patterns. This approach ensures type-safe variants, controlled state, and accessible composition patterns for maintainable component libraries.

Does this design system approach support accessibility validation and reduced-motion?

Yes, the approach establishes governance patterns including contrast validation, reduced-motion support, high-contrast modes, and SSR safeguards. These accessibility features ensure your design system remains compliant and usable across diverse user needs.

How do I manage component API versioning and deprecation workflows in a design system?

Manage component API versioning and deprecation through established governance patterns. This structured approach maintains type-safe APIs, validates token changes, and ensures maintainable workflows that prevent fragile component architectures over time.