# design-auditor

design-auditor is a Claude Code skill that grades a UI on three A–F scales: design, AI slop, and accessibility.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 133 installs · ★ 1183 repo stars
- Author: borghei
- License: LicenseRef-MIT-Commons-Clause · policy=link-only · description only; the file stays with the author
- Source: https://github.com/borghei/Claude-Skills/tree/HEAD/engineering/design-auditor/SKILL.md
- Updated: 2026-11-08
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/borghei-design-auditor

## What it does

Each audit produces three separate letter grades with prioritised findings.

Four Python scripts do the measuring. `color_contrast_checker.py` computes WCAG 2.x contrast ratios for color pairs, `design_system_validator.py` checks CSS against a token file, `ai_slop_detector.py` flags template patterns such as gradients and three-card grids. `design_scorer.py` aggregates the scores.

The skill measures and reports only. It does not edit the interface: findings go to `engineering/interface-refinement`, which owns a command per pattern type. The contrast checker covers WCAG 2.x (1.4.3 text, 1.4.11 non-text UI). Other WCAG 2.2 criteria are manual checks in a real browser. APCA returns different results for some pairs, so numbers from another tool may not match.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill design-auditor -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/design-auditor/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/design-auditor/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill design-auditor -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/design-auditor/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill design-auditor -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/design-auditor/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install borghei/Claude-Skills engineering/design-auditor/SKILL.md
```

2. **Manually: put the files in place**
- File: `.github/skills/design-auditor/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill design-auditor -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/borghei/Claude-Skills --path engineering/design-auditor
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/design-auditor/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill design-auditor -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/borghei/Claude-Skills/tree/HEAD/engineering/design-auditor/SKILL.md

## When to use it
- grade a UI on design, AI slop and accessibility
- check color pairs against WCAG AA/AAA
- detect AI-slop patterns in HTML and CSS
- validate CSS against design tokens
- gate a PR on contrast and token compliance

## Example prompts
- Audit this page and give me the three grades with prioritised findings
- Check the color pairs in `colors.json` against WCAG AA and suggest fixes
- Validate `page.css` against `tokens.json` and return the compliance rate

## Similar
- [design-accessibility-auditor](https://affpapa.org/en/nevibecode/skills/design-accessibility-auditor.md) — skill · 157 installs
- [critique-color](https://affpapa.org/en/nevibecode/skills/critique-color.md) — skill · 2100 installs
- [design-system](https://affpapa.org/en/nevibecode/skills/affaan-m-design-system.md) — skill · 6800 installs
- [accessibility-auditor](https://affpapa.org/en/nevibecode/skills/accessibility-auditor.md) — skill · 846 installs
- [frontend-ui-engineering](https://affpapa.org/en/nevibecode/skills/frontend-ui-engineering.md) — skill · 85500 installs
- [token-contrast-auditor](https://affpapa.org/en/nevibecode/skills/token-contrast-auditor.md) — skill · ★ 529 repo stars

## Other versions with the same name
- [design-auditor · podo](https://affpapa.org/en/nevibecode/skills/podo-design-auditor.md) — 227 installs

From the same set: [borghei/claude-skills](https://affpapa.org/en/nevibecode/by/borghei/claude-skills.md) — 120 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
