.agents/skills/ux-research/SKILL.md
UX Research methodology for information architecture, user flows, wireframing, heuristic evaluation, and usability analysis. Use when designing user experiences, mapping journeys, or evaluating interface usability.
npx skillsauth add JoelBonito/gestion-chs ux-researchInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
"Design is not what it looks like. Design is how it works." — Steve Jobs
Provide structured methods for understanding users, designing experiences, and evaluating usability before visual design or implementation begins.
Before designing navigation or flows, map all content:
### Content Inventory
| Content Type | Source | Volume | Priority | Notes |
|-------------|--------|--------|----------|-------|
| [Type] | [Where it comes from] | [Estimated amount] | Core/Supporting/Optional | [Notes] |
### Application Map
- **Level 0:** Entry point (Landing / Login)
- **Level 1:** Primary sections (Dashboard, Profile, Settings)
- **Level 2:** Sub-sections (Dashboard > Analytics, Dashboard > Reports)
- **Level 3:** Detail views (Reports > Report Detail > Export)
Use Mermaid for visual mapping:
graph TD
A[Landing] --> B{Authenticated?}
B -->|No| C[Login/Register]
B -->|Yes| D[Dashboard]
D --> E[Feature A]
D --> F[Feature B]
D --> G[Settings]
| Pattern | Best For | Avoid When | |---------|----------|------------| | Top Navigation | 3-7 primary sections, desktop-first | Deep hierarchies, mobile-first | | Side Navigation | Complex apps, many sections | Simple apps, content-focused | | Bottom Tabs | Mobile apps, 3-5 sections | More than 5 items | | Hamburger Menu | Secondary navigation, mobile overflow | Primary navigation (reduces discoverability) | | Breadcrumbs | Deep hierarchies, e-commerce | Flat structures | | Tab Bar | Related content sections | Unrelated sections |
When organizing content, think from the user's perspective:
### Card Sort Results
| User Mental Model | System Category | Match? | Action |
|-------------------|----------------|--------|--------|
| [How users think of it] | [How system organizes it] | Yes/No | [Adjust if no] |
| Type | Purpose | Detail Level | |------|---------|-------------| | Task Flow | Single task, no decisions | Step-by-step linear | | User Flow | Task with decisions/branches | Flowchart with conditions | | Wire Flow | Flow + interface sketches | Flowchart with wireframes |
### Task Flow: [Task Name]
**Goal:** [What the user wants to achieve]
**Persona:** [Which user]
**Entry Point:** [Where they start]
**Success State:** [What "done" looks like]
| Step | User Action | System Response | Screen |
|------|-------------|-----------------|--------|
| 1 | [Action] | [Response] | [Screen name] |
| 2 | [Action] | [Response] | [Screen name] |
| 3 | [Action] | [Response] | [Screen name] |
flowchart TD
START([User arrives]) --> A[Screen: Landing]
A --> B{Has account?}
B -->|Yes| C[Screen: Login]
B -->|No| D[Screen: Register]
C --> E{Valid credentials?}
E -->|Yes| F[Screen: Dashboard]
E -->|No| G[Error: Invalid credentials]
G --> C
D --> H[Screen: Onboarding]
H --> F
F --> END([Goal achieved])
| Metric | Target | Measurement | |--------|--------|-------------| | Steps to complete | Minimum viable steps | Count from entry to success | | Decision points | Minimize choices | Count branches in flow | | Error recovery paths | Always available | Count error → recovery routes | | Time on task | Under [N] seconds | Benchmark against competitors |
### Screen: [Screen Name]
**Purpose:** [Why this screen exists]
**Entry Points:** [How user arrives here]
**Exit Points:** [Where user can go from here]
#### Layout Structure
+--------------------------------------------------+ | [Header: Logo | Navigation | User Menu] | +--------------------------------------------------+ | [Sidebar] | [Main Content Area] | | | | | - Nav 1 | [Section Title] | | - Nav 2 | [Content Block 1] | | - Nav 3 | [Content Block 2] | | | | | | [Action Bar: Primary CTA | Secondary]| +--------------------------------------------------+ | [Footer: Links | Legal | Contact] | +--------------------------------------------------+
#### Elements
| Element | Type | Behavior | Priority |
|---------|------|----------|----------|
| [Element name] | [Button/Input/List/etc] | [What happens on interaction] | Primary/Secondary/Tertiary |
#### States
| State | Trigger | Visual Change |
|-------|---------|---------------|
| Empty | No data | [Empty state message + CTA] |
| Loading | Fetching data | [Skeleton/Spinner] |
| Error | API failure | [Error message + retry] |
| Success | Action complete | [Confirmation feedback] |
### Heuristic Evaluation: [Feature/Screen Name]
| # | Heuristic | Status | Issues Found | Severity | Recommendation |
|---|-----------|--------|-------------|----------|----------------|
| 1 | **Visibility of System Status** | Pass/Fail | [Issue] | 0-4 | [Fix] |
| 2 | **Match Between System and Real World** | Pass/Fail | [Issue] | 0-4 | [Fix] |
| 3 | **User Control and Freedom** | Pass/Fail | [Issue] | 0-4 | [Fix] |
| 4 | **Consistency and Standards** | Pass/Fail | [Issue] | 0-4 | [Fix] |
| 5 | **Error Prevention** | Pass/Fail | [Issue] | 0-4 | [Fix] |
| 6 | **Recognition Rather Than Recall** | Pass/Fail | [Issue] | 0-4 | [Fix] |
| 7 | **Flexibility and Efficiency of Use** | Pass/Fail | [Issue] | 0-4 | [Fix] |
| 8 | **Aesthetic and Minimalist Design** | Pass/Fail | [Issue] | 0-4 | [Fix] |
| 9 | **Help Users Recognize, Diagnose, and Recover from Errors** | Pass/Fail | [Issue] | 0-4 | [Fix] |
| 10 | **Help and Documentation** | Pass/Fail | [Issue] | 0-4 | [Fix] |
| Score | Severity | Definition | |-------|----------|-----------| | 0 | Not a problem | Heuristic satisfied | | 1 | Cosmetic | Fix if time allows | | 2 | Minor | Low priority fix | | 3 | Major | High priority fix | | 4 | Catastrophe | Must fix before launch |
Apply these when designing flows and layouts:
| Law | Principle | Application | |-----|-----------|-------------| | Fitts's Law | Larger targets are easier to hit | Make CTAs large and reachable | | Hick's Law | More choices = more decision time | Limit options per screen (5-7) | | Jakob's Law | Users prefer familiar patterns | Use conventions from established products | | Miller's Law | Working memory holds 7 +/- 2 items | Chunk information into groups | | Tesler's Law | Complexity cannot be eliminated, only moved | Move complexity to backend, simplify frontend | | Von Restorff Effect | Distinct items are more memorable | Highlight primary actions visually | | Doherty Threshold | Interactions < 400ms feel instant | Optimize perceived performance | | Postel's Law | Be liberal in what you accept | Accept varied input formats | | Peak-End Rule | Users remember peaks and endings | Make key moments and final interactions delightful | | Aesthetic-Usability Effect | Beautiful things are perceived as easier to use | Invest in visual polish for trust |
### Friction Audit: [Flow Name]
| Step | Expected Action | Friction Type | Severity (1-5) | Root Cause | Fix |
|------|----------------|---------------|-----------------|------------|-----|
| [N] | [What user should do] | [Type] | [1-5] | [Why it's hard] | [Solution] |
| Type | Description | Example | |------|-------------|---------| | Cognitive | Mental effort required | Complex form with unclear labels | | Interaction | Physical effort / clicks | Too many steps to complete task | | Emotional | Anxiety, confusion, frustration | Unclear pricing, hidden fees | | Visual | Hard to see or read | Low contrast, small text | | Temporal | Takes too long | Slow loading, long processes | | Access | Barriers to entry | Required sign-up before browsing |
| Category | Criteria | Level | Status | Notes | |----------|---------|-------|--------|-------| | Perceivable | Text alternatives for images | A | Pass/Fail | | | Perceivable | Captions for video/audio | A | Pass/Fail | | | Perceivable | Color contrast 4.5:1 (text) | AA | Pass/Fail | | | Perceivable | Color contrast 3:1 (UI elements) | AA | Pass/Fail | | | Perceivable | Content reflows at 320px | AA | Pass/Fail | | | Operable | Keyboard navigable | A | Pass/Fail | | | Operable | No keyboard traps | A | Pass/Fail | | | Operable | Skip navigation links | A | Pass/Fail | | | Operable | Focus order logical | A | Pass/Fail | | | Operable | Focus indicator visible | AA | Pass/Fail | | | Understandable | Language declared | A | Pass/Fail | | | Understandable | Error identification clear | A | Pass/Fail | | | Understandable | Labels for inputs | A | Pass/Fail | | | Robust | Valid HTML | A | Pass/Fail | | | Robust | Name, Role, Value for custom widgets | A | Pass/Fail | |
Before designing any screen, verify:
| Flow | Primary Persona | Secondary Persona | Persona-Specific Adaptations |
|------|----------------|-------------------|------------------------------|
| [Flow] | [Persona A] | [Persona B] | [Differences in experience] |
tools
n8n workflow automation principles, patterns, and validation. Expression syntax, node configuration, MCP tools usage, code node patterns.
testing
# Example Skill > Template skill for specialist squads. Replace with your domain-specific knowledge. ## Overview This skill provides domain-specific knowledge and patterns for the squad. ## When to Use - When the squad needs domain expertise - When applying domain-specific patterns - When reviewing domain-related outputs ## Key Principles 1. **Principle 1:** Description of the first principle 2. **Principle 2:** Description of the second principle 3. **Principle 3:** Description of the th
development
Web application testing principles. E2E, Playwright, deep audit strategies.
development
Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".