theme-design

Design CSS theme systems with design tokens, color palettes, and typography scales.

3|Updated May 28, 2026
One-click install
npx skills add https://github.com/mahg-es/araya --skill theme-design-mahg-es
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: theme-design
Source: https://github.com/mahg-es/araya/tree/main/skills/theme-design
Command: npx skills add https://github.com/mahg-es/araya --skill theme-design-mahg-es

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Hardcoded colors and inconsistent spacing create visual chaos across pages. Theme design codifies the visual language into design tokens — change one token, and every component updates consistently. Themes make visual design systematical, not accidental.

Core Features & Use Cases

  • Extract design tokens from brand guidelines (colors, fonts, logos)
  • Define CSS custom properties on :root:
    • Colors: primary, surface, text, border, semantic (error, success, warning)
    • Typography: font-family, font-size scale, font-weight, line-height
    • Spacing: 4px-based scale (4, 8, 12, 16, 24, 32, 48, 64)
    • Radii: sm (4px), md (8px), lg (16px), full (9999px)
    • Shadows: sm, md, lg (for elevation)
  • Design dark mode: data-theme="dark" or prefers-color-scheme: dark
  • Create component variants using design tokens (primary, secondary, danger, ghost)
  • Test accessibility: contrast ratios, focus indicators, reduced motion
  • Document theme tokens for developer reference

Quick Start

Extract tokens from brand guidelines and implement them as CSS custom properties on the root selector :root to build a theme with dark mode and component variants.

Frequently Asked Questions about theme-design

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

FAQPage Schema
How do I create scalable CSS design tokens for light and dark modes?

Create scalable CSS design tokens by defining custom properties on the :root selector for colors, typography, spacing, and radii, then override them using data-theme attributes or prefers-color-scheme media queries for dark mode support.

What is the best way to structure CSS custom properties for a design system?

The best way to structure CSS custom properties for a design system is grouping them by category on :root, including semantic colors, typographic scales, 4px-based spacing, radii, and shadow elevations to ensure consistent visual language across components.

How do I build component variants using CSS design tokens?

Build component variants by mapping semantic design tokens like primary, secondary, danger, and ghost to component styles, allowing every variant to update consistently across the application when a root token changes.

Does theming with CSS custom properties support accessibility requirements?

Theming with CSS custom properties supports accessibility by allowing you to test and define contrast ratios, focus indicators, and reduced motion preferences within the token system to meet compliance standards.

Why use design tokens instead of hardcoded CSS colors and spacing?

Use design tokens instead of hardcoded CSS values to eliminate visual chaos across pages, ensuring that changing a single token updates every component consistently and makes visual design systematic rather than accidental.