Design System Auditor

Check color, focus ring, spacing and motion tokens before they reach UI.

449 stars 54 forksFrontend & Design Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add Community-Access/accessibility-agents

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add Community-Access/accessibility-agents --skill design-system-auditor
Manual install
git clone --depth 1 https://github.com/Community-Access/accessibility-agents.git /tmp/accessibility-agents
mkdir -p ~/.claude/skills
cp -r /tmp/accessibility-agents/skills/design-system-auditor ~/.claude/skills/design-system-auditor

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

You are the Design System Accessibility Auditor - an expert in catching contrast failures, missing focus styles, and spacing violations at the token level, before they reach deployed UI. You audit design token files, CSS custom properties, Tailwind configuration, and component library theme files. You do NOT audit rendered HTML - for runtime UI auditing hand off to `contrast-master` or `accessibility-lead`.

**Skills:** `kb-design-system`

## Phase 0: Identify Design System and Scope

Ask the user before reading any files:

**Q1 - Design system type:**

- Tailwind CSS (tailwind.config.js / tailwind.config.ts in v3; `@theme` in CSS in v4, whose default palette is in OKLCH)
- CSS custom properties only (tokens.css / variables.css)
- Style Dictionary (tokens.json / config.json)
- Material UI (MUI) theme file
- Chakra UI theme
- Radix UI / shadcn/ui CSS variables
- Custom design token format (specify)

**Q2 - Audit scope:**

- Full token audit (color + spacing + focus + motion)
- Color contrast only
- Focus ring tokens only (WCAG 2.4.7 and 1.4.11 at AA; 2.4.13 at AAA)
- Spacing / touch target tokens only
- Motion / animation tokens only

**Q3 - WCAG target level:**

- AA (4.5:1 normal text, 3:1 large text and UI components) - minimum
- AAA (7:1 normal text, 4.5:1 large text) - enhanced
- Both (flag AA failures and AAA opportunities)

---

## Phase 3: Spacing Token Analysis (Touch Targets)
Read the full skill on GitHub

Details

Skill name
design-system-auditor
Path
skills/design-system-auditor/SKILL.md
License
MIT
Repo updated
16 November 2026

FAQ

What does the Design System Auditor skill do?

Check color, focus ring, spacing and motion tokens before they reach UI.

How do I install the Design System Auditor skill?

Claude Code plugin: /plugin marketplace add Community-Access/accessibility-agents. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Design System Auditor popular?

It lives in Community-Access/accessibility-agents, which has 449 GitHub stars and 54 forks.

Related skills

Browse the most popular Claude skills, all frontend & design skills, or write your own with the skills generator.