Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add borghei/Claude-Skills --skill design-auditor -a claude-code
Open on GitHub

What 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.json against WCAG AA and suggest fixes
  • Validate page.css against tokens.json and return the compliance rate

How to install design-auditor

1Skills CLI (Vercel)

npx skills add borghei/Claude-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 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.

From the same set120

The whole set →
interview-system-designer interview-system-designer — a skill for Claude Code and five other platforms that builds structured interview loops, writes questions with scoring rubrics, and runs calibration analysis on past results. CX Codex +1 137installs devops-workflow-engineer devops-workflow-engineer generates GitHub Actions workflows, analyzes pipelines for bottlenecks and builds deployment plans with strategy selection. CX Codex +1 136installs skill-tester skill-tester — a skill for Claude Code validates skill packages, runs Python checks, and scores quality. It fits workflows for building, auditing, or publishing a skill. CX Codex +1 136installs risk-management-specialist risk-management-specialist — a skill for medical device risk management under ISO 14971:2019: planning, hazard analysis, risk control and post-production monitoring. CX Codex +1 136installs jira-expert jira-expert — a skill for Claude Code and five other platforms guides Jira configurations, JQL construction, and automation rules. It handles offline audits of board exports and task quality. CX Codex +1 133installs senior-secops senior-secops is a Claude Code skill that scans code for vulnerabilities, checks dependencies for CVEs and reviews SOC 2, PCI-DSS, HIPAA and GDPR controls before a release or audit. CX Codex +1 133installs ad-creative ad-creative designs ad copy and headlines calibrated to specs for Google, Meta, LinkedIn, Twitter/X, and TikTok. Useful for assembling split tests and campaign ad sets. CX Codex +1 133installs release-manager release-manager — a skill for Claude Code, Codex, Cursor, Copilot and Gemini CLI that turns git log output or a JSON plan into a changelog, a SemVer bump and a release readiness score. Run it before every release or hotfix. CX Codex +1 132installs

Project sponsors

Companies that keep this analytics open