design-system

Generate three-layer design tokens, component specifications, and brand-compliant HTML slide decks.

Updated May 9, 2026
One-click install
npx skills add https://github.com/Aeonxuu/southtownslandservice_v2 --skill design-system-aeonxuu
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: design-system
Source: https://github.com/Aeonxuu/southtownslandservice_v2/tree/main/.claude/skills/design-system
Command: npx skills add https://github.com/Aeonxuu/southtownslandservice_v2 --skill design-system-aeonxuu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve? Maintaining visual consistency across components and presentations is difficult when colors, spacing, and typography are hardcoded. This Skill provides a three-layer token architecture (primitive, semantic, component) with CSS variable generation, validation tooling, and a slide generation system that enforces token compliance. ## Core Features & Use Cases - Token Generation & Validation: Convert JSON token configs into CSS variables or Tailwind theme config, and scan codebases for hardcoded values that bypass the token system. - Component Specifications: Reference detailed specs for buttons, inputs, cards, badges, alerts, dialogs, and tables covering variants, sizes, states, and anatomy. - Slide Deck Generation: Create brand-compliant HTML presentations using design tokens, Chart.js, BM25 slide search, and a contextual decision system with emotion arcs and layout logic. - Use Case: A frontend developer needs a dark-mode-ready design system. They start from the starter JSON template, generate CSS variables, then produce an investor pitch deck where every slide imports design-tokens.css and passes the token validator. ## Quick Start Ask the AI to generate design tokens from the starter JSON template and create a brand-compliant pitch deck using the design-system skill.

Frequently Asked Questions about design-system

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

FAQPage Schema
How do I generate CSS variables from a design tokens JSON file?▼

Run the generate-tokens.cjs script with your JSON config: node scripts/generate-tokens.cjs --config tokens.json -o tokens.css. It resolves token references across primitive, semantic, and component layers and can also output a Tailwind color config with --format tailwind.

What is a three-layer design token architecture?▼

It separates raw primitive values (hex colors, spacing) from semantic aliases (primary, muted) and component-specific tokens (button-bg). Each layer references the one below, so changing a primitive propagates through the entire system and enables theme switching.

How do I create slides that follow my brand design tokens?▼

Use the slide generation scripts which produce HTML importing design-tokens.css as the single source of truth. All styles must use var(--token-name) references, charts use Chart.js, and the html-token-validator.py script verifies compliance.

Does the token validator catch hardcoded colors in HTML files?▼

Yes, html-token-validator.py scans slides and infographics for hex, rgb, rgba, and hsl values plus hardcoded fonts. It allows exceptions for Chart.js script blocks, external image URLs, and brand-color rgba values needed for transparency effects.

Can I use these design tokens with Tailwind CSS?▼

Yes, generate-tokens.cjs supports a tailwind output format that maps semantic color tokens to CSS variable references for tailwind.config.ts. The references directory also includes a dedicated Tailwind integration guide.

What are the limitations of the slide background image fetcher?▼

fetch-background.py uses a curated set of pre-selected Pexels images rather than live API calls, so options are limited to the built-in categories like hero, team, and cta. For other needs it returns a Pexels search URL for manual selection.