SKIP TO CONTENT

UI/UX Suite

  • Plugin
  • Skill
  • MCP server
  • CLI

Design bugs by line number, each with the exact fix.

  • Exact line to fix

    46 located findings on the test app, each with a file and a line.

  • WCAG rule cited

    Checked against the Web Content Accessibility Guidelines (WCAG) 2.2.

  • Fix value given

    Each finding shows the measured value and the exact change to make.

Works with: Any MCP (Model Context Protocol) client and any agent that reads skills. Tested: Claude Code, Cursor, Codex, Gemini CLI, OpenCode. Not tied to one model: the audit is plain code.

Try it with no install: npx ui-ux-suite . in your project.

Pick your agent

npx skills add Aboudjem/ui-ux-suite -g

Works in more than 70 agents: pick yours in the menu. Supported agents (new tab)Installs for all your projects. Only this project: drop -g.This installs the skills only. The MCP server is one more line: pick your agent.Its page on skills.sh (new tab)

Limit: The audit reads source code, not pixels.

github.com/Aboudjem/ui-ux-suite (new tab)Version 0.7.3

What it does

  • Know exactly what to change. Each located finding has a file, a line, a value and a fix.
  • Fix for the right reason. Each finding cites the Web Content Accessibility Guidelines (WCAG) rule or the design law behind it.
  • See it work first. The broken test project gives 46 located findings.
  • Keep your code safe. It reads your source and never edits it.
  • Stop regressions. --fail-under fails the build when the score drops.

How it works

  1. 1. Point it at a project folder. There is no config file and no setup step.
  2. 2. Read the ranked list of findings and the score.
  3. 3. Apply each fix yourself: the tool prints it and changes none of your source files.
  4. 4. Add it to your automated checks with a score bar or a baseline file.

Example

One finding from the README. It comes from a broken test project that ships in the repository.

$ npx ui-ux-suite test/fixtures/planted-ux-problems

- Where: src/styles.css:14 · selector .hero-subtitle
- Measured: 1.03:1 (APCA Lc 0) (needs 4.5:1)
- Why: Text #fbfbfb on #ffffff measures 1.03:1 (APCA Lc 0).
       WCAG 2.2 §1.4.3 requires ≥ 4.5:1 for normal text.
- Fix: Change color on .hero-subtitle from #fbfbfb to #767676
       (meets 4.5:1 on #ffffff), or darken further.
- Cites: WCAG 1.4.3 Contrast (Minimum) (AA)

More ways to install

Claude Code plugin

claude plugin marketplace add Aboudjem/10x
claude plugin install ui-ux-suite@10x

Agent skill, for Cursor, Codex and other agents

npx skills add Aboudjem/ui-ux-suite

MCP (Model Context Protocol) server

claude mcp add ui-ux-suite -- npx -y ui-ux-suite --mcp

Command line, with no install step

npx ui-ux-suite .

As a dev dependency

npm install -D ui-ux-suite

Limits

  • It reads source, not pixels. A high score is not proof of WCAG conformance.
  • Some findings cover the whole project, such as too many fonts. They have no single line.
  • Deep mode checks the running app. It is optional and needs two extra packages.
  • It writes only the report and baseline files you ask for.
Good for
A measured design and accessibility check on a web project, in chat or in automated checks.
Not for
Fixing the code for you: it prints the change and you apply it.

Questions

What is UI/UX Suite?

UI/UX Suite is an open-source design audit tool. It works like a linter for design: each located finding has a file, a line, a measured value and a fix.

Which agents does UI/UX Suite work with?

Tested on 17 November 2026: Claude Code, Cursor, Codex, Gemini CLI and OpenCode. The MCP server works in any MCP client, and the command line needs no agent.

Does UI/UX Suite change my code?

No, it never modifies a source file in the project you point it at. A fix is printed for you to apply.

Is UI/UX Suite free?

Yes, it is open source under the MIT license. It needs no API key, and npm view ui-ux-suite dependencies prints nothing.