Skip to main content
skill CX Codex

design-auditor · podo — Claude Code skill: what it does, how to install

design-auditor scores a UI across 19 categories, from typography to dark mode, and returns a 0-100 rating with issues ranked by severity.

MIT 227 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 design-auditor -a claude-code
Open on GitHub

What design-auditor does

Point it at a page and it walks through 19 review categories: type, contrast, spacing, hierarchy, consistency, WCAG, forms, motion, dark mode, responsive layout, loading, empty and error states, microcopy, i18n and RTL, shadows, icons, navigation, design tokens, dark patterns and Nielsen's heuristics. You get a score out of 100 plus a list of problems ordered by how much they hurt.

It reads source code (HTML, CSS, React, Vue, Tailwind) or a screenshot. A Figma link only works when the Figma MCP server is connected; otherwise the skill asks for a screenshot or code. Answers come back in English or Korean, following the language of your request.

The whole thing lives in one SKILL.md of roughly 160 KB, so triggering it eats a fair chunk of context. For a narrow accessibility pass reach for fixing-accessibility instead, and for WCAG compliance write-ups use wcag-audit-patterns.

What it helps with

  • score a page against 19 design categories before release
  • catch contrast and typography problems early
  • review loading, empty and error states
  • flag dark patterns and ethical design issues
  • check RTL and responsive behaviour

Example prompts for the agent

  • Run a design audit on src/pages/Checkout.tsx and checkout.png.
  • Give this dashboard a design score and list the issues by severity.
  • Check the dark mode contrast in dashboard-dark.png.

How to install design-auditor

1Skills CLI (Vercel)

npx skills add podo/design-agent-skills --skill design-auditor -a claude-code

2Manually: put the files in place

~/.claude/skills/design-auditor/SKILL.md

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

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about design-auditor

How do I install design-auditor in Claude Code?

Run npx skills add podo/design-agent-skills --skill design-auditor -a claude-code. The skill lands at ~/.claude/skills/design-auditor/SKILL.md.

What does design-auditor do?

It reviews a design against 19 categories and returns a 0-100 score with issues sorted by severity. Code, screenshots and Figma links are all accepted.

Do I need the Figma MCP server?

Only to audit Figma links. Without it the skill asks for a screenshot or code instead.

Source text

SKILL.md · MIT
---
name: design-auditor
description: |
  Audits designs across 19 professional categories including typography, color/contrast, spacing, visual hierarchy, consistency, WCAG, forms, motion, dark mode, responsive, loading/empty/error states, microcopy, i18n/RTL, elevation, iconography, navigation, design tokens, ethical design/dark patterns, and Nielsen heuristics. Scores 0-100 with severity-ranked issues.
triggers:
  - "design audit"
  - "design score"
  - "19 categories"
  - "design-auditor"
  - "design quality check"
das:
  type: skill
  category: interaction-polish
  upstream: "https://github.com/Ashutos1997/claude-design-auditor-skill"
  upstream_path: "SKILL.md"
  version: latest
  install: true
---

# design-auditor

> Catalogue stub — full skill: [Ashutos1997/claude-design-auditor-skill](https://github.com/Ashutos1997/claude-design-auditor-skill)

<!-- 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/design-auditor/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"`
   - Project: `f=.agents/skills/design-auditor/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"`
   - `installed` → the skill is installed as `design-auditor`, invoke it and proceed
   - `pointer` → go to step 2

2. **Detect scope, then install:**

   ```bash
   [ -e ~/.agents/skills/design-auditor ] && echo "global" || echo "project"
   ```

   **Global:**
   ```bash
   npx skills add Ashutos1997/claude-design-auditor-skill --skill design-auditor -g -y
   ```

   **Project:**
   ```bash
   npx skills add Ashutos1997/claude-design-auditor-skill --skill design-auditor -y
   ```
   > **Claude Code:** send a command as a chat message starting with `!` to run it without leaving the conversation.

**Heads-up**

- **Requires:** Figma MCP server (optional, only to audit Figma links; without it the skill asks for a screenshot or code)
- **License:** no LICENSE file in the repo
<!-- das:install:end -->

## Invoke after install

- Skill name: `design-auditor`
- Trigger phrases: "design audit", "design score", "19 categories", "design-auditor", "design quality check"

## What it does

Comprehensive design audit skill that evaluates designs across 19 professional categories: typography, color/contrast, spacing, visual hierarchy, consistency, WCAG accessibility, forms, motion/animation, dark mode, responsive design, loading states, empty states, error states, microcopy, i18n/RTL support, elevation/shadows, iconography, navigation, design tokens, ethical design and dark patterns, and Nielsen heuristics. Produces a 0-100 score with issues ranked by severity so the most impactful problems surface first. Audits code (HTML, CSS, React, Vue, Tailwind) and screenshots, and Figma links when the Figma MCP server is connected. Replies in English or Korean to match the request. The upstream SKILL.md is large (about 160 KB), so expect a heavy context load when it triggers.

## When NOT to use

- Accessibility-only audits — use `fixing-accessibility` for a focused WCAG pass
- WCAG-specific compliance documentation — use `wcag-audit-patterns`

© podo · MIT · podo/design-agent-skills

Similar skills

All skills for Design →

design-auditor by other authors comes first.

From the same set108

The whole set →
mobile-app-design mobile-app-design — a reference skill for mobile UI work: Apple HIG, Material 3, WCAG accessibility, thumb zones and adaptive layouts. Useful when a screen needs review before release. CX Codex +1 242installs awesome-design-skills awesome-design-skills is a Claude Code skill that gives an agent one visual style, such as glassmorphism or editorial, for UI work. CX Codex +1 239installs sleek-design-mobile-apps sleek-design-mobile-apps is a Claude Code skill that builds mobile app screens from a brief in Sleek. It can then implement the design in React Native or HTML. CX Codex +1 231installs design-tokens-skill The design-tokens-skill skill covers W3C DTCG token architecture, color spaces, aliases, theme resolution, and token tooling. Use it when building or migrating a token pipeline. CX Codex +1 227installs copywriting-skill A copywriting skill for landing pages, product pages, pricing, emails, and CTAs. Use it when marketing copy needs clearer persuasion without common AI writing habits. CX Codex +1 227installs motion-catalogue motion-catalogue — a router skill for animation, 3D and generative media work: it picks the matching skill from the catalogue and sends you there. CX Codex +1 225installs brand-design-md brand-design-md pulls design specs for brands like Stripe, Linear, and Notion from getdesign.md and applies their styling to UI code. CX Codex +1 224installs addyosmani-quality addyosmani-quality runs measurement-first web quality audits across Core Web Vitals, WCAG 2.2 accessibility, SEO, and runtime performance. CX Codex +1 224installs

Project sponsors

Companies that keep this analytics open