design-system

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

Updated Aug 26, 2026
One-click install
npx skills add https://github.com/MohamadJoumaa/Direct --skill design-system-mohamadjoumaa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-system
Source: https://github.com/MohamadJoumaa/Direct/tree/main/.cursor/skills/design-system
Command: npx skills add https://github.com/MohamadJoumaa/Direct --skill design-system-mohamadjoumaa

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. This Skill provides a three-layer token architecture (primitive, semantic, component) with generators and validators, plus a system for producing token-compliant HTML slide decks. ## Core Features & Use Cases - Token Generation & Validation: Convert JSON token configs into CSS variables or Tailwind config, and scan code for hardcoded values that bypass tokens. - Component Specifications: Reference detailed specs for buttons, inputs, cards, badges, alerts, dialogs, and tables with variants, sizes, and states. - Slide Deck Generation: Build brand-compliant HTML presentations using BM25 slide search, decision CSVs for layout/typography/color, Chart.js charts, and token validation. - Use Case: A designer needs a 10-slide investor pitch that matches brand guidelines. The Skill selects layouts and emotion arcs from strategy CSVs, generates HTML using only CSS variables, and validates the output for token compliance. ## Quick Start Ask the AI to generate a brand-compliant pitch deck or generate CSS design tokens from the starter JSON config using the included 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 the generate-tokens.cjs script with your token config: node 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.

How do I create a brand-compliant HTML slide deck?

Use the generate-slide.py script with a JSON file describing slide types (title, problem, solution, metrics, chart, testimonial, cta), or run it with --demo for a sample deck. All slides import design-tokens.css and use CSS variables exclusively.

What is the three-layer design token architecture?

Primitive tokens hold raw values like hex colors and spacing, semantic tokens alias them by purpose such as primary or muted, and component tokens map semantics to specific elements like button background. This structure enables theme switching and per-component customization.

Can I validate that my HTML slides use design tokens correctly?

Yes, run html-token-validator.py to scan slide and infographic HTML files for hardcoded hex colors, rgb values, and fonts. It checks that design-tokens.css is imported and reports files that bypass the var() token pattern.

Does the slide generator support charts?

Yes, slides integrate Chart.js 4 for data visualization, and the decision CSVs map 25 chart types to configurations. The generator also includes a CSS-only bar chart fallback styled with gradient tokens.

Where do slide background images come from?

The fetch-background.py script provides curated Pexels images organized by slide type such as hero, problem, and cta. It generates overlay gradients using brand colors resolved from design-tokens.json.