ux-design
npx skills add https://github.com/petrilahdelma/digitaltableteur --skill ux-design
Agent 安装分布
Skill 文档
UX Design Expert
Core UX Principles
When designing user experiences, always follow these principles:
- User-Centered Design: Start with user needs, not business requirements
- Cognitive Load Minimization: Reduce mental effort required to complete tasks
- Consistency: Maintain predictable patterns across the experience
- Feedback & Feedforward: Show system status and next steps clearly
- Error Prevention: Design to prevent errors before they occur
- Accessibility First: WCAG 2.1 AA minimum, aim for AAA
UX Research Methods
1. User Interviews (Discovery)
When to use: Understanding user motivations, pain points, mental models
Process:
- Define research questions (3-5 core questions)
- Recruit participants (5-8 users per segment)
- Prepare interview guide (open-ended questions)
- Conduct 30-45 min sessions
- Synthesize findings into themes
Interview Script Template:
Opening (5 min):
- Introduce yourself and research goals
- Explain confidentiality and recording
- Ask for permission to record
Background (10 min):
- Tell me about your role...
- How do you currently solve [problem]?
- Walk me through your last experience with [task]...
Deep Dive (20 min):
- What frustrates you most about [current solution]?
- If you could change one thing, what would it be?
- How do you decide when to [key decision]?
Closing (5 min):
- Is there anything I should have asked but didn't?
- Can you recommend others I should speak with?
Output: Affinity map of user needs, pain points, and opportunities
2. Usability Testing
When to use: Validating designs, identifying friction points
Process:
- Define tasks (3-5 critical user flows)
- Create prototype (low-fi for early testing, high-fi for refinement)
- Recruit 5 participants per round
- Conduct moderated sessions (30-45 min)
- Measure: task success rate, time on task, error rate, satisfaction
Task Script Template:
Scenario: You need to [realistic goal]. Using this prototype, show me how you would do that.
Observation Notes:
- Where do they hesitate?
- What do they click first?
- Do they use search or navigation?
- What error messages do they encounter?
- Do they complete the task successfully?
Follow-up Questions:
- On a scale of 1-5, how difficult was that?
- What was confusing?
- What would you change?
Nielsen’s Severity Rating:
- 0: Not a usability problem
- 1: Cosmetic (fix if time)
- 2: Minor (low priority)
- 3: Major (high priority)
- 4: Catastrophic (fix before launch)
3. Heuristic Evaluation (Jakob Nielsen’s 10 Heuristics)
Use this checklist to audit any interface:
-
Visibility of System Status: Does the system keep users informed?
- Loading indicators, progress bars, confirmation messages
- â Example: “Saving…” â “Saved!” feedback
-
Match Between System and Real World: Does it use familiar language?
- Avoid jargon, use user vocabulary
- â Example: “Archive” not “Deprecate”
-
User Control and Freedom: Can users undo mistakes?
- Undo/redo, cancel buttons, back navigation
- â Example: “Are you sure?” confirmation for destructive actions
-
Consistency and Standards: Do similar things look/behave the same?
- Consistent button placement, color meanings, terminology
- â Example: Primary action always on right, danger always red
-
Error Prevention: Does it prevent errors before they happen?
- Constraints (disable invalid options), confirmation dialogs
- â Example: Disable “Submit” until required fields are filled
-
Recognition Rather Than Recall: Is information visible, not hidden?
- Show recent items, autocomplete, tooltips
- â Example: Show recently used colors in color picker
-
Flexibility and Efficiency: Are there shortcuts for experts?
- Keyboard shortcuts, batch actions, customization
- â Example: Cmd+K for search, drag-to-select multiple
-
Aesthetic and Minimalist Design: Is every element necessary?
- Remove decorative elements, prioritize content
- â Example: Hide advanced options behind “Advanced” toggle
-
Help Users Recognize, Diagnose, and Recover from Errors: Are errors helpful?
- Plain language, suggest solutions, show where error occurred
- â Example: “Email format invalid. Try: name@example.com“
-
Help and Documentation: Is help contextual and searchable?
- Tooltips, inline help, search-optimized docs
- â Example: “What’s this?” icon next to complex fields
Information Architecture
Card Sorting (for Navigation)
Purpose: Understand how users mentally group content
Process:
- Create cards for each content item (30-50 cards)
- Ask users to group cards into categories that make sense
- Ask users to name each category
- Analyze groupings to find patterns
Output: Sitemap with user-validated categories
Site Map Template
Homepage
âââ About
â âââ Team
â âââ Mission
â âââ Contact
âââ Services
â âââ Design System Lift-Off
â âââ AI Brand Ops
â âââ AI UX Sprint
âââ Work (Portfolio)
â âââ Case Study 1
â âââ Case Study 2
â âââ All Projects
âââ Blog
âââ Articles
âââ Authors
User Flows & Journey Mapping
User Flow Diagram
Purpose: Visualize how users move through a task
Example: Contact Form Submission
[User lands on Contact page]
â
[Reads page content]
â
[Fills form fields] â [Validation error?] â [Fix errors]
â â
[Clicks Submit] âââââââââââââââââââââââââââââââââââââ
â
[Loading state]
â
[Success confirmation] â [Receives email]
â
[CTA: Browse services]
Flow Analysis Checklist:
- Is the happy path clear?
- Are error states handled gracefully?
- Can users exit at any point?
- Is there a clear next action after completion?
Journey Map Template
For: [User Persona Name] Scenario: [Specific goal or task]
| Stage | User Action | Thoughts | Emotions | Pain Points | Opportunities |
|---|---|---|---|---|---|
| Awareness | Googles “design system consultancy” | “Need help scaling our design…” | Hopeful but overwhelmed | Too many options | Clear positioning: “DS Lift-Off in 4 weeks” |
| Consideration | Visits homepage, reads case studies | “Do they understand my problem?” | Skeptical | Vague outcomes | Show metrics: “50% faster onboarding” |
| Decision | Checks pricing, reads testimonials | “Can I afford this?” | Anxious | No transparent pricing | Price ranges + ROI calculator |
| Onboarding | Books consultation, fills form | “What happens next?” | Uncertain | No confirmation email | Auto-reply + calendar invite |
| Experience | Receives deliverables | “This is exactly what I needed!” | Relieved | – | Upsell: Care retainer |
Wireframing Guidelines
Low-Fidelity Wireframes (Sketches)
When: Early exploration, rapid iteration
Tools: Paper, whiteboard, Figma low-fi kit
Focus:
- Layout structure
- Content hierarchy
- Navigation patterns
- Interaction zones
Example: Service Page Wireframe
âââââââââââââââââââââââââââââââââââââââ
â Logo Nav1 Nav2 Nav3 [CTA] â â Header
âââââââââââââââââââââââââââââââââââââââ¤
â â
â âââââââââââââââââââââââââââââââ â
â â [ Hero Image ] â â â Hero
â â DESIGN SYSTEM LIFT-OFF â â
â â Get production-ready DS â â
â â in 4 weeks â â
â â [Book Consultation] â â
â âââââââââââââââââââââââââââââââ â
â â
â âââââââââââââ¬ââââââââââââ¬âââââââ â
â â Week 1 â Week 2 âWeek 3â â â Process
â â Discovery â Build âLaunchâ â
â âââââââââââââ´ââââââââââââ´âââââââ â
â â
â DELIVERABLES: â â Details
â - Token system â
â - 20+ components â
â - Documentation â
â â
â PRICING: â¬18-25k â
â [Get Started] â
â â
â âââââââââââ âââââââââââ â â Testimonials
â â Quote 1 â â Quote 2 â â
â âââââââââââ âââââââââââ â
âââââââââââââââââââââââââââââââââââââââ
High-Fidelity Wireframes
When: Pre-development handoff
Include:
- Real content (not lorem ipsum)
- Actual component names from design system
- Interaction states (hover, active, disabled)
- Responsive breakpoints (mobile, tablet, desktop)
- Annotations for developers
Conversion Optimization
Landing Page Anatomy (CRO Best Practices)
Above the Fold:
âââ Unique Value Prop (10 words max)
âââ Subheadline (explain who it's for)
âââ Hero Image/Video (show product in context)
âââ Primary CTA (action-oriented: "Start Your Lift-Off")
Social Proof:
âââ Client logos (6-8 recognizable brands)
âââ Testimonial with photo + name + company
âââ Metric (e.g., "500+ components shipped")
Benefits (Not Features):
âââ Benefit 1: "Launch faster" (not "Component library")
âââ Benefit 2: "Scale your team" (not "Documentation")
âââ Each with icon + short description
How It Works:
âââ Step 1 â Step 2 â Step 3 (visual timeline)
âââ Keep it to 3-4 steps max
Objection Handling:
âââ FAQ (address top 5 objections)
âââ Risk reversal ("If we don't hit KPIs, 2 weeks free")
Final CTA:
âââ Repeat primary CTA
âââ Low-friction secondary ("Download case study")
Accessibility UX Patterns
Keyboard Navigation
Tab Order:
- Skip to main content link (first tab)
- Navigation menu
- Main content (logical reading order)
- Footer
Shortcuts:
Tab/Shift+Tab: Navigate forward/backEnter/Space: Activate buttons/linksEsc: Close modals/menusArrow keys: Navigate within components (tabs, dropdowns)
Screen Reader Optimization
Landmarks:
<header>...</header> <!-- Banner -->
<nav aria-label="Main">...</nav>
<main>...</main>
<aside>...</aside> <!-- Complementary -->
<footer>...</footer> <!-- Contentinfo -->
ARIA Labels:
<!-- For icons without text -->
<button aria-label="Close dialog">
<svg>...</svg>
</button>
<!-- For complex widgets -->
<div role="tablist" aria-label="Service options">
<button role="tab" aria-selected="true">Lift-Off</button>
<button role="tab" aria-selected="false">Brand Ops</button>
</div>
Mobile-First UX
Progressive Disclosure
Pattern: Show essentials first, reveal details on demand
Example: Service Card
Mobile (320px):
âââââââââââââââââââ
â DS Lift-Off â
â 4 weeks â
â â¬18-25k â
â [Learn More] â
âââââââââââââââââââ
Desktop (1024px):
âââââââââââââââââââââââââââââââââââââââââââââââ
â Design System Lift-Off â¬18-25kâ
â Get a production-ready design system in 4 â
â weeks. Includes tokens, components, docs. â
â â
â â Token system â Documentation â
â â 20+ components â Training sessions â
â â
â [Book Consultation] [Download Case Study] â
âââââââââââââââââââââââââââââââââââââââââââââââ
Touch Target Sizes
- Minimum: 44Ã44px (iOS), 48Ã48px (Material Design)
- Spacing: 8px between targets minimum
- Hit area > visual size (padding increases tap zone)
.button {
padding: 12px 24px; /* Visual size */
/* Extend hit area with pseudo-element */
position: relative;
}
.button::before {
content: '';
position: absolute;
inset: -8px; /* 8px hit area extension */
}
Cognitive Load Optimization
Miller’s Law: 7±2 Items
Problem: Long lists overwhelm users
Solution: Chunk information into 5-7 groups
Bad Example (12 navigation items):
Home | About | Team | Mission | Services | Pricing | Work | Case Studies | Blog | Authors | Contact | FAQ
Good Example (5 groups):
About (Team, Mission)
Services (Pricing, Offerings)
Work (Portfolio, Case Studies)
Insights (Blog, Authors)
Contact
Hick’s Law: Choice Overload
Problem: More options = slower decisions
Solution: Reduce choices, guide users
Example: Service Selection
Bad (overwhelming):
- Design System Audit ($X)
- Token Architecture ($Y)
- Component Library ($Z)
- Documentation ($A)
- Training ($B)
- Governance ($C)
- Maintenance ($D)
Good (packaged):
- Lift-Off (Audit + Tokens + Library) – â¬18-25k
- Brand Ops (Templates + Governance) – â¬12-18k
- AI Sprint (Prototype + Evaluation) – â¬9-14k
Micro-Interactions
Feedback Patterns
States to design for:
- Idle: Default state
- Hover: Cursor over element (desktop only)
- Focus: Keyboard navigation
- Active: Click/tap in progress
- Loading: Async operation
- Success: Operation complete
- Error: Operation failed
- Disabled: Unavailable
Button Example:
Idle: [Submit] (blue background)
Hover: [Submit] (darker blue, slight scale)
Focus: [Submit] (outline visible)
Active: [Submit] (pressed effect)
Loading: [â Submitting...] (spinner + text)
Success: [â Submitted] (green, checkmark)
Error: [â Try Again] (red, error icon)
Disabled: [Submit] (gray, cursor not-allowed)
Form UX Best Practices
Input Field Design
Label:
- Always visible (not placeholder)
- Above input (not inline)
- Clear language ("Email address" not "Email")
Input:
- Large enough for touch (48px height min)
- Correct input type (email, tel, number)
- Autocomplete enabled
- Clear error state (red border + icon)
Help Text:
- Below input (not in placeholder)
- Show before user interacts
- Example: "We'll never share your email"
Error Message:
- Specific ("Email missing @" not "Invalid")
- Show immediately after blur
- Suggest fix ("Try: name@example.com")
Success State:
- Green checkmark when valid
- Optional: "Looks good!" message
Multi-Step Forms
Progress Indicator:
Step 1: Contact Info â Step 2: Details â Step 3: Review
[â] [â] [â]
Best Practices:
- Show progress (step X of Y)
- Allow back navigation (no data loss)
- Save drafts automatically
- Show error summary at top
- Validate per-step, not only on submit
Design System UX Patterns
Component Discovery
Problem: Designers/developers can’t find the right component
Solution: Multi-faceted navigation in Storybook
- By Category: Layout, Forms, Feedback, Data Display
- By Use Case: “I need to show a loading state” â Spinner
- By Search: Fuzzy search across component names and tags
- By Status: Production, Beta, Deprecated, WIP
Component Documentation Template
# Button
## When to use
Use buttons for primary actions like submitting forms or confirming decisions.
## When NOT to use
Don't use buttons for navigationâuse links instead.
## Variants
- **Primary**: Main action on page (one per screen)
- **Secondary**: Alternative actions
- **Danger**: Destructive actions (delete, remove)
## Accessibility
- Always include visible text (not icon-only)
- Loading state announces to screen readers
- Disabled buttons explain why ("Save unavailable: form incomplete")
## Examples
[Storybook playground with live code]
Metrics & KPIs
UX Metrics Framework
| Metric | What | How to Measure |
|---|---|---|
| Task Success Rate | % of users who complete task | Usability testing |
| Time on Task | How long to complete | Analytics + testing |
| Error Rate | % of actions that result in error | Error tracking |
| Satisfaction (SUS) | Subjective usability score | Post-task survey |
| Net Promoter Score | Would recommend? | Email survey |
| Bounce Rate | % who leave immediately | Google Analytics |
| Conversion Rate | % who complete goal | Analytics funnel |
System Usability Scale (SUS) Survey
Post-task questionnaire (1 = Strongly Disagree, 5 = Strongly Agree):
- I think I would like to use this system frequently
- I found the system unnecessarily complex
- I thought the system was easy to use
- I think I would need support to use this system
- I found the various functions well integrated
- I thought there was too much inconsistency
- I would imagine most people would learn quickly
- I found the system very cumbersome to use
- I felt very confident using the system
- I needed to learn a lot before I could get going
Score: (Sum odd items – 5) + (25 – sum even items) Ã 2.5 Benchmark: 68+ is above average
When to Use This Skill
Activate this skill when:
- Planning user research studies
- Creating user personas or journey maps
- Designing user flows or wireframes
- Conducting usability tests
- Performing heuristic evaluations
- Optimizing conversion funnels
- Improving form UX
- Designing accessible experiences
- Reducing cognitive load
- Measuring UX success metrics
- Auditing information architecture
- Creating mobile-first experiences
Remember: Always validate designs with real users before development.