Aesthetics Audit: AI Skill for UX Design
Aesthetics Audit is an AI skill that reviews any UI against eight visual-design principles. Every finding names the violated principle, carries a severity rating, and comes with a fix, plus an explicit overdesign verdict.
npx skills add Uxcel-Lab/product-skills --skill ux-aesthetics-audit
What this skill does
Turns vague visual feedback like "make it cleaner" into a principle-based audit with severity ratings and fixes.
- Sweeps eight visual-design principles, from hierarchy and contrast to depth and elevation.
- Names the violated principle behind every finding: hierarchy, emphasis, proximity, and more.
- Rates each finding Critical, Major, or Minor by its cost to scanning and comprehension.
- Runs an explicit overdesign pass to catch clutter, competing focal points, and stacked effects.
- Gives a concrete fix for every issue, not a vibe.
- Lists what already works, not just what fails.
- Ends with an overdesign verdict and the top three fixes.
- Runs standalone or as a validation step after an assistant generates UI.
When to use it
Use it when you need an AI assistant to:
- audit the visual quality of a screen, component, or page;
- check hierarchy, spacing, alignment, grouping, or consistency;
- catch overdesign and clutter in AI-generated UI;
- confirm the primary action stands out;
- judge whether a design looks professional before it ships;
- get fixes tied to named principles instead of taste.
What this audit checks
| Area | What it catches |
|---|---|
| Visual hierarchy | No clear entry point, a primary action that fails to stand out, flat visual weight |
| Emphasis & contrast | Everything emphasized at once, one weak contrast dimension, no neutral anchor |
| Spacing & negative space | Cramped edge-to-edge content, uneven gaps, layouts too empty to feel connected |
| Alignment & grid | Ragged edges, off-grid elements, inconsistent margins and gutters |
| Grouping & proximity | Related items pushed apart, unrelated items crowded together, mismatched card styling |
| Consistency & repetition | One component styled three ways, near-duplicate colors, radii, and shadows |
| Typographic hierarchy | Headings stacking four type instruments, too many levels, body text under 16px |
| Depth & elevation | Shadows in clashing directions, elevation on everything, stacked shadows |
| Overdesign pass | Competing focal points, extra accent colors, decoration that fights the content |
How the skill works
1
Establish context
The skill confirms the platform and the screen's primary task, so hierarchy is judged against what matters most.
2
Sweep eight principles
It checks hierarchy, contrast, spacing, alignment, grouping, consistency, type, and depth, then runs the overdesign pass.
3
Deliver a verdict
It rates each finding by severity, names the principle, gives the fix, and states the overdesign verdict.
Try it with
Related skills
1.0.0
MIT
UX Design
Audits
