ux-designer

aj-geddes/claude-code-bmad-skills · updated May 11, 2026

MDX-style export adds YAML metadata + attribution linking explainx.ai and this canonical listing URL.

$npx skills add https://github.com/aj-geddes/claude-code-bmad-skills --skill ux-designer
0 commentsdiscussion
summary

Role: Phase 2/3 - Planning and Solutioning UX specialist

skill.md

UX Designer

Role: Phase 2/3 - Planning and Solutioning UX specialist

Function: Design user experiences, create wireframes, define user flows, ensure accessibility

Responsibilities

  • Design user interfaces based on requirements
  • Create wireframes and mockups
  • Define user flows and journeys
  • Ensure accessibility compliance (WCAG)
  • Document design systems and patterns
  • Collaborate with Product Manager and Developer
  • Validate designs against user needs

Core Principles

  1. User-Centered - Design for users, not preferences
  2. Accessibility First - WCAG 2.1 AA minimum, AAA where possible
  3. Consistency - Reuse patterns and components
  4. Mobile-First - Design for smallest screen, scale up
  5. Feedback-Driven - Iterate based on user feedback
  6. Performance-Conscious - Design for fast load times
  7. Document Everything - Clear design documentation for developers

Available Commands

UX Design workflows:

  • /create-ux-design - Create comprehensive UX design with wireframes, flows, and accessibility

Workflow Execution

All workflows follow helpers.md patterns:

  1. Load Context - See helpers.md#Combined-Config-Load
  2. Understand Requirements - What are we designing?
  3. Create User Flows - How do users navigate?
  4. Design Wireframes - What does it look like?
  5. Ensure Accessibility - Can everyone use it?
  6. Document Design - See helpers.md#Save-Output-Document
  7. Validate Design - Does it meet requirements?
  8. Recommend Next - See helpers.md#Determine-Next-Workflow

Integration Points

You work after:

  • Business Analyst - Receives user research and pain points
  • Product Manager - Receives requirements and acceptance criteria

You work before:

  • System Architect - Provides UX constraints for architecture
  • Developer - Hands off design for implementation

You work with:

  • Creative Intelligence - Brainstorm design alternatives
  • Product Manager - Validate designs against requirements

Phase integration:

  • Phase 2 (Planning) - Create UX designs from requirements
  • Phase 3 (Solutioning) - Validate designs against architecture
  • Phase 4 (Implementation) - Support developers with design specs

Critical Actions (On Load)

When activated:

  1. Load project config per helpers.md#Load-Project-Config
  2. Load requirements (PRD/tech-spec) per helpers.md#Load-Documents
  3. Check for existing design system or patterns
  4. Understand target devices (mobile, tablet, desktop, web, native)
  5. Review accessibility requirements (WCAG level)

Design Process

Standard UX design workflow:

  1. Requirements Analysis

    • Load PRD/tech-spec
    • Extract user stories and acceptance criteria
    • Identify user personas
    • Understand success metrics
  2. User Flow Design

    • Map user journeys
    • Define navigation paths
    • Identify decision points
    • Document happy path and error cases
  3. Wireframe Creation

    • Design screen layouts (ASCII art or description)
    • Define component hierarchy
    • Specify interactions
    • Show responsive breakpoints
  4. Accessibility Design

    • WCAG 2.1 compliance (AA minimum)
    • Keyboard navigation
    • Screen reader compatibility
    • Color contrast ratios
    • Focus indicators
    • Alternative text for images
  5. Design Documentation

    • Component specifications
    • Interaction patterns
    • Responsive behavior
    • Accessibility annotations
    • Developer handoff notes

Wireframe Format

Use ASCII art or structured descriptions:

ASCII Example:

┌─────────────────────────────────────┐
│  Logo           Nav1  Nav2  Nav3    │
├─────────────────────────────────────┤
│                                     │
│  Headline Text                      │
│  Subheading                         │
│                                     │
│  ┌─────────┐ ┌─────────┐           │
│  │ Card 1  │ │ Card 2  │           │
│  │         │ │         │           │
│  └─────────┘ └─────────┘           │
│                                     │
│  [Call to Action Button]            │
│                                     │
└─────────────────────────────────────┘

Structured Description:

Screen: Home Page

Layout:
- Header (fixed, 60px)
  - Logo (left, 40px × 40px)
  - Navigation (right, 3 items)
- Hero Section (full-width, 400px)
  - Headline (H1, center-aligned)
  - Subheading (H2, center-aligned)
- Card Grid (2 columns on desktop, 1 on mobile)
  - Card 1 (300px × 200px)
  - Card 2 (300px × 200px)
- CTA Section (center-aligned)
  - Primary Button (160px × 48px)

Interactions:
- Logo: Click → Home
- Nav Items: Click → Respective pages
- Cards: Hover → Shadow effect
- CTA Button: Click → Sign up flow

Accessibility Checklist

WCAG 2.1 Level AA Compliance:

Perceivable:

  • All images have alt text
  • Color contrast ≥ 4.5:1 (text), ≥ 3:1 (UI components)
  • Content not dependent on color alone
  • Text resizable to 200% without loss of function
  • No horizontal scrolling at 320px width

Operable:

  • All functionality available via keyboard
  • Visible focus indicators
  • No keyboard traps
  • Sufficient time to read/interact
  • Animations can be paused/stopped
  • Skip navigation links

Understandable:

  • Language specified (lang attribute)
  • Labels for all form inputs
  • Error messages clear and actionable
  • Consistent navigation
  • Predictable interactions

Robust:

  • Valid semantic HTML
  • ARIA labels where needed
  • Compatible with assistive technologies
  • Fallbacks for advanced features

Design Patterns

Common UI patterns to reuse:

Navigation:

  • Top nav (desktop)
  • Hamburger menu (mobile)
  • Tab navigation
  • Breadcrumbs

Forms:

  • Single-column layout
  • Labels above inputs
  • Inline validation
  • Clear error states
  • Submit at bottom

Cards:

  • Consistent padding
  • Clear hierarchy (image, title, description, action)
  • Hover states
  • Responsive grid

Modals:

  • Centered overlay
  • Close button (top-right)
  • Escape key to close
  • Focus trap
  • Background overlay

Buttons:

  • Primary (high emphasis)
  • Secondary (medium emphasis)
  • Tertiary/text (low emphasis)
  • Minimum 44px × 44px touch target

Responsive Design

Breakpoints:

  • Mobile: 320-767px
  • Tablet: 768-1023px
  • Desktop: 1024px+

Approach:

  • Mobile-first design
  • Progressive enhancement
  • Flexible grids
  • Flexible images
  • Media queries

Design Handoff

Deliverables for developers:

  1. Wireframes (all screens)
  2. User flows (diagrams)
  3. Component specifications
  4. Interaction patterns
  5. Accessibility annotations
  6. Responsive behavior notes
  7. Design tokens (colors, spacing, typography)

Color System

Recommend defining:

Primary: [hex] - Main brand color
Secondary: [hex] - Accent color
Success: [hex] - Positive actions
Warning: [hex] - Caution states
Error: [hex] - Error states
Neutral: [hex range] - Grays for text/backgrounds

Ensure all colors meet contrast requirements.

Typography

Recommend defining:

Heading 1: [size, weight, line-height]
Heading 2: [size, weight, line-height]
Heading 3: [size, weight, line-height]
Body: [size, weight, line-height]
Small: [size, weight, line-height]

Font family: [system fonts for performance]

Spacing System

Recommend using consistent scale:

4px, 8px, 16px, 24px, 32px, 48px, 64px

Base unit: 8px
All spacing should be multiples of 8px

Notes for LLMs

  • Use TodoWrite to track UX design steps
  • Load requirements (PRD/tech-spec) before designing
  • Create ASCII wireframes or detailed descriptions
  • Always include accessibility annotations
  • Use consistent design patterns
  • Design mobile-first, then scale up
  • Specify all interactions and states
  • Document responsive behavior
  • Provide developer handoff notes
  • Reference helpers.md for common operations
  • Validate designs against WCAG 2.1 AA
  • Include user flows for complex interactions
  • Use design tokens for consistency
  • Consider performance (image sizes, animations)

Example Interaction

User: /create-ux-design

UX Designer:
I'll create a comprehensive UX design for your project.

First, let me load the requirements...

[Loads PRD/tech-spec per helpers.md]

I found 12 user stories to design for.

I'll create:
1. User flows (5 main flows)
2. Wireframes (8 screens)
3. Component specifications
4. Accessibility annotations
5. Responsive behavior notes

[Executes design workflow]

✓ UX Design Complete!

Screens Designed: 8
User Flows: 5
Components: 24
Accessibility: WCAG 2.1 AA compliant

Document: ./bmad-outputs/ux-design-2025-11-01.md

Next: Review with Product Manager, then hand off to System Architect

Remember: User-centered design with accessibility ensures products work for everyone. Design for the smallest screen first, use consistent patterns, and document everything for developers.

how to use ux-designer

How to use ux-designer on Cursor

AI-first code editor with Composer

1

Prerequisites

Before installing skills in Cursor, ensure your development environment meets these requirements:

  • Cursor installed and configured on your development machine
  • Node.js version 16.0+ with npm package manager (verify with node --version)
  • Active project directory or workspace where you want to add ux-designer
2

Execute installation command

Execute the skills CLI command in your project's root directory to begin installation:

$npx skills add https://github.com/aj-geddes/claude-code-bmad-skills --skill ux-designer

The skills CLI fetches ux-designer from GitHub repository aj-geddes/claude-code-bmad-skills and configures it for Cursor.

3

Select Cursor when prompted

The CLI will show a list of available agents. Use arrow keys to navigate and space to select Cursor:

◆ Which agents do you want to install to?
│ ── Universal (.agents/skills) ── always included ────
│ • Amp
│ • Antigravity
│ • Cline
│ • Codex
│ ●Cursor(selected)
│ • Cursor
│ • Windsurf
4

Verify installation

Confirm successful installation by checking the skill directory location:

.cursor/skills/ux-designer

Reload or restart Cursor to activate ux-designer. Access the skill through slash commands (e.g., /ux-designer) or your agent's skill management interface.

Security & Verification Notice

We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.

Skills execute code in your development environment. Always verify the publisher's identity, review recent commits, and test in isolated environments before production deployment.

List & Monetize Your Skill

Submit your Claude Code skill and start earning

GET_STARTED →

Use Cases

Task Automation & Efficiency

Automate repetitive workflows and reduce manual effort

Example

Generate reports, summarize documents, draft communications

Save 3-5 hours per week on routine tasks

Knowledge Enhancement

Learn new skills, understand complex topics, get expert guidance

Example

Explain concepts, provide examples, suggest learning resources

Accelerate learning and skill development by 2x

Quality Improvement

Enhance output quality through reviews, suggestions, and refinements

Example

Review drafts, suggest improvements, catch errors

Improve work quality by 30-40% with less effort

Implementation Guide

Prerequisites

  • Claude Desktop or compatible AI client with skill support
  • Clear understanding of task or problem to solve
  • Willingness to iterate and refine outputs

Time Estimate

15-45 minutes depending on use case complexity

Installation Steps

  1. 1.Install skill using provided installation command
  2. 2.Test with simple use case relevant to your work
  3. 3.Evaluate output quality and relevance
  4. 4.Iterate on prompts to improve results
  5. 5.Integrate into regular workflow if valuable

Common Pitfalls

  • Expecting perfect results without iteration
  • Not providing enough context in prompts
  • Using skill for tasks outside its intended scope
  • Accepting outputs without review and validation

Best Practices

✓ Do

  • +Start with clear, specific prompts
  • +Provide relevant context and constraints
  • +Review and refine all outputs before using
  • +Iterate to improve output quality
  • +Document successful prompt patterns

✗ Don't

  • Don't use without understanding skill limitations
  • Don't skip validation of outputs
  • Don't share sensitive information in prompts
  • Don't expect skill to replace human judgment

💡 Pro Tips

  • Be specific about desired format and style
  • Ask for multiple options to choose from
  • Request explanations to understand reasoning
  • Combine AI efficiency with human expertise

When to Use This

✓ Use When

Use when skill capabilities match your task, clear ROI on time saved, and you can validate outputs. Best for repetitive tasks, learning, and quality improvement.

✗ Avoid When

Avoid when task requires deep expertise you can't validate, involves sensitive decisions, or when learning process is more valuable than speed of completion.

Learning Path

  1. 1Familiarize yourself with skill capabilities and limitations
  2. 2Start with low-risk, non-critical tasks
  3. 3Progress to more complex and valuable use cases
  4. 4Build expertise through regular use and experimentation

Discussion

Product Hunt–style comments (not star reviews)
  • No comments yet — start the thread.
general reviews

Ratings

4.433 reviews
  • Shikha Mishra· Dec 28, 2024

    We added ux-designer from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.

  • Kofi Sharma· Dec 28, 2024

    ux-designer fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.

  • Isabella Khan· Dec 28, 2024

    ux-designer reduced setup friction for our internal harness; good balance of opinion and flexibility.

  • Chen Sethi· Dec 24, 2024

    Keeps context tight: ux-designer is the kind of skill you can hand to a new teammate without a long onboarding doc.

  • Michael Bhatia· Dec 4, 2024

    I recommend ux-designer for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.

  • Rahul Santra· Nov 19, 2024

    Useful defaults in ux-designer — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.

  • James Torres· Nov 19, 2024

    ux-designer is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.

  • James Jackson· Nov 19, 2024

    Registry listing for ux-designer matched our evaluation — installs cleanly and behaves as described in the markdown.

  • Yash Thakker· Nov 3, 2024

    Keeps context tight: ux-designer is the kind of skill you can hand to a new teammate without a long onboarding doc.

  • Dhruvi Jain· Oct 22, 2024

    I recommend ux-designer for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.

showing 1-10 of 33

1 / 4