design-tokens

Generate and validate DTCG design tokens using a 3-tier primitive-semantic-component architecture.

Updated Jul 20, 2026
One-click install
npx skills add https://github.com/idy-00/paytrack --skill design-tokens-idy-00
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-tokens
Source: https://github.com/idy-00/paytrack/tree/main/backend/.agents/skills/design-tokens
Command: npx skills add https://github.com/idy-00/paytrack --skill design-tokens-idy-00

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Maintaining consistent colors, typography, spacing, and theming across a design system is error-prone when values are hardcoded. This Skill produces structured DTCG-format token files that follow a strict 3-tier architecture, keeping primitives, semantic aliases, and component tokens cleanly separated. ## Core Features & Use Cases - Token Generation: Create or extend DTCG JSON tokens for colors, typography, spacing, shadows, borders, breakpoints, motion, gradients, opacity, blur, sizing, states, and theming. - Accessible Palette Creation: Generate 11-shade OKLCH color palettes with contrast verification (500 ≥ 4.5:1 on white for text, 600 ≥ 3:1 for UI). - Multi-Brand Theming: Manage brand and density variations through a dedicated theming.json file. - Use Case: When adding a new brand to your product, ask the Skill to generate a full OKLCH palette, wire it into the semantic layer for dark mode support, and validate the output with the token validation script. ## Quick Start Generate a new accessible color palette as DTCG design tokens and add it to my tokens directory with dark mode support.

Frequently Asked Questions about design-tokens

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

FAQPage Schema
How do I create design tokens in DTCG format?

Define tokens using $type and $value fields organized in three tiers: primitives hold raw values, semantic tokens alias primitives by purpose, and component tokens reference semantic ones. Validate the JSON files with a token validation script to check alias resolution.

How to generate an accessible color palette for a design system?

Generate 11 shades per hue using the OKLCH color space, then verify contrast ratios: shade 500 must reach at least 4.5:1 on white for text and shade 600 at least 3:1 for UI elements. A contrast-checking script can automate this audit.

What is the difference between primitive and semantic design tokens?

Primitive tokens store raw values like specific OKLCH colors and are never used directly in components. Semantic tokens are purpose-based aliases, such as text-primary, that reference primitives and enable features like dark mode at the semantic layer.

Can design tokens support multiple brands and dark mode?

Yes, multi-brand and density variations are handled in a dedicated theming.json file. Dark mode is implemented at the semantic layer so component tokens automatically adapt when the active theme changes.

Why does my design token file fail validation?

Validation typically fails due to invalid JSON syntax or aliases that reference non-existent tokens. Run the validate_tokens.py script to check JSON validity and confirm every alias resolves to a defined token.