For agents · Claude · Cursor · Codex
Give your agents
a UX rubric.
Coding agents ship interfaces faster than anyone can review them. BASIC UX audit is a skill that holds any screen to a shared, objective standard — the five principles of BASIC UX — using Playwright and screenshots so Claude, Cursor, and Codex can score and improve what they build.
$ node assess.mjs https://your-app.com --mobile
BASIC UX audit — your-app.com
Overall 73/100
Beauty 82 ████████████████··········
Accessibility 58 ███████████···············
Simplicity 79 ███████████████···········
Intuitiveness 90 ██████████████████········
Consistency 61 ████████████··············
→ 4 contrast failures · 3 unlabeled inputs · 11 off-grid spacings
→ wrote report.md + screenshots — fix, then re-runWhy
UX that agents can actually measure.
One shared language
Beauty, Accessibility, Simplicity, Intuitiveness, Consistency — a rubric every agent and teammate scores the same way, so reviews stop being opinion fights.
Evidence, not vibes
It reads computed styles: contrast ratios, alt text, labels, tap targets, landmarks, and palette / type / spacing discipline. Each flag cites the number.
Eyes + heuristics
Playwright captures full-page and mobile screenshots so the agent grades composition and hierarchy visually, where rules alone fall short.
Brand-aware
Feed it your style guide and it checks adherence — off-palette colours, stray fonts, the “does it follow the style guide?” question, answered.
How it works
Capture, measure, see, score, fix.
- 01
Capture
Drives a real Chromium via Playwright to load the URL (live or
localhost) and snapshot desktop + mobile. - 02
Measure
Collects computed-style evidence and runs heuristic checks for each principle — WCAG contrast, alt/labels, choice overload, token variance.
- 03
See
Hands the agent the screenshots to grade Beauty and Intuitiveness with real visual judgement.
- 04
Score & fix
Emits a 0–100 scorecard plus ranked fixes in
report.md. Fix the top issues, then re-run to prove the score went up.
The rubric
Five lenses, every audit.
Beauty
Aesthetically pleasing, on style guide, well aligned.
Accessibility
Usable by everyone; meets contrast and standards.
Simplicity
Reduces workload; free of clutter and overload.
Intuitiveness
Learnable with familiar patterns and clear affordances.
Consistency
Reused tokens and predictable behaviour throughout.
Get the skill
Download it, or make it yours.
Take the skill unchanged, or generate a brand-aware copy — drop in your company name, palette, fonts, and a style guide or example sites, and it bakes a brand.json into the download so audits check against your standards.
Hold the line
Make your agents
sweat the UX.
Every screen your agents build, graded against the same five principles — objective, repeatable, and on brand.