UX Designer — Claude Code skill: what it does, how to install
The UX Designer skill guides user flows, information architecture, wireframes, prototypes, and usability work. Use it when shaping or revising an interface.
MIT 196 installs ★ 39 updated 2025-12-25
npx skills add daffy0208/ai-dev-standards --skill ux-designer -a claude-codeWhat UX Designer does
The skill lays out a five-phase UX process: information architecture, user flows, wireframing, prototyping with testing, and UI handoff. It can help map onboarding, core tasks, recovery from errors, and less common cases, then turn those decisions into screen structure and navigation.
Its guidance covers forms, empty and loading states, design-system pieces, responsive handoff, and accessibility. The checklist includes keyboard access, semantic HTML, ARIA labels, visible focus, alternative text, and WCAG 2.1 AA contrast targets. User research and usability testing are treated as the basis for design decisions, so personal preference is not enough here.
The testing section describes a session script with tasks and follow-up questions, plus measures such as task completion rate, time on task, and error rate. Referenced tools include Figma, Framer, Maze, WAVE, axe DevTools, and Lighthouse.
What it helps with
- map a product’s information architecture
- define onboarding and core-task user flows
- turn a dashboard into low-fidelity wireframes
- cover empty, loading, and error states
- audit an interface against accessibility checks
Example prompts for the agent
- Map the onboarding flow for this product, including decision points, recovery paths, and exit points.
- Create low-fidelity wireframes for the dashboard, its main form, and the empty state.
- Review this interface against WCAG 2.1 AA and list the accessibility fixes.
How to install UX Designer
1Skills CLI (Vercel)
npx skills add daffy0208/ai-dev-standards --skill ux-designer -a claude-code2Manually: put the files in place
~/.claude/skills/ux-designer/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/ux-designer/
1Skills CLI (Vercel)
npx skills add daffy0208/ai-dev-standards --skill ux-designer -a codex2Manually: put the files in place
.agents/skills/ux-designer/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add daffy0208/ai-dev-standards --skill ux-designer -a cursor2Manually: put the files in place
.cursor/skills/ux-designer/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install daffy0208/ai-dev-standards skills/ux-designer2Manually: put the files in place
.github/skills/ux-designer/SKILL.md1Skills CLI (Vercel)
npx skills add daffy0208/ai-dev-standards --skill ux-designer -a gemini-cli2Platform CLI
gemini skills install https://github.com/daffy0208/ai-dev-standards --path skills/ux-designerManually: put the files in place
.devin/skills/ux-designer/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add daffy0208/ai-dev-standards --skill ux-designer -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about UX Designer
How do I install UX Designer in Claude Code?
Run npx skills add daffy0208/ai-dev-standards --skill ux-designer -a claude-code, then check ~/.claude/skills/ux-designer/SKILL.md.
What does UX Designer do?
It gives the agent a process for user flows, information architecture, wireframes, prototypes, and usability checks. It also covers interface handoff and accessibility.
Which accessibility practices does UX Designer cover?
It follows WCAG 2.1 AA guidance, including 4.5:1 contrast for regular text, keyboard navigation, semantic HTML, ARIA labels, visible focus states, and descriptive alt text.
Source text
SKILL.md · MIT
---
name: UX Designer
description: Design user experiences and interfaces. Use when creating user journeys, wireframes, prototypes, or improving usability. Covers user flows, information architecture, interaction design, and accessibility.
version: 1.0.0
---
# UX Designer
Design intuitive, accessible user experiences grounded in research.
## Core Principle
**Design for users, not yourself.** Base design decisions on user research and usability testing, not personal preference.
## 5-Phase UX Design Process
### Phase 1: Information Architecture
**Goal**: Organize content and functionality logically
**Activities**:
- Card sorting: Let users organize content into categories
- Site mapping: Create hierarchy of pages and features
- Navigation design: Primary, secondary, utility navigation
- Labeling: Clear, user-friendly terminology
**Validation**:
- [ ] IA tested with 5+ users (tree testing)
- [ ] Navigation paths clear and logical
- [ ] Labels match user mental models
---
### Phase 2: User Flows
**Goal**: Map paths users take to complete tasks
**Key Flows to Design**:
- Onboarding: First-time user experience
- Core tasks: Primary use cases (80% of usage)
- Error states: Recovery from mistakes
- Edge cases: Less common but important scenarios
**Flow Diagram Elements**:
```
[Entry Point] → [Decision] → [Action] → [Outcome]
↓
[Alternative Path]
```
**Validation**:
- [ ] Happy path documented
- [ ] Error states designed
- [ ] Exit points identified
- [ ] Flows match user research
---
### Phase 3: Wireframing
**Goal**: Create low-fidelity layouts focusing on structure
**Fidelity Levels**:
- **Low-fi**: Sketches, boxes, placeholder text (fastest)
- **Mid-fi**: Grayscale, realistic content, basic interactions
- **High-fi**: Styled, branded, detailed interactions
**Key Screens to Wireframe**:
- Homepage/Dashboard
- Core task screens (CRUD operations)
- Navigation (header, sidebar, footer)
- Forms and input validation
- Empty states, loading states, error states
**Wireframe Checklist**:
- [ ] Clear visual hierarchy
- [ ] Consistent layout patterns
- [ ] Accessible contrast and sizing
- [ ] Touch targets ≥44x44px (mobile)
- [ ] Forms grouped logically
---
### Phase 4: Prototyping & Testing
**Goal**: Create interactive prototypes for usability testing
**Prototyping Tools**:
- Figma (recommended): Collaborative, browser-based
- Adobe XD: Design system friendly
- Framer: Code-based prototyping
- InVision: Simple click-through prototypes
**Usability Testing**:
```
Script:
1. Welcome (5 min): Explain process, get consent
2. Context (5 min): Ask about current solutions
3. Tasks (20 min): "Try to [complete task]"
4. Think-aloud: "What are you thinking?"
5. Debrief (5 min): Overall impressions
Metrics:
- Task completion rate (target: >70%)
- Time on task
- Error rate
- Satisfaction (1-5 scale)
```
**Validation**:
- [ ] Prototype covers main user flows
- [ ] 5+ users tested
- [ ] Task completion >70%
- [ ] Critical issues documented and fixed
---
### Phase 5: UI Design & Handoff
**Goal**: Create high-fidelity, production-ready designs
**Design System Elements**:
- Colors: Primary, secondary, neutrals, semantic (error, success)
- Typography: Scale (h1-h6, body, small), weights
- Spacing: 4pt or 8pt grid system
- Components: Buttons, inputs, cards, modals, etc.
- Icons: Consistent set (Heroicons, Lucide, Font Awesome)
**Accessibility (WCAG 2.1 AA)**:
- Color contrast: 4.5:1 for text, 3:1 for large text/UI
- Keyboard navigation: Tab order logical
- Screen readers: Semantic HTML, ARIA labels
- Focus states: Visible focus indicators
- Alt text: Descriptive image alternatives
**Developer Handoff**:
- Design specs: Spacing, colors, fonts (inspect mode)
- Component states: Default, hover, active, disabled, error
- Responsive breakpoints: Mobile, tablet, desktop
- Interactions: Animations, transitions, micro-interactions
- Assets: Icons, images, logos (exported)
**Validation**:
- [ ] Designs match brand guidelines
- [ ] Accessibility checked (Contrast, keyboard nav)
- [ ] Responsive layouts for all breakpoints
- [ ] Component library documented
- [ ] Handoff reviewed with developers
---
## Key UX Principles
### 1. Consistency
Use familiar patterns. Don't reinvent standard UI elements.
### 2. Feedback
Confirm user actions (success messages, loading states).
### 3. Error Prevention
Design to prevent errors, not just handle them.
### 4. Recognition Over Recall
Show options rather than requiring memory.
### 5. Flexibility
Support both novice and expert users (shortcuts, defaults).
---
## Design Patterns
**Form Design**:
- Label above field (not placeholder)
- Inline validation (real-time feedback)
- Clear error messages ("Email must include @")
- One column layout (faster completion)
- Group related fields
**Navigation**:
- Current page highlighted
- Breadcrumbs for deep hierarchies
- Search for large sites
- Max 7 items in top nav (Miller's Law)
**Empty States**:
- Explain why it's empty
- Provide clear next action
- Use illustration or icon
- Example: "No tasks yet. Create your first task to get started."
**Loading States**:
- Skeleton screens (better than spinners)
- Progress indicators for long operations
- Optimistic UI (show result before confirmed)
---
## Accessibility Checklist
- [ ] Color contrast ≥4.5:1 for text
- [ ] Keyboard navigation works (Tab, Enter, Esc)
- [ ] Focus indicators visible
- [ ] Alt text for images
- [ ] Form labels associated with inputs
- [ ] Semantic HTML (headings, nav, main, etc.)
- [ ] ARIA labels for icon buttons
- [ ] Screen reader tested
- [ ] Zoom to 200% works (responsive)
- [ ] No flashing content (seizure risk)
---
## Tools & Resources
**Design Tools**:
- Figma: Collaborative design
- Tailwind CSS: Utility-first CSS framework
- shadcn/ui: Component library
- Heroicons/Lucide: Icon sets
**Prototyping**:
- Figma: Built-in prototyping
- Framer: Advanced interactions
- ProtoPie: Complex micro-interactions
**Testing**:
- Maze: Remote usability testing
- UserTesting: Moderated and unmoderated tests
- Hotjar: Session recordings and heatmaps
**Accessibility**:
- WAVE: Accessibility checker
- axe DevTools: Browser extension
- Lighthouse: Automated audits
---
## Related Resources
**Related Skills**:
- `user-researcher` - For grounding design in research
- `frontend-builder` - For implementing designs
- `product-strategist` - For validating design direction
**Related Patterns**:
- `STANDARDS/design-systems/component-library.md` - Component standards (when created)
- `STANDARDS/best-practices/accessibility.md` - Accessibility guidelines (when created)
**Related Playbooks**:
- `PLAYBOOKS/conduct-usability-test.md` - Testing procedure (when created)
- `PLAYBOOKS/design-handoff.md` - Developer handoff process (when created)
© daffy0208 · MIT · daffy0208/ai-dev-standards