ux-design-systems — Claude Code skill: what it does, how to install
ux-design-systems guides the agent in structuring design tokens, building UI components, and configuring dark mode. Useful when creating a frontend component library.
no license ★ 301 updated 2026-10-23
npx skills add hoodini/ai-agents-skills --skill ux-design-systems -a claude-codeWhat ux-design-systems does
This skill guides Claude Code in structuring user interface design systems. It provides setups for design tokens using root CSS variables and strongly typed TypeScript maps for colors, margins, font sizes, and border radii.
Component patterns rely on class-variance-authority (CVA). Using a modular button as a blueprint, it demonstrates how to handle sizing, visual variants, disabled states, and loader indicators without CSS conflicts.
The theming setup employs a React Context provider coupled with the data-theme HTML attribute. It handles manual switches alongside system-level preferences via prefers-color-scheme. Replicating the component examples requires installing the class-variance-authority package.
What it helps with
- structure design tokens across CSS variables and TypeScript
- build variant-driven UI components with class-variance-authority
- implement a React theme provider supporting dark and system modes
- keep typography and spacing scales consistent across a project
Example prompts for the agent
- Set up a TypeScript token structure for our spacing and color scale
- Create a button component with size variants using class-variance-authority
- Write a React ThemeProvider that syncs with prefers-color-scheme
How to install ux-design-systems
1Skills CLI (Vercel)
npx skills add hoodini/ai-agents-skills --skill ux-design-systems -a claude-code2Manually: put the files in place
~/.claude/skills/ux-design-systems/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/ux-design-systems/
1Skills CLI (Vercel)
npx skills add hoodini/ai-agents-skills --skill ux-design-systems -a codex2Manually: put the files in place
.agents/skills/ux-design-systems/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add hoodini/ai-agents-skills --skill ux-design-systems -a cursor2Manually: put the files in place
.cursor/skills/ux-design-systems/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install hoodini/ai-agents-skills skills/ux-design-systems2Manually: put the files in place
.github/skills/ux-design-systems/SKILL.md1Skills CLI (Vercel)
npx skills add hoodini/ai-agents-skills --skill ux-design-systems -a gemini-cli2Platform CLI
gemini skills install https://github.com/hoodini/ai-agents-skills --path skills/ux-design-systemsManually: put the files in place
.devin/skills/ux-design-systems/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about ux-design-systems
How to install ux-design-systems in Claude Code?
Run npx skills add hoodini/ai-agents-skills --skill ux-design-systems -a claude-code or place the file directly at ~/.claude/skills/ux-design-systems/SKILL.md.
What does the ux-design-systems skill do?
It teaches Claude Code consistent conventions for generating design tokens, variant-driven UI elements, and theme switching.
Which packages are needed for the component patterns?
The component blueprint depends on the class-variance-authority library alongside utility CSS styling.