Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add podo/design-agent-skills --skill work-with-design-systems -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/work-with-design-systems/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/work-with-design-systems/

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

Similar skills

All skills for Design →
ultimate-design-system-master ft.ia.br ultimate-design-system-master guides users through an 18-step briefing questionnaire to produce design systems, brand assets, and UI code across 10 specialized generators. CX Codex +1 ★ 141repo stars frontend-design-review DauQuangThanh frontend-design-review audits UI mockups, design tokens, and components for WCAG 2.1 AA accessibility, responsive behavior, and design system consistency before engineering begins. CX Codex +1 463installs figma-generate-library official openai figma-generate-library — a skill to sync your Figma design system with your codebase. Build or update variables, components, themes, and documentation in the right order—phases matter, and skipping steps breaks the system. CX Codex +1 3,000installs tailwindcss-advanced-design-systems JosiahSiegel tailwindcss-advanced-design-systems is a Claude Code skill for building Tailwind v4 design systems. It activates for @theme setup, token workflows, and brand-specific themes. CX Codex +1 659installs figma-designer elayadesign figma-designer — a skill for Claude Code that enforces design system rules when editing Figma files through the Figma MCP. Runs when creating screens, components, tokens, or handling Figma links. CX Codex +1 2,900installs figma-create-design-system-rules official openai figma-create-design-system-rules — a skill for Claude Code, Codex, Cursor and other agents that generates project-specific design system rules by reading your codebase. CX Codex +1 3,200installs

From the same set108

The whole set →
vercel-skills Pulls in five official Vercel skills: interface review against the Web Interface Guidelines, a writing check, React/Next.js performance, component composition, and View Transitions. CX Codex +1 213installs css-animation-skill This skill studies an app in the browser and builds a standalone HTML/CSS animation for one of its features. Use it for demos, walkthroughs, or onboarding. CX Codex +1 213installs generative-media-skills generative-media-skills is a Claude Code skill that turns creative briefs into muapi.ai calls for directed video, product ads, logos, UI mockups and social covers. CX Codex +1 212installs design-sprint The design-sprint skill researches a codebase, drafts a feature plan, and proposes a parent issue with dependent sub-issues. It creates GitHub or Backlog issues only after you approve the content. CX Codex +1 212installs liquid-glass-skill Guides SwiftUI interface development with Apple's Liquid Glass styling for iOS 26 and macOS 26. Helps set up modifiers, grouped glass layers, and UI migrations. CX Codex +1 212installs taste-design-stitch taste-design-stitch builds tailored DESIGN.md files for Google Stitch to guide UI screens away from generic AI aesthetics. CX Codex +1 211installs wiggle-claude-skill wiggle-claude-skill turns a static PNG, SVG or JPG logo into Lottie JSON, then renders it as a GIF and an MP4 and checks that the loop joins cleanly. CX Codex +1 211installs d3js-skill d3js-skill guides an agent through building custom D3.js charts and interactive visuals. Useful when a standard chart library cannot express the design you need. CX Codex +1 211installs

Project sponsors

Companies that keep this analytics open