design-system

Generates three-layer design tokens, component specs, and brand-compliant HTML slide decks.

Updated Sep 6, 2026
One-click install
npx skills add https://github.com/AbuBakar125-co/Resturant_web --skill design-system-abubakar125-co
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-system
Source: https://github.com/AbuBakar125-co/Resturant_web/tree/main/agent/skills/design-system
Command: npx skills add https://github.com/AbuBakar125-co/Resturant_web --skill design-system-abubakar125-co

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Maintaining visual consistency across components and presentations is hard when colors, spacing, and typography are hardcoded everywhere. This Skill establishes a single source of truth with a three-layer token architecture (primitive, semantic, component) and enforces it through generation and validation scripts. ## Core Features & Use Cases - Token Architecture & Generation: Define primitive, semantic, and component tokens in JSON and generate CSS variables or Tailwind config with generate-tokens.cjs. - Component Specifications: Reference detailed specs for buttons, inputs, cards, badges, alerts, dialogs, and tables with states, variants, and sizing. - Slide Generation: Create brand-compliant HTML pitch decks using design tokens, Chart.js, BM25 slide search, and CSV-driven layout/typography/color decision systems. - Validation: Detect hardcoded colors and fonts in code and HTML with validate-tokens.cjs and html-token-validator.py. - Use Case: A team needs a 10-slide investor pitch that matches their brand. The Skill queries its decision CSVs for layout and emotion arcs, generates token-compliant HTML slides with Chart.js charts, and validates the output for hardcoded values. ## Quick Start Ask the AI to generate design tokens from the starter JSON template and then create a brand-compliant pitch deck using the slide generation scripts.

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 generate-tokens.cjs with --config pointing to your tokens JSON and -o for the output CSS file. It resolves token references like {primitive.color.blue.600} and emits primitive, semantic, component, and dark-mode CSS variable blocks.

What is a three-layer design token architecture?

It splits tokens into primitive (raw values like hex colors), semantic (purpose aliases like --color-primary), and component layers (like --button-bg). Each layer references the one below, enabling theme switching and per-component customization.

How do I create a brand-compliant pitch deck with design tokens?

Use the slide generation scripts which query decision CSVs for layout, typography, and color logic, then output HTML importing design-tokens.css. All slides must use var() token references and Chart.js for charts, never hardcoded values.

Does the token validator work with Tailwind projects?

Yes, validate-tokens.cjs scans source directories for hardcoded values, and generate-tokens.cjs supports a --format tailwind option that outputs a Tailwind color config mapping semantic tokens to CSS variables.

Why does HTML token validation flag rgba colors in my slides?

The validator flags hardcoded rgba values in style blocks, but allows rgba versions of brand colors since CSS transparency requires them. Colors inside script tags for Chart.js and external image URLs are also exempted.

Where do the slide background images come from?

The fetch-background.py script uses curated Pexels image URLs organized by slide type such as hero, problem, and cta. It applies brand-color overlay gradients derived from your design-tokens.json semantic colors.