use-design-system
Explicitly 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.
How do I install this agent skill?
npx skills add https://github.com/bluzir/claude-code-design --skill use-design-systemIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill loads design system configuration from a global user directory into the local project. It is generally safe but presents minor risks related to processing external JSON data and using user-provided names in shell commands.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Use Design System
Load an org-level design system from ~/.claude/design-systems/<name>/ into the current project.
Steps
-
If
$0(name) is missing →Bash(ls ~/.claude/design-systems/ 2>/dev/null)and show the list, ask which one. -
Verify the folder exists:
Bash(test -d ~/.claude/design-systems/$0 && echo ok || echo missing). If missing → tell the user, list what's available, stop. -
Read the tokens file:
Read ~/.claude/design-systems/$0/tokens.json -
Copy to project-level for faster subsequent reads:
Bash(mkdir -p .claude) Bash(cp ~/.claude/design-systems/$0/tokens.json .claude/design-tokens.json) -
If
~/.claude/design-systems/$0/preview.htmlexists, 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. -
Report: "Loaded design system
$0— colors, fonts, spacing, radii written to.claude/design-tokens.json. Subsequent/make-deck,/interactive-prototype,/wireframewill use it automatically."
When to NOT use this skill
- User is extracting a new system from a codebase / screenshot / Figma → use
/create-design-systeminstead - User explicitly said "ignore existing, I want something fresh" → route to
/create-design-systemwith "from scratch" mode
Registry format reminder
~/.claude/design-systems/
├── acme/
│ ├── tokens.json # required
│ └── preview.html # optional
├── company-x/
│ └── tokens.json
└── minimal-mono/
└── tokens.json
tokens.json schema:
{
"name": "acme",
"colors": { "primary": "#D97757", "accent": "...", "bg": "...", "text": "..." },
"fonts": { "display": "...", "body": "...", "mono": "..." },
"spacing": [4, 8, 12, 16, 24, 32, 48, 64],
"radii": { "sm": 4, "md": 8, "lg": 16 },
"shadows": [...]
}
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/bluzir/claude-code-design/use-design-system">View use-design-system on skillZs</a>