UI Design Evaluator

UI Design Evaluator & Mockup Creator

Version: 1.0 Purpose: Design evaluation, wireframe analysis, and high-fidelity mockup generation Design System: Northcote Curio V3.1 (Victorian Naturalist Field Station)

🎯 Skill Purpose

This skill enables comprehensive UI design workflows:

1. Evaluate existing designs against Northcote Curio V3.1 standards
2. Analyze annotated wireframes to extract components and flows
3. Design high-fidelity mockups with design token compliance
4. Deliver interactive prototypes, React components, and evaluation reports

📊 The Complete Workflow

INPUT → ANALYZE → EVALUATE → DESIGN → DELIVER

1. INPUT Phase

Accept Multiple Input Types:

• Screenshots of existing designs
• Annotated wireframes (image or text description)
• Figma/Sketch export images
• Hand-drawn sketches uploaded as photos
• Markdown wireframe descriptions
• Component requirement lists

2. ANALYZE Phase

Extract Design Intent:

• Parse annotations and notes
• Identify components needed (buttons, cards, forms, etc.)
• Map user flows and interactions
• Determine Gallery vs Laboratory mode
• Extract content hierarchy
• Note accessibility requirements

3. EVALUATE Phase

Score Against 4 Criteria (400 points total):

A. Northcote Curio V3.1 Compliance (100 pts)

• ✅ Uses Federation Typography Stack (Curator, Proclamation, Bloom, Field Note, Annotation)
• ✅ Asymmetric organic shapes (no uniform border-radius)
• ✅ Botanical color palette (Wattle Gold, Waratah Crimson, Eucalyptus Smoke)
• ✅ Mode-appropriate (Gallery vs Laboratory)
• ✅ V3.1 playful mixing (if Gallery mode)
• ❌ Anti-Slop violations (Inter/Roboto, purple gradients, uniform corners)

B. Accessibility (100 pts)

• ✅ WCAG AA contrast ratios (4.5:1 minimum)
• ✅ ARIA labels on interactive elements
• ✅ Keyboard navigation support
• ✅ Focus states visible
• ✅ Screen reader friendly structure
• ✅ Color not sole indicator

C. User Flow Logic (100 pts)

• ✅ Clear information hierarchy
• ✅ Logical interaction patterns
• ✅ Consistent navigation
• ✅ Error state handling
• ✅ Loading state design
• ✅ Empty state design

D. Visual Hierarchy & Typography (100 pts)

• ✅ Clear typographic scale (Display → Body)
• ✅ Proper use of Federation Typography Stack
• ✅ Visual weight guides attention
• ✅ Spacing creates rhythm
• ✅ Alignment and grid consistency

Scoring:

• A (90-100%): Excellent — Production ready
• B (80-89%): Good — Minor refinements
• C (70-79%): Satisfactory — Needs work
• D (60-69%): Needs significant improvement
• F (<60%): Does not meet standards

4. DESIGN Phase

Generate High-Fidelity Mockup:

Step 1: Mode Selection

• Gallery Mode: Expressive, warm, cursive allowed, extreme Fraunces
• Laboratory Mode: Restrained, cool, no cursive, clean typography

Step 2: Component Mapping

• Map wireframe elements to Northcote components
• Apply design tokens automatically
• Use Federation Typography Stack
• Apply asymmetric organic shapes

Step 3: Layout Construction

• Build responsive HTML structure
• Apply CSS with design tokens
• Add interactive states (hover, focus, active)
• Implement accessibility attributes

Step 4: Enhancement

• Add Framer Motion physics (if Gallery mode)
• Apply V3.1 playful mixing (if appropriate)
• Add wallpaper background (if hero section)
• Implement viscous breeze motion

5. DELIVER Phase

Output Multiple Formats:

A. Interactive HTML Artifact

<!-- Viewable directly in Claude interface -->
<!-- Full design with interactions -->
<!-- Uses design tokens via CSS custom properties -->

B. React Component Code

// Production-ready TypeScript/React
// 100% design token compliance
// ARIA accessibility built-in
// Framer Motion physics included

C. Evaluation Report

## Design Evaluation Report
- Northcote Curio V3.1 Compliance: 95/100 (A)
- Accessibility: 88/100 (B)
- User Flow Logic: 92/100 (A)
- Visual Hierarchy: 90/100 (A)
- **Overall:** 365/400 (91% — Excellent)

### Strengths
- Perfect Federation Typography Stack usage
- Excellent asymmetric shapes
- Strong color palette

### Improvements Needed
- Add focus states to form inputs
- Increase contrast on secondary text

D. Component Specifications

## Components Required
1. HeroSection (Gallery mode)
   - Cursive + Serif mix hero
   - Botanical wallpaper background
   - CTA buttons with Wattle Gold

2. MetricCard (Laboratory mode)
   - Clean typography (Work Sans)
   - Asymmetric radius (pebble shape)
   - Restrained color palette

🎨 Design Token Application

Automatic Token Mapping

Colors:

/* Wireframe: "primary button - blue" */
/* Maps to: */ background: var(--nc-wattle-gold-300);

/* Wireframe: "error state - red" */
/* Maps to: */ color: var(--nc-waratah-crimson-400);

/* Wireframe: "background - dark" */
/* Maps to: */ background: var(--nc-specimen-night-300);

Typography:

/* Wireframe: "large heading" */
/* Gallery: */ font-family: var(--nc-font-bloom);
              font-variation-settings: 'SOFT' 100, 'WONK' 1, 'wght' 800;

/* Laboratory: */ font-family: var(--nc-font-field-note);
                  font-weight: 700;

Shapes:

/* Wireframe: "card" */
/* Maps to: */ border-radius: 32px 8px 28px 12px; /* specimen shape */

/* Wireframe: "button" */
/* Maps to: */ border-radius: 40px 12px 40px 12px; /* wattle shape */

Motion:

/* Wireframe: "smooth transition" */
/* Maps to: */ transition: all 300ms cubic-bezier(0.34, 1.56, 0.64, 1);

📋 Input Format Examples

Example 1: Text Wireframe Description

Create a landing page hero section with:
- Large headline: "Career Intelligence"
- Subheadline with cursive accent
- Two CTA buttons (primary + secondary)
- Background: botanical wallpaper
- Mode: Gallery (expressive)

Output: Interactive HTML hero with cursive+serif mix, wallpaper background, Wattle Gold CTAs

Example 2: Annotated Screenshot

[User uploads screenshot with annotations:]
- "This should be more expressive" (pointing to header)
- "Use organic shapes" (pointing to cards)
- "Add cursive accent here" (pointing to subtitle)
- Mode: Gallery

Process:

1. Analyze: Header needs Bloom ultra-wonky, cards need asymmetric radii, subtitle needs Caveat cursive
2. Evaluate: Current design scores 60% (generic fonts, uniform corners)
3. Design: Rebuild with V3.1 tokens
4. Deliver: Interactive mockup + evaluation report

Example 3: Component List

Dashboard page needs:
1. PageHeader with title and breadcrumbs
2. 4x MetricCard showing KPIs
3. ChartPane with data visualization
4. ActionButton for primary action

Mode: Laboratory (data-focused)

Output:

• Interactive dashboard mockup
• 4 separate React components
• Laboratory mode styling (restrained, clean)
• Evaluation report with accessibility score

🎭 Gallery vs Laboratory Mode

Gallery Mode (Expressive, Warm)

Typography:

• ✅ Caveat cursive for hero/annotations
• ✅ Extreme Fraunces (SOFT=100, WONK=1, wght=900)
• ✅ Playful mixing utilities
• ✅ Shadow layering, weight contrast, rotation

Colors:

• Full botanical palette (Wattle Gold, Waratah Crimson)
• High contrast and emotional
• Glowing accents

Shapes:

• Maximum organic asymmetry
• Dramatic radius variations
• Botanical-inspired forms

Motion:

• Framer Motion physics
• Variable font axis animations
• Viscous breeze easing

Wallpaper:

• Full visibility (0.65-0.85 opacity)
• Parallax effects
• Hot zones typography positioning

Laboratory Mode (Restrained, Cool)

Typography:

• ❌ NO cursive (ever)
• Restrained Fraunces (SOFT=20, WONK=0)
• Work Sans sans-serif primary
• JetBrains Mono for data

Colors:

• Muted eucalypt smoke palette
• Low contrast and clinical
• Minimal gold accents

Shapes:

• Subtle asymmetry
• Functional organic shapes
• Grid-aligned layouts

Motion:

• Minimal animations
• Fast, efficient transitions
• No playful physics

Wallpaper:

• Barely visible (0.05 opacity)
• Heavily desaturated
• Functional background only

✅ Compliance Checklist

Before delivering a mockup, verify:

Design System Compliance

• Uses only Federation Typography Stack (no Inter/Roboto)
• All shapes are asymmetric (no uniform border-radius)
• Colors from botanical palette
• Motion uses viscous breeze easing
• Mode-appropriate styling (Gallery vs Laboratory)

V3.1 Typography

• 5 fonts properly used (Curator, Proclamation, Bloom, Field Note, Annotation)
• Cursive ONLY in Gallery mode hero/annotations
• Fraunces uses extreme axes in Gallery (SOFT=100, WONK=1)
• Work Sans full range utilized (100-900 if weight mixing)

Accessibility

• 4.5:1 contrast ratio minimum (7:1 for AAA)
• ARIA labels on all interactive elements
• Keyboard navigation support
• Focus states visible
• No color-only indicators

Anti-Slop Protocol

• NO forbidden fonts (Inter, Roboto, Arial, Helvetica)
• NO uniform corners (must be asymmetric)
• NO purple/blue gradients
• NO generic SaaS aesthetic

🚀 Usage Examples

Example 1: Evaluate Existing Design

User: "Evaluate this dashboard design" [Uploads screenshot]

Claude:

1. Analyzes design visually
2. Scores against 4 criteria
3. Generates evaluation report:

   Northcote Curio Compliance: 45/100 (F)
   - Uses Inter font (forbidden)
   - Uniform 8px border-radius
   - Generic blue color scheme
   
   Accessibility: 75/100 (C)
   - Contrast ratios adequate
   - Missing focus states
   
   Recommendations:
   1. Replace Inter with Federation Typography Stack
   2. Apply asymmetric organic shapes
   3. Use botanical color palette
   

Example 2: Create Mockup from Wireframe

User: "Create a high-fidelity hero section from this wireframe. Gallery mode." [Uploads wireframe sketch with annotations]

Claude:

1. Analyzes:

   • Hero needs large headline
   • Subtitle with cursive accent
   • Two CTA buttons
   • Wallpaper background

2. Designs:

   • Cursive+serif mix hero (Proclamation + Caveat)
   • Wallpaper at 0.75 opacity with hot zones positioning
   • Wattle Gold primary button, Waratah secondary
   • V3.1 playful mixing (shadow layering on hero text)

3. Delivers:

   • Interactive HTML artifact (viewable immediately)
   • React component code
   • Evaluation report (98/100 - Excellent)

Example 3: Multi-Page Flow

User: "Analyze this 5-page onboarding flow wireframe and create mockups for each page. Laboratory mode."

Claude:

1. Analyzes:

   • Extracts components from all 5 pages
   • Maps user flow (Step 1 → Step 2 → ... → Complete)
   • Identifies reusable components

2. Evaluates:

   • Flow logic: 90/100
   • Accessibility: Need focus states
   • Typography: Will use Work Sans + JetBrains Mono

3. Designs:

   • Creates 5 interactive HTML pages
   • Consistent component library
   • Laboratory mode styling (restrained, clean)
   • Navigation between pages

4. Delivers:

   • 5 interactive HTML artifacts
   • Shared component code
   • Flow diagram
   • Evaluation report

🎨 Interactive Mockup Features

HTML Artifacts Include:

• ✅ Hover states (buttons, cards, links)
• ✅ Focus states (keyboard navigation)
• ✅ Active states (button press)
• ✅ Animations (Framer Motion physics if Gallery)
• ✅ Responsive breakpoints (mobile, tablet, desktop)
• ✅ Dark mode support (Northcote is dark-first)
• ✅ Real design tokens via CSS custom properties

Interactions Demonstrated:

• Button hover → Color shift + elevation
• Card hover → Scale + shadow
• Input focus → Border glow + label animation
• Typography hover → Variable font axis shift (Gallery mode)
• Scroll → Parallax wallpaper (Gallery hero sections)

📖 Best Practices

When to Use This Skill

✅ USE FOR:

• Evaluating existing designs for Northcote compliance
• Creating high-fidelity mockups from wireframes
• Generating interactive prototypes for user testing
• Converting design specifications to code
• Validating accessibility before development

❌ DON'T USE FOR:

• Production-ready backend integration (use component-builder)
• Complex state management (use component-builder)
• Component migration (use component-transformer)
• Design token auditing (use northcote-curio-audit)

Skill Integration

Workflow Integration:

ui-design-evaluator (mockup)
  → component-builder (production code)
  → jest-test-scaffolder (tests)
  → storybook-scaffolder (docs)

🎯 Quick Reference

Evaluation Scoring

400 Points Total:

• Northcote Curio V3.1 Compliance: 100 pts
• Accessibility (WCAG AA): 100 pts
• User Flow Logic: 100 pts
• Visual Hierarchy & Typography: 100 pts

Grades:

• 360+ (90%) = A (Excellent)
• 320-359 (80-89%) = B (Good)
• 280-319 (70-79%) = C (Satisfactory)
• 240-279 (60-69%) = D (Needs work)
• <240 (<60%) = F (Does not meet standards)

Mode Selection

Gallery Mode:

• Landing pages
• Marketing pages
• Hero sections
• Feature callouts
• Profile pages

Laboratory Mode:

• Dashboards
• Data tables
• Forms
• Settings
• Technical tools

📚 Related Skills

Use Together With:

• component-builder — Convert mockups to production code
• asset-placement-strategy — Typography on wallpaper positioning
• northcote-curio-audit — Validate final design token compliance
• design-compliance-dashboard — Track overall design system adoption

Status: ✅ Production Ready Version: 1.0 V3.1 Compatible: Yes Last Updated: 2026-01-28