work-with-design-systems — Claude Code skill: audit, install
The work-with-design-systems skill reviews Figma design systems and guides their phased creation. Use it for WCAG checks, component readiness scoring, and developer handoff documents.
MIT 212 installs ★ 35 updated 2026-10-21
npx skills add podo/design-agent-skills --skill work-with-design-systems -a claude-codeWhat work-with-design-systems does
The skill has two modes. Inspect mode performs a read-only review of a Figma design system, covering token use, interactive states, WCAG accessibility, detached instances, naming, and component descriptions. It produces a weighted readiness score and handoff documentation, then pauses for a decision before any build work begins.
Build mode guides system creation in phases, including variable bindings, slot-based components, and structured descriptions. An optional final phase can export tokens.css and AI-readable rules into the codebase, but it runs only after an explicit request. The figma-use skill and a connected Figma MCP server are required, and figma-use must run before every use_figma call. Without them, the skill cannot operate on Figma.
What it helps with
- audit a Figma system against WCAG
- detect detached component instances
- score readiness across tokens and components
- prepare developer handoff documentation
- build a Figma system with variables and slots
Example prompts for the agent
- Run a Figma inspect mode audit for this design system and check its WCAG issues.
- Review token usage, component states, and detached instances, then give me the readiness score.
- Build this Figma design system in phases and bind its components to variables.
How to install work-with-design-systems
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill work-with-design-systems -a claude-code2Manually: put the files in place
~/.claude/skills/work-with-design-systems/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/work-with-design-systems/
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill work-with-design-systems -a codex2Manually: put the files in place
.agents/skills/work-with-design-systems/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill work-with-design-systems -a cursor2Manually: put the files in place
.cursor/skills/work-with-design-systems/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install podo/design-agent-skills skills/work-with-design-systems2Manually: put the files in place
.github/skills/work-with-design-systems/SKILL.md1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill work-with-design-systems -a gemini-cli2Platform CLI
gemini skills install https://github.com/podo/design-agent-skills --path skills/work-with-design-systemsManually: put the files in place
.devin/skills/work-with-design-systems/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill work-with-design-systems -a opencodeClaude.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 work-with-design-systems
How do I install work-with-design-systems in Claude Code?
Run npx skills add podo/design-agent-skills --skill work-with-design-systems -a claude-code, then check ~/.claude/skills/work-with-design-systems/SKILL.md.
What does work-with-design-systems do?
It audits Figma design systems in Inspect mode and guides phased creation in Build mode. On request, it can also export tokens.css and AI-readable rules.
What does the skill need to work with Figma?
It requires the figma-use skill and a connected Figma MCP server. The skill must invoke figma-use before each use_figma call.
Source text
SKILL.md · MIT
--- name: work-with-design-systems description: | Two-mode Figma design system skill — Inspect mode (read-only WCAG audit, component scoring, detached-instance detection, handoff docs) and Build mode (phased creation with variable bindings, slots, descriptions), with optional sync to tokens.css + AI rules. Needs the figma-use skill and the Figma MCP server. triggers: - "work with design systems" - "natdexterra" - "Figma inspect mode" - "build design system Figma" - "Figma design system audit" - "WCAG component audit" das: type: skill category: figma-code upstream: "https://github.com/natdexterra/work-with-design-systems" upstream_path: "SKILL.md" version: latest install: true --- # work-with-design-systems > Catalogue stub — full skill: [natdexterra/work-with-design-systems](https://github.com/natdexterra/work-with-design-systems) <!-- das:install:start — generated from stub.yaml by `npm run generate`; edit stub.yaml, not this block --> ## Decision tree 1. **Is the full skill already installed?** - Global: `f=~/.agents/skills/work-with-design-systems/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"` - Project: `f=.agents/skills/work-with-design-systems/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"` - `installed` → the skill is installed as `work-with-design-systems`, invoke it and proceed - `pointer` → go to step 2 2. **Detect scope, then install:** ```bash [ -e ~/.agents/skills/work-with-design-systems ] && echo "global" || echo "project" ``` **Global:** ```bash npx skills add natdexterra/work-with-design-systems --skill work-with-design-systems -g -y ``` **Project:** ```bash npx skills add natdexterra/work-with-design-systems --skill work-with-design-systems -y ``` > **Claude Code:** send a command as a chat message starting with `!` to run it without leaving the conversation. **Heads-up** - **Requires:** The figma-use skill (installed by the figma-official-skills stub) and the remote Figma MCP server connected; the skill must invoke figma-use before every use_figma call; Figma MCP read calls are rate-limited per plan and seat (upstream cites 10 calls/min and 200/day on a Professional Full or Dev seat) - **License:** MIT <!-- das:install:end --> ## Invoke after install - Skill name: `work-with-design-systems` - Needs the `figma-use` skill (from the `figma-official-skills` stub) and a connected Figma MCP server - Triggers: "work with design systems", "Figma inspect mode", "build design system Figma", "WCAG component audit" ## What it does Two operational modes for Figma design systems, auto-detected from your request. **Inspect mode**: read-only analysis with audit modules for token compliance, interactive states, WCAG accessibility, detached instances, naming quality and component descriptions, weighted readiness scoring, and developer handoff documentation. The skill always pauses after inspect and waits for your decision before any build action. **Build mode**: guided phased design system creation covering variable bindings, slot-based component composition and structured component descriptions, with an optional final phase (off by default, only on explicit request) that exports `tokens.css` and AI-readable rules files into your codebase. ## When NOT to use - Single component work not requiring system architecture - General design work without a design system — use `mobile-app-design` or `ui-craft` - Token enforcement during Figma writes — use `claude2figma` - Implementing Figma designs as code — use `figma-official-skills` (its `figma-design-to-code` skill)
© podo · MIT · podo/design-agent-skills