design-auditor

design-auditor is an agent for Claude Code from Aboudjem/ui-ux-suite. It costs 25 tokens per session (1,272 once invoked), scanned A, original, MIT.

An orchestrator that audits a project's user interface and user experience by examining its files and coordinating specialized checks.

In plain words
What is it for?
Use it to assess an application's interface, identify design problems, and combine findings from relevant design reviewers.
Why use it?
It gathers different design checks into one report instead of requiring a separate manual review of each area.

Agent for Claude Code

Written for Claude Code: a Claude Code subagent (agents/*.md).

Part of the ui-ux-suite plugin — 14 skills, 5 commands, 12 agents, 1 MCP server shipped together

Good fit Use it to assess an application's interface, identify design problems, and combine findings from relevant design reviewers.

Compare 6 agents from other repositories ↓
Install with agentmods
npx agentmods add agents/aboudjem/ui-ux-suite/design-auditor
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Clone the repo
git clone --depth 1 https://github.com/Aboudjem/ui-ux-suite

Made for: Claude Code.

Or install ui-ux-suite, the plugin that ships this one along with the rest of its 14 skills, 5 commands, 12 agents, 1 MCP server.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for design-auditor

README.md
[![agentmods](https://agentmods.dev/badge/agents/aboudjem/ui-ux-suite/design-auditor.svg)](https://agentmods.dev/agents/aboudjem/ui-ux-suite/design-auditor)
Your own site
<a href="https://agentmods.dev/agents/aboudjem/ui-ux-suite/design-auditor"><img src="https://agentmods.dev/badge/agents/aboudjem/ui-ux-suite/design-auditor.svg" alt="Measured on agentmods" height="20"></a>
Per session 25 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,272 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00025 $0.01272
Opus 5 $0.00013 $0.00636
Sonnet 5 $0.00005 $0.00254
Haiku 4.5 $0.00003 $0.00127

Measured 8d ago against content hash 1048f76615f1, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade A, and why

design-auditor scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

agents/design-auditor.md · 131 lines

How it starts

The opening of the file, as written. The whole thing — 131 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Design Auditor: Master Orchestrator

You are the lead design intelligence agent. Your job is to audit any project's UI/UX quality by reading its actual files and producing a structured, opinionated assessment.

Required Reading

Before every audit, read these knowledge files to inform your analysis:

  • knowledge/principles.md - Core design principles and heuristics
  • knowledge/evidence-base.md - 30+ quantified research findings with confidence levels
  • knowledge/anti-patterns.md - Common design mistakes to watch for
  • knowledge/trends-2026.md - Modern CSS features and current best practices
  • knowledge/insider-secrets-2026.md - Practitioner tips from experienced designers
  • knowledge/laws-of-ux.md - The 24 Laws of UX with concrete violation/fix examples

Use the Read tool to load each file. These documents contain the evidence base that backs every score and recommendation you produce.

How you work

  1. Detect - Scan the project to understand what you're working with
  2. Dispatch - Route specialized agents in parallel based on what the project has
  3. Aggregate - Combine all findings into a unified report with overall score

Step 1: Project Detection

Scan the project and identify:

  • Framework: React, Next.js, Vue, Nuxt, Svelte, Angular, React Native, Flutter, vanilla
  • Styling: Tailwind, CSS Modules, styled-components, SCSS, CSS-in-JS, vanilla CSS
  • Component library: shadcn/ui, MUI, Chakra, Ant Design, Radix, Mantine, Headless UI, custom, none
  • Theme system: CSS variables, Tailwind config, design token files, ThemeProvider, none
  • Dark mode: Present or absent
  • Design maturity: Early (random values), Developing (some system), Mature (clear system)

Use uiux_scan_project tool and supplement with file reading:

  • Read package.json for dependencies
  • Check for tailwind.config.*, components.json, tokens.json
  • Read globals.css, app.css, or root CSS file for CSS variables
  • Check for theme.* files

Read the full file on GitHub · 131 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 8d ago First seen · 131 lines · 25 tokens per session scan A 1048f76615f1

Subscribe to this mod's changes

design-auditor is an agent published in the GitHub repository Aboudjem/ui-ux-suite (7 stars, last pushed yesterday), licensed MIT. It adds 25 tokens to every session and 1,272 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other agents, from other repositories

ui-designer

Designs a screen, flow, or component from a brief — establishing hierarchy, layout, tokens, states, and motion before (or instead of) writing code. Use when the user wants design direction, a structured spec, or a thoughtfully composed interface rather than just raw code. Pairs with the frontend-implementer agent for…

ca-who-codes/ultimate.UIUX.design.skills · 73 tokens

design-reviewer

Rigorously audits an existing UI (code, screenshot, or live page) against the UI/UX Design Pro knowledge base and returns prioritized, specific findings. Use when the user asks to "review", "critique", "audit", or "improve" an interface, or before shipping. Defaults to finding concrete issues — vague praise is a…

ca-who-codes/ultimate.UIUX.design.skills · 76 tokens

visual-designer

Designs and produces fixed-canvas visual & marketing collateral — presentations/decks, social carousels and posts, ads, A4/A3 posters, flyers, brochures, business cards, event banners/signage, email/newsletters, infographics, and brand kits. Use when the user wants a deck, carousel, creative, poster, or email — not an…

ca-who-codes/ultimate.UIUX.design.skills · 99 tokens

frontend-implementer

Builds production-quality, accessible UI code from a design or brief using the recommended modern stack (React + TypeScript + Tailwind v4 + shadcn/ui + Radix + Motion). Use when the user wants the actual component/page code, not just design direction. Produces clean, typed, accessible, state-complete components.

ca-who-codes/ultimate.UIUX.design.skills · 73 tokens

frontend-designer

Use this agent when you need to convert design mockups, wireframes, or visual concepts into detailed technical specifications and implementation guides for frontend development. This includes analyzing UI/UX designs, creating design systems, generating component architectures, and producing comprehensive documentation…

andisab/swe-marketplace · 356 tokens

design-reviewer

Use to audit UI code (SwiftUI, UIKit, AppKit, React/React Native, Flutter, HTML/CSS, etc.) against Apple's Human Interface Guidelines and report concrete violations. Invoke when the user asks to review/check/audit a screen, view, component, or stylesheet for HIG compliance, accessibility, or design-token correctness …

Elevatormusic/apple-hig · 102 tokens