What is the UI design system skill?
The UI design system skill is a SKILL.md in the alirezarezvani skills collection. It guides an AI coding agent through generating design tokens from a brand hex color, structuring components, setting responsive breakpoints and fluid type, and preparing handoff files, using a bundled Python token generator script.
It is one skill inside a large multi-domain skills repo, filed under the product team folder. Its description says to use it when building a design system: tokens, component docs, responsive scales or developer handoff.
Unlike a pure guidance file, it ships a script. The agent runs design_token_generator.py with a hex brand color, a style preset and an output format, then works from the generated token set.
What changes in your agent's output
- Colors arrive as a ten step scale from 50 to 900 for primary, secondary, neutral and semantic groups, not a single guessed hex.
- Type sizes follow a 1.25 ratio from a 16px base, and spacing follows an 8pt grid scale.
- Output can be JSON, CSS custom properties or SCSS variables, so the tokens drop into the stack you already use.
- Components are described as atoms, molecules, organisms and templates, each mapped to the tokens it consumes.
Who it is for
Best for
- Solo developers and small teams who have a brand color but no token system yet.
- Anyone who wants repeatable CSS or SCSS variables instead of values typed by hand in each prompt.
- Teams that will later audit tokens with design-token-audit or tighten rules with design-system-governance.
Not for
- Brands with an existing token file, where generating a fresh palette would fight the system you already have.
- Readers who need a visual design review. The skill produces values and structure, not a critique of a screen.
- Setups without Python, since the token generator is a Python script.
Use it with UiChemy
Generate tokens here, apply them in your Figma design, then use UiChemy Figma to WordPress to turn the finished design into an editable WordPress page. Click Get Started on uichemy.com.
How to install UI Design System Skill: Tokens From One Brand Color
/plugin marketplace add alirezarezvani/claude-skillsThe token script needs Python on your machine. The README describes the repo scripts as standard library only.Add the marketplace
Run the command above inside Claude Code to register the repo as a plugin marketplace named claude-code-skills.
Install the product bundle
Run /plugin install product-skills@claude-code-skills. The bundle description lists a UI design system skill among its product skills.
Other agents
The README also covers Codex, Cursor, Gemini CLI and Copilot with their own install routes. Follow the section for your tool, or copy the skill folder from the repo.
Ask for tokens
Say something like generate design tokens for brand color 0066CC in modern style and let the agent run the script.
Check that it loaded
Ask the agent to build an 8pt spacing system and a type scale. It should run the token generator or cite its 1.25 ratio scale and the 8pt grid.
Key features
- Brand color to token setTakes one hex color and a style of modern, classic or playful, then outputs colors, typography, spacing, sizing, borders, shadows, animation, breakpoints and z-index layers.
- Three output formatsThe script prints JSON, CSS custom properties, SCSS variables or a readable summary, chosen by an argument.
- Ten step color scalesEach palette runs from 50 to 900, with a documented use for each step such as subtle backgrounds, borders, hover states and headings.
- Type scale on a 1.25 ratioSizes run from xs at 10px to 5xl at 61px from a 16px base, with the calculation shown for each size.
- Component hierarchyDefines atoms, molecules, organisms and templates, then maps each component to the token groups it uses, with size and color variant patterns.
- Responsive breakpointsLists breakpoints from xs to 2xl and gives clamp based fluid type values and responsive spacing tokens for mobile, tablet and desktop.
- WCAG contrast referenceIncludes AA and AAA ratios for normal and large text, and tells the agent to check that semantic colors have contrast colors defined.
- Developer handoff stepsShows React with CSS variables, a Tailwind config and styled-components examples, plus Tokens Studio sync for Figma and a handoff checklist.
- Reference guidesFour reference files cover token generation, component architecture, responsive calculations and developer handoff, so the agent can go deeper on demand.
- Validation checklistClosing checklists cover tokens, components, accessibility with 44 by 44 pixel touch targets, and handoff completeness.
Frequently asked questions
What is the UI design system skill?
It is a SKILL.md in the alirezarezvani skills repo that guides an AI coding agent through design tokens, component architecture, responsive scales and developer handoff. It includes a Python script that generates a token set from a brand color.
How do I install the UI design system skill?
Add the repo as a plugin marketplace with the /plugin marketplace add command, then install the product-skills bundle that contains it. The README also gives routes for Codex, Cursor, Gemini CLI and other agents, or you can copy the skill folder by hand.
What does the token generator output?
Given a hex color, a style and a format, it outputs colors, typography, spacing on an 8pt grid, sizing, borders, shadows, animation values, breakpoints and z-index layers. Formats are JSON, CSS variables, SCSS variables or a summary view.
Does it work with Tailwind?
The handoff workflow includes a Tailwind config example that reads the generated JSON file for colors and font families. It also shows React with CSS variables and styled-components. For a Tailwind focused alternative see tailwind-design-system.
Does it check accessibility?
It lists WCAG AA and AAA contrast ratios and tells the agent to validate that colors meet AA. It is a reference and checklist, not an automated audit, so run a contrast checker on the final palette.
Can I use it with Claude Code, Codex or Cursor?
The repo README states support for Claude Code, Codex, Cursor, Gemini CLI, Copilot and several other agents, each with its own install steps. Check the Quick Install section for the exact route for your tool.
Which skills pair well with it?
Use design-token to name and tier tokens, color-system for deeper palette work and typography-scale for type rules. Each of them covers a single topic that this skill handles in one pass.
Is the skill free and what are its limits?
The repo is MIT licensed. The skill generates presets, so the palette is a starting point rather than a finished brand system, and the README gives no install count for this single skill. Review the output before shipping.


