$npx -y skills add bluzir/claude-code-design --skill use-design-systemExplicitly load a design system from the org-level registry at ~/.claude/design-systems/<name>/ for the current project. Use when user says "use the Acme design system", "apply company-x tokens", or similar.
| 1 | # Use Design System |
| 2 | |
| 3 | Load an org-level design system from `~/.claude/design-systems/<name>/` into the current project. |
| 4 | |
| 5 | ## Steps |
| 6 | |
| 7 | 1. If `$0` (name) is missing → `Bash(ls ~/.claude/design-systems/ 2>/dev/null)` and show the list, ask which one. |
| 8 | |
| 9 | 2. Verify the folder exists: |
| 10 | `Bash(test -d ~/.claude/design-systems/$0 && echo ok || echo missing)`. |
| 11 | If missing → tell the user, list what's available, stop. |
| 12 | |
| 13 | 3. Read the tokens file: |
| 14 | `Read ~/.claude/design-systems/$0/tokens.json` |
| 15 | |
| 16 | 4. Copy to project-level for faster subsequent reads: |
| 17 | ``` |
| 18 | Bash(mkdir -p .claude) |
| 19 | Bash(cp ~/.claude/design-systems/$0/tokens.json .claude/design-tokens.json) |
| 20 | ``` |
| 21 | |
| 22 | 5. If `~/.claude/design-systems/$0/preview.html` exists, offer to open it for visual reference via `/preview ~/.claude/design-systems/$0/preview.html` — lets the user remember what the system looks like before starting work. |
| 23 | |
| 24 | 6. Report: "Loaded design system `$0` — colors, fonts, spacing, radii written to `.claude/design-tokens.json`. Subsequent `/make-deck`, `/interactive-prototype`, `/wireframe` will use it automatically." |
| 25 | |
| 26 | ## When to NOT use this skill |
| 27 | |
| 28 | - User is extracting a **new** system from a codebase / screenshot / Figma → use `/create-design-system` instead |
| 29 | - User explicitly said "ignore existing, I want something fresh" → route to `/create-design-system` with "from scratch" mode |
| 30 | |
| 31 | ## Registry format reminder |
| 32 | |
| 33 | ``` |
| 34 | ~/.claude/design-systems/ |
| 35 | ├── acme/ |
| 36 | │ ├── tokens.json # required |
| 37 | │ └── preview.html # optional |
| 38 | ├── company-x/ |
| 39 | │ └── tokens.json |
| 40 | └── minimal-mono/ |
| 41 | └── tokens.json |
| 42 | ``` |
| 43 | |
| 44 | `tokens.json` schema: |
| 45 | ```json |
| 46 | { |
| 47 | "name": "acme", |
| 48 | "colors": { "primary": "#D97757", "accent": "...", "bg": "...", "text": "..." }, |
| 49 | "fonts": { "display": "...", "body": "...", "mono": "..." }, |
| 50 | "spacing": [4, 8, 12, 16, 24, 32, 48, 64], |
| 51 | "radii": { "sm": 4, "md": 8, "lg": 16 }, |
| 52 | "shadows": [...] |
| 53 | } |
| 54 | ``` |