# design-system-lead

design-system-lead guides agents through building multi-tier design tokens, component architecture, and cross-platform export pipelines.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 262 installs · ★ 1183 repo stars
- Author: borghei
- License: LicenseRef-MIT-Commons-Clause · policy=link-only · description only; the file stays with the author
- Source: https://github.com/borghei/Claude-Skills/tree/HEAD/product-team/design-system-lead/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/design-system-lead

## What it does

This skill configures the coding assistant to act as a design systems lead. Before drafting architecture, it clarifies existing brand palettes, target platforms like web or native mobile, and organizational maturity across four tiers from Emerging to Optimized.

Token architecture follows a strict three-tier layout: raw primitives feed into semantic purpose-driven aliases, which then map into component-level styles. If tokens contain raw hardcoded values instead of referencing primitives, the architecture quickly falls apart; the workflow enforces references at every step. Cross-platform builds rely on Style Dictionary configs for CSS, SCSS, Swift, and Android XML.

Components are structured systematically from basic primitives to composite elements and full navigation patterns. Each component specification requires variants, sizing tiers, interactive states, prop definitions, and accessibility baselines.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill design-system-lead -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill design-system-lead -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill design-system-lead -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install borghei/Claude-Skills product-team/design-system-lead/SKILL.md
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill design-system-lead -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/borghei/Claude-Skills --path product-team/design-system-lead
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill design-system-lead -a opencode
```

### 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/borghei/Claude-Skills/tree/HEAD/product-team/design-system-lead/SKILL.md

## When to use it
- architect a three-tier token system from primitives to component scopes
- generate Style Dictionary configurations for web, iOS, and Android
- write detailed UI component specs with accessibility touch targets
- define a design system contribution model with SemVer governance

## Example prompts
- Set up a three-tier design token architecture for typography and color palettes
- Write a full specification for a Button component including sizes, variants, and a11y criteria
- Create a Style Dictionary configuration to export tokens into CSS variables, Swift, and XML

## Similar
- [design-system-creator](https://affpapa.org/en/nevibecode/skills/design-system-creator.md) — skill · 250 installs
- [ultimate-design-system-master](https://affpapa.org/en/nevibecode/skills/ultimate-design-system-master.md) — skill · ★ 141 repo stars
- [design-system-architect](https://affpapa.org/en/nevibecode/agents/design-system-architect.md) — subagent · ★ 42780 repo stars
- [design-system-engineer](https://affpapa.org/en/nevibecode/agents/design-system-engineer.md) — subagent · ★ 489 repo stars
- [figma-generate-library](https://affpapa.org/en/nevibecode/skills/openai-figma-generate-library.md) — skill · 3000 installs
- [craft-system](https://affpapa.org/en/nevibecode/skills/craft-system.md) — skill · ★ 393 repo stars

From the same set: [borghei/claude-skills](https://affpapa.org/en/nevibecode/by/borghei/claude-skills.md) — 120 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
