UX Evaluator
Overview
Systematically evaluate UI components against established UX principles using a 3-dimension framework. Transform subjective design feedback into actionable, evidence-based recommendations by comparing against industry conventions and authoritative sources.
Core Value: Prevents subjective design debates by grounding decisions in documented best practices.
When to Use This Skill
Triggers:
- User provides UX feedback on a component
- User references external design guidelines (Balsamiq, Nielsen, Material Design)
- User asks to "review", "evaluate", or "check" UI elements
- User questions button labels, spacing, or visual hierarchy
- Before implementing UI changes that affect user interaction
Do NOT use for:
- Pure visual aesthetics (colors, fonts) without UX implications
- Backend or non-UI changes
- When user has already made a firm decision and just wants implementation
Evaluation Framework
The 3-Dimension Analysis
For ANY UI component, evaluate these three dimensions:
| Dimension |
What to Analyze |
Key Questions |
| 1. Position |
Where is it located relative to other elements? |
Does position follow conventions? Is it discoverable? |
| 2. Visual Weight |
How prominent is it visually? |
Does it compete with primary actions? Is hierarchy clear? |
| 3. Spacing |
What's the gap from adjacent elements? |
Is there adequate separation? Is spacing consistent? |
Evaluation Workflow
Step 1: GATHER CONTEXT
├── What component is being evaluated?
├── What user feedback or concern triggered this?
├── Is there an external reference (article, guideline)?
└── What is the component's purpose (primary CTA, utility, navigation)?
Step 2: ANALYZE CURRENT STATE
├── Position: Document exact location in layout
├── Visual Weight: Describe styling (filled, ghost, icon-only, etc.)
├── Spacing: Measure gaps from adjacent elements
└── Compare to industry conventions (see references/)
Step 3: PRODUCE VERDICT
├── For each dimension: CORRECT / NEEDS CHANGE / ACCEPTABLE
├── If NEEDS CHANGE: Specific recommendation with rationale
├── Reference authoritative source for each recommendation
└── Prioritize changes (P1: breaks UX, P2: suboptimal, P3: polish)
Component-Specific Guidelines
Buttons (Action Elements)
Position:
- Primary action (Sign Up, Submit, Buy) → RIGHT side
- Secondary action (Cancel, Sign In) → LEFT of primary
- Utility controls (theme, settings) → FAR RIGHT after primary actions
Visual Weight:
- Primary: Filled background, brand color, shadow
- Secondary: Ghost/outline, no fill, subtle border
- Utility: Icon-only or minimal text, neutral color
Spacing:
- Between button groups: 1.5rem (24px) minimum
- Between buttons in same group: 0.5rem-0.75rem (8-12px)
- Touch targets: 44px minimum height on mobile
Labels:
- Use conventional labels: "Sign Up" not "Get Started", "Sign In" not "Login"
- Say exactly what happens: "Delete Account" not "Proceed"
- Verb-first for actions: "Create Project", "Send Message"
Navigation Elements
Position:
- Logo → LEFT
- Primary nav → CENTER or after logo
- Utility items (search, auth, theme) → RIGHT
Visual Weight:
- Active state clearly distinguished
- Current page indicator visible
- Don't compete with page content
Spacing:
- Group related items visually
- Clear separation between nav groups
- Adequate click/tap targets
Form Elements
Position:
- Labels above or to the left of inputs
- Submit button at bottom, right-aligned or full-width
- Error messages adjacent to field
Visual Weight:
- Required fields marked clearly
- Error states prominent (red border/text)
- Success states confirmatory (green checkmark)
Spacing:
- Consistent vertical rhythm between fields
- Label-to-input gap: 0.25-0.5rem
- Field-to-field gap: 1-1.5rem
Industry Conventions Reference
Button Order (Major Sites)
| Site |
Pattern |
| GitHub |
[Sign In] [Sign Up] - secondary left, primary right |
| Stripe |
[Sign In] [Start now →] - secondary left, primary right |
| Google |
[Sign In] [Create account] - same pattern |
| Notion |
[Log in] [Get Notion free] - same pattern |
Verdict: Secondary LEFT, Primary RIGHT is the standard.
Theme Toggle Placement
| Site |
Placement |
| GitHub |
Far right, after user menu |
| VS Code Docs |
Far right |
| Stripe Docs |
Far right |
| Discord |
In settings, not navbar |
Verdict: Far right (after auth) or in settings dropdown.
Utility Control Visual Weight
| Control |
Expected Weight |
| Theme toggle |
Icon-only, subtle, doesn't compete with CTAs |
| Search |
Icon trigger or compact input, expandable |
| Language selector |
Icon or compact dropdown |
Verdict: Utilities should be accessible but subordinate to primary actions.
Output Format
When evaluating a component, produce this structured output:
## [Component Name] Evaluation
### Current State
- **Position**: [Description]
- **Visual Weight**: [Description]
- **Spacing**: [Measurements]
### Analysis
| Dimension | Assessment | Rationale |
|-----------|------------|-----------|
| Position | [OK/CHANGE] | [Why, with reference] |
| Visual Weight | [OK/CHANGE] | [Why, with reference] |
| Spacing | [OK/CHANGE] | [Why, with reference] |
### Verdict: [CORRECT / NEEDS CHANGES]
### Recommendations (if any)
| Priority | Change | Rationale |
|----------|--------|-----------|
| P1 | [Specific change] | [Reference to principle] |
| P2 | [Specific change] | [Reference to principle] |
References
See references/ for detailed UX principles:
balsamiq-button-principles.md - Button design best practices
nielsen-heuristics.md - 10 usability heuristics (to be added)
Self-Monitoring
Before finalizing evaluation:
1---2name: ux-evaluator3description: This skill should be used when evaluating UI components against UX best practices. Use for reviewing buttons, navigation elements, spacing, visual hierarchy, or any interface element. Provides a systematic 3-dimension framework (Position, Visual Weight, Spacing) aligned with industry standards (Balsamiq, Nielsen heuristics). Invoke when user asks to "review UX", "check button design", "evaluate layout", or references design guidelines.4---56# UX Evaluator78## Overview910Systematically evaluate UI components against established UX principles using a 3-dimension framework. Transform subjective design feedback into actionable, evidence-based recommendations by comparing against industry conventions and authoritative sources.1112**Core Value**: Prevents subjective design debates by grounding decisions in documented best practices.1314## When to Use This Skill1516**Triggers**:17- User provides UX feedback on a component18- User references external design guidelines (Balsamiq, Nielsen, Material Design)19- User asks to "review", "evaluate", or "check" UI elements20- User questions button labels, spacing, or visual hierarchy21- Before implementing UI changes that affect user interaction2223**Do NOT use for**:24- Pure visual aesthetics (colors, fonts) without UX implications25- Backend or non-UI changes26- When user has already made a firm decision and just wants implementation2728## Evaluation Framework2930### The 3-Dimension Analysis3132For ANY UI component, evaluate these three dimensions:3334| Dimension | What to Analyze | Key Questions |35|-----------|-----------------|---------------|36| **1. Position** | Where is it located relative to other elements? | Does position follow conventions? Is it discoverable? |37| **2. Visual Weight** | How prominent is it visually? | Does it compete with primary actions? Is hierarchy clear? |38| **3. Spacing** | What's the gap from adjacent elements? | Is there adequate separation? Is spacing consistent? |3940### Evaluation Workflow4142```43Step 1: GATHER CONTEXT44├── What component is being evaluated?45├── What user feedback or concern triggered this?46├── Is there an external reference (article, guideline)?47└── What is the component's purpose (primary CTA, utility, navigation)?4849Step 2: ANALYZE CURRENT STATE50├── Position: Document exact location in layout51├── Visual Weight: Describe styling (filled, ghost, icon-only, etc.)52├── Spacing: Measure gaps from adjacent elements53└── Compare to industry conventions (see references/)5455Step 3: PRODUCE VERDICT56├── For each dimension: CORRECT / NEEDS CHANGE / ACCEPTABLE57├── If NEEDS CHANGE: Specific recommendation with rationale58├── Reference authoritative source for each recommendation59└── Prioritize changes (P1: breaks UX, P2: suboptimal, P3: polish)60```6162## Component-Specific Guidelines6364### Buttons (Action Elements)6566**Position**:67- Primary action (Sign Up, Submit, Buy) → RIGHT side68- Secondary action (Cancel, Sign In) → LEFT of primary69- Utility controls (theme, settings) → FAR RIGHT after primary actions7071**Visual Weight**:72- Primary: Filled background, brand color, shadow73- Secondary: Ghost/outline, no fill, subtle border74- Utility: Icon-only or minimal text, neutral color7576**Spacing**:77- Between button groups: 1.5rem (24px) minimum78- Between buttons in same group: 0.5rem-0.75rem (8-12px)79- Touch targets: 44px minimum height on mobile8081**Labels**:82- Use conventional labels: "Sign Up" not "Get Started", "Sign In" not "Login"83- Say exactly what happens: "Delete Account" not "Proceed"84- Verb-first for actions: "Create Project", "Send Message"8586### Navigation Elements8788**Position**:89- Logo → LEFT90- Primary nav → CENTER or after logo91- Utility items (search, auth, theme) → RIGHT9293**Visual Weight**:94- Active state clearly distinguished95- Current page indicator visible96- Don't compete with page content9798**Spacing**:99- Group related items visually100- Clear separation between nav groups101- Adequate click/tap targets102103### Form Elements104105**Position**:106- Labels above or to the left of inputs107- Submit button at bottom, right-aligned or full-width108- Error messages adjacent to field109110**Visual Weight**:111- Required fields marked clearly112- Error states prominent (red border/text)113- Success states confirmatory (green checkmark)114115**Spacing**:116- Consistent vertical rhythm between fields117- Label-to-input gap: 0.25-0.5rem118- Field-to-field gap: 1-1.5rem119120## Industry Conventions Reference121122### Button Order (Major Sites)123124| Site | Pattern |125|------|---------|126| GitHub | [Sign In] [Sign Up] - secondary left, primary right |127| Stripe | [Sign In] [Start now →] - secondary left, primary right |128| Google | [Sign In] [Create account] - same pattern |129| Notion | [Log in] [Get Notion free] - same pattern |130131**Verdict**: Secondary LEFT, Primary RIGHT is the standard.132133### Theme Toggle Placement134135| Site | Placement |136|------|-----------|137| GitHub | Far right, after user menu |138| VS Code Docs | Far right |139| Stripe Docs | Far right |140| Discord | In settings, not navbar |141142**Verdict**: Far right (after auth) or in settings dropdown.143144### Utility Control Visual Weight145146| Control | Expected Weight |147|---------|-----------------|148| Theme toggle | Icon-only, subtle, doesn't compete with CTAs |149| Search | Icon trigger or compact input, expandable |150| Language selector | Icon or compact dropdown |151152**Verdict**: Utilities should be accessible but subordinate to primary actions.153154## Output Format155156When evaluating a component, produce this structured output:157158```markdown159## [Component Name] Evaluation160161### Current State162- **Position**: [Description]163- **Visual Weight**: [Description]164- **Spacing**: [Measurements]165166### Analysis167168| Dimension | Assessment | Rationale |169|-----------|------------|-----------|170| Position | [OK/CHANGE] | [Why, with reference] |171| Visual Weight | [OK/CHANGE] | [Why, with reference] |172| Spacing | [OK/CHANGE] | [Why, with reference] |173174### Verdict: [CORRECT / NEEDS CHANGES]175176### Recommendations (if any)177| Priority | Change | Rationale |178|----------|--------|-----------|179| P1 | [Specific change] | [Reference to principle] |180| P2 | [Specific change] | [Reference to principle] |181```182183## References184185See `references/` for detailed UX principles:186- `balsamiq-button-principles.md` - Button design best practices187- `nielsen-heuristics.md` - 10 usability heuristics (to be added)188189## Self-Monitoring190191Before finalizing evaluation:192- [ ] All 3 dimensions analyzed (Position, Visual Weight, Spacing)193- [ ] Current state documented with specifics (not vague descriptions)194- [ ] Each recommendation references an authoritative source or convention195- [ ] Compared against industry conventions (GitHub, Stripe, etc.)196- [ ] Priorities assigned (P1/P2/P3) based on UX impact197- [ ] Verdict is clear and actionable