token-component-system

Convert design decisions into design tokens, components, states, and developer handoff rules.

2|Updated Jun 19, 2025
One-click install
npx skills add https://github.com/Prat05devs/dapper-city-threads --skill token-component-system-prat05devs
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: token-component-system
Source: https://github.com/Prat05devs/dapper-city-threads/tree/main/.agent/skills/token-component-system
Command: npx skills add https://github.com/Prat05devs/dapper-city-threads --skill token-component-system-prat05devs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Design decisions often live in scattered documents and never become consistent, reusable implementation rules, forcing developers to guess values. This Skill turns an approved design.md and visual direction into a structured token and component system that developers and AI agents can implement without ambiguity. ## Core Features & Use Cases - Three-Layer Token Architecture: Generates primitive, semantic, and mapped tokens (color, typography, spacing, motion) as JSON files plus CSS variables, with each value marked confirmed, inferred, or missing. - Component and State Specs: Defines reusable components (buttons, cards, carousels, deck slides) with full interaction states including hover, focus, disabled, loading, and error. - Slot-Based Layouts and Handoff Gate: Produces slot-based templates and a handoff checklist ensuring tokens are traceable, responsive rules are clear, and unresolved values are flagged. - Use Case: After finalizing a brand's visual language, use this Skill to produce primitive.tokens.json, semantic.tokens.json, motion.tokens.json, and a token-status.md so a front-end developer can build the site without guessing any style values. ## Quick Start Use the token-component-system skill to convert my approved design.md into design tokens, component specs, and a developer handoff file.

Frequently Asked Questions about token-component-system

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

FAQPage Schema
How do I convert a design.md file into design tokens?▼

Provide your approved design.md and visual language files, and the Skill generates primitive, semantic, and mapped token JSON files plus CSS variables. Each token is marked confirmed, inferred, or missing so unresolved values are explicit.

What is the difference between primitive, semantic, and mapped design tokens?▼

Primitive tokens hold raw values like color scales and spacing. Semantic tokens assign meaning such as color-primary or surface-card. Mapped tokens bind values to specific usages like button-primary-bg or hero-title.

Can I generate CSS variables and Tailwind mappings from design tokens?▼

Yes, the Skill defines CSS variables for HTML/CSS outputs and supports Tailwind mappings as part of the token outputs. Token values must trace back to design.md decisions rather than arbitrary values.

What happens if design.md is missing or outdated?▼

The Skill stops and returns to the master/context architect to create or update design.md before any token work begins. Tokens must express approved decisions, so stale or contradicted inputs block generation.

Which component states should a design system define?▼

Interactive components should define default, hover, focus, active, and disabled states, plus loading, error, and success where relevant. The Skill includes these state definitions in its component specs and handoff rules.