# ux-design-systems

ux-design-systems guides the agent in structuring design tokens, building UI components, and configuring dark mode. Useful when creating a frontend component library.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 301 repo stars
- Author: hoodini
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/hoodini/ai-agents-skills/tree/HEAD/skills/ux-design-systems/SKILL.md
- Updated: 2026-10-23
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/ux-design-systems

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add hoodini/ai-agents-skills --skill ux-design-systems -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/ux-design-systems/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/ux-design-systems/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add hoodini/ai-agents-skills --skill ux-design-systems -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/ux-design-systems/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add hoodini/ai-agents-skills --skill ux-design-systems -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/ux-design-systems/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install hoodini/ai-agents-skills skills/ux-design-systems
```

2. **Manually: put the files in place**
- File: `.github/skills/ux-design-systems/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add hoodini/ai-agents-skills --skill ux-design-systems -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/hoodini/ai-agents-skills --path skills/ux-design-systems
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/ux-design-systems/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/hoodini/ai-agents-skills/tree/HEAD/skills/ux-design-systems/SKILL.md

## When to use it
- 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
- 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

## Similar
- [tailwindcss-advanced-design-systems](https://affpapa.org/en/nevibecode/skills/tailwindcss-advanced-design-systems.md) — skill · 659 installs
- [design-tokens](https://affpapa.org/en/nevibecode/skills/design-tokens.md) — skill · 6300 installs
- [design-systems](https://affpapa.org/en/nevibecode/skills/design-systems.md) — skill · 956 installs
- [styling](https://affpapa.org/en/nevibecode/rules/maxtrigify-styling.md) — rule · ★ 141 repo stars
- [ui-design](https://affpapa.org/en/nevibecode/skills/mblode-ui-design.md) — skill · 1600 installs
- [design-system](https://affpapa.org/en/nevibecode/skills/oakoss-design-system.md) — skill · 160 installs

From the same set: [hoodini/ai-agents-skills](https://affpapa.org/en/nevibecode/by/hoodini/ai-agents-skills.md) — 34 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
