design-system

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

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

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 centralizes design decisions into a three-layer token architecture (primitive, semantic, component) and generates validated, token-compliant HTML slides and CSS from a single JSON source of truth. ## Core Features & Use Cases - Token Generation & Validation: Convert a JSON token config into CSS variables or Tailwind theme config, and scan source code or HTML for hardcoded colors and fonts that violate token usage. - Component Specifications: Reference detailed specs for buttons, inputs, cards, badges, alerts, dialogs, and tables, including variants, sizes, states, and anatomy. - Slide Deck Generation: Build brand-compliant HTML presentations with Chart.js charts, BM25-based slide search, decision CSVs for layout/typography/color, and curated Pexels background images. - Use Case: A designer needs a 10-slide investor pitch. The Skill queries its strategy and layout CSVs, generates token-compliant HTML slides with charts and backgrounds, then validates the output for hardcoded values before delivery. ## Quick Start Ask the AI to generate a brand-compliant pitch deck or CSS design tokens from a JSON config 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 generate-tokens.cjs --config tokens.json -o tokens.css. It resolves token references like {primitive.color.blue.600} and outputs primitive, semantic, and component layers as CSS variables, with optional Tailwind format.

How to create a brand-compliant HTML pitch deck with design tokens?

Use the generate-slide.py script with a JSON file describing slide types (title, problem, solution, metrics, chart, testimonial, cta). The output imports design-tokens.css and uses only var() references, then html-token-validator.py checks for hardcoded colors or fonts.

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). This structure enables theme switching, such as light and dark modes, by redefining only the semantic layer.

Does the slide generator support charts and background images?

Yes. Slides use Chart.js 4 for data visualization and fetch-background.py provides curated Pexels images per slide type with brand-color overlay gradients. CSS-only bar charts are also available in the generated template.

Why does token validation fail on my HTML slide file?

Validation fails when the file lacks the design-tokens.css import or contains hardcoded hex, rgb, or hsl colors in style blocks or inline styles. Values inside script tags for Chart.js and brand-color rgba transparency values are allowed exceptions.