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
npx skills add podo/design-agent-skills --skill design-auditor -a claude-codeWhat 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.tsxandcheckout.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-code2Manually: put the files in place
~/.claude/skills/design-auditor/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/design-auditor/
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill design-auditor -a codex2Manually: put the files in place
.agents/skills/design-auditor/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill design-auditor -a cursor2Manually: put the files in place
.cursor/skills/design-auditor/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install podo/design-agent-skills skills/design-auditor2Manually: put the files in place
.github/skills/design-auditor/SKILL.md1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill design-auditor -a gemini-cli2Platform CLI
gemini skills install https://github.com/podo/design-agent-skills --path skills/design-auditorManually: put the files in place
.devin/skills/design-auditor/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill design-auditor -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 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.