design-auditor · borghei — Claude Code skill: UI grading, CI gates
design-auditor is a Claude Code skill that grades a UI on three A–F scales: design, AI slop, and accessibility.
LicenseRef-MIT-Commons-Clause 133 installs ★ 1,183 updated 2026-11-08
npx skills add borghei/Claude-Skills --skill design-auditor -a claude-codeWhat design-auditor 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.
What it helps with
- 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 for the agent
- Audit this page and give me the three grades with prioritised findings
- Check the color pairs in
colors.jsonagainst WCAG AA and suggest fixes - Validate
page.cssagainsttokens.jsonand return the compliance rate
How to install design-auditor
1Skills CLI (Vercel)
npx skills add borghei/Claude-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 borghei/Claude-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 borghei/Claude-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 borghei/Claude-Skills engineering/design-auditor/SKILL.md2Manually: put the files in place
.github/skills/design-auditor/SKILL.md1Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill design-auditor -a gemini-cli2Platform CLI
gemini skills install https://github.com/borghei/Claude-Skills --path engineering/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 borghei/Claude-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 borghei/Claude-Skills --skill design-auditor -a claude-code. The skill lands at ~/.claude/skills/design-auditor/SKILL.md.
What does design-auditor do?
Audits a web UI and returns three letter grades: Design, AI Slop and Accessibility. Contrast, token compliance and slop patterns are checked by scripts and can act as CI gates.
How is it different from interface-refinement?
design-auditor only measures and reports, it never edits the UI. Fixes belong to engineering/interface-refinement, which has its own commands per pattern type and its own detector, ui_slop_detector.py.
Similar skills
All skills for Design →design-auditor by other authors comes first.