@ericrisco/rsc 3.3.0 → 3.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (56) hide show
  1. package/README.md +6 -3
  2. package/manifest.json +43 -22
  3. package/package.json +1 -1
  4. package/scripts/lib/default-skill-floor.js +5 -1
  5. package/scripts/lib/domains.js +2 -2
  6. package/scripts/lib/retired-skills.js +4 -0
  7. package/skills/design/SKILL.md +4 -3
  8. package/skills/design/evals/cases.yaml +2 -2
  9. package/skills/react/SKILL.md +2 -1
  10. package/skills/suggest/SKILL.md +12 -8
  11. package/skills/suggest/evals/cases.yaml +6 -0
  12. package/skills/ux/SKILL.md +149 -0
  13. package/skills/ux/THIRD_PARTY.md +32 -0
  14. package/skills/ux/evals/cases.yaml +40 -0
  15. package/skills/ux/references/flows.md +124 -0
  16. package/skills/ux/upstream/UPSTREAM.json +59 -0
  17. package/skills/ux/upstream/ux-designer/GUIDE.md +180 -0
  18. package/skills/ux/upstream/ux-designer/LICENSE +21 -0
  19. package/skills/ux/upstream/ux-designer/references/01-core-principles.md +251 -0
  20. package/skills/ux/upstream/ux-designer/references/02-laws-of-ux.md +330 -0
  21. package/skills/ux/upstream/ux-designer/references/03-accessibility.md +411 -0
  22. package/skills/ux/upstream/ux-designer/references/04-visual-design.md +433 -0
  23. package/skills/ux/upstream/ux-designer/references/05-information-architecture.md +432 -0
  24. package/skills/ux/upstream/ux-designer/references/06-interaction-design.md +495 -0
  25. package/skills/ux/upstream/ux-designer/references/07-forms-and-inputs.md +491 -0
  26. package/skills/ux/upstream/ux-designer/references/08-mobile-ux.md +539 -0
  27. package/skills/ux/upstream/ux-designer/references/09-ux-writing.md +493 -0
  28. package/skills/ux/upstream/ux-designer/references/10-user-research.md +533 -0
  29. package/skills/ux/upstream/ux-designer/references/11-design-systems.md +618 -0
  30. package/skills/ux/upstream/ux-designer/references/12a-presence-awareness.md +395 -0
  31. package/skills/ux/upstream/ux-designer/references/12b-conflict-resolution-sync.md +420 -0
  32. package/skills/ux/upstream/ux-designer/references/13a-canvas-navigation.md +388 -0
  33. package/skills/ux/upstream/ux-designer/references/13b-canvas-objects-performance.md +559 -0
  34. package/skills/ux/upstream/ux-designer/references/14-ai-ux-patterns.md +511 -0
  35. package/skills/ux/upstream/ux-designer/references/15-ethical-design.md +419 -0
  36. package/skills/ux/upstream/ux-designer/references/16-onboarding.md +430 -0
  37. package/skills/ux/upstream/ux-designer/references/17-notifications.md +461 -0
  38. package/skills/ux/upstream/ux-designer/references/18-data-visualization.md +453 -0
  39. package/skills/ux/upstream/ux-designer/references/19-search-ux.md +479 -0
  40. package/skills/ux/upstream/ux-designer/references/20-emotional-design.md +382 -0
  41. package/skills/ux/upstream/ux-designer/references/21-data-tables.md +629 -0
  42. package/skills/ux/upstream/ux-designer/references/22-performance-ux.md +626 -0
  43. package/skills/ux/upstream/ux-designer/references/23-internationalization.md +347 -0
  44. package/skills/ux/upstream/ux-designer/references/24-voice-and-multimodal.md +308 -0
  45. package/skills/ux/upstream/ux-designer/references/25a-barcode-camera-scanning.md +342 -0
  46. package/skills/ux/upstream/ux-designer/references/25b-barcode-scanner-workflows.md +412 -0
  47. package/skills/ux/upstream/ux-designer/references/25c-barcode-display.md +277 -0
  48. package/skills/ux/upstream/ux-usability-foundations/GUIDE.md +285 -0
  49. package/skills/ux/upstream/ux-usability-foundations/LICENSE +21 -0
  50. package/skills/ux/upstream/ux-usability-foundations/references/anti-patterns.md +267 -0
  51. package/skills/ux/upstream/ux-usability-foundations/references/checklists.md +130 -0
  52. package/skills/ux/upstream/ux-usability-foundations/references/decision-prompts.md +340 -0
  53. package/skills/ux/upstream/ux-usability-foundations/references/principle-cards.md +449 -0
  54. package/targets/clone-bootstrap.mjs +1 -1
  55. package/skills/ui-engineering/SKILL.md +0 -113
  56. package/skills/ui-engineering/evals/cases.yaml +0 -38
@@ -0,0 +1,533 @@
1
+ # User Research Methods
2
+
3
+ User research is the systematic study of target users to understand their behaviors, needs, and motivations. It informs design decisions with evidence rather than assumptions.
4
+
5
+ ---
6
+
7
+ ## Contents
8
+
9
+ - Why User Research?
10
+ - Research Categories
11
+ - Core Research Methods
12
+ - Research Planning
13
+ - Remote vs. In-Person Research
14
+ - Research Analysis
15
+ - Presenting Research Findings
16
+ - 2026 Trends
17
+ - Ethical Considerations
18
+ - Tools Overview
19
+ - Sources
20
+
21
+ ---
22
+
23
+ ## Why User Research?
24
+
25
+ ### Benefits
26
+
27
+ - **Reduce risk** - Validate ideas before building
28
+ - **Save resources** - Avoid building unwanted features
29
+ - **Improve usability** - Design for real user needs
30
+ - **Increase satisfaction** - Create products people love
31
+ - **Drive conversion** - Remove friction in user journeys
32
+
33
+ ### Key Statistics (2025)
34
+
35
+ | Method | Popularity |
36
+ |--------|------------|
37
+ | User interviews | 86% |
38
+ | Usability testing | 84% |
39
+ | Surveys | 77% |
40
+ | Concept testing | 64% |
41
+
42
+ ---
43
+
44
+ ## Research Categories
45
+
46
+ ### Qualitative vs. Quantitative
47
+
48
+ | Qualitative | Quantitative |
49
+ |-------------|--------------|
50
+ | "Why" and "How" | "What" and "How many" |
51
+ | Deep understanding | Statistical significance |
52
+ | Small sample sizes | Large sample sizes |
53
+ | Exploratory | Measurable |
54
+ | Interviews, observations | Surveys, analytics |
55
+
56
+ ### Generative vs. Evaluative
57
+
58
+ | Generative (Discovery) | Evaluative (Validation) |
59
+ |------------------------|------------------------|
60
+ | What should we build? | Does this work? |
61
+ | Early-stage exploration | Testing solutions |
62
+ | Understand problems | Measure effectiveness |
63
+ | Interviews, field studies | Usability tests, A/B tests |
64
+
65
+ ---
66
+
67
+ ## Core Research Methods
68
+
69
+ ### 1. User Interviews
70
+
71
+ One-on-one conversations to understand user experiences, needs, and pain points.
72
+
73
+ **When to use:**
74
+ - Early discovery phase
75
+ - Understanding context of use
76
+ - Exploring new problem spaces
77
+ - Deep-diving into specific topics
78
+
79
+ **Best Practices:**
80
+
81
+ ```
82
+ Preparation:
83
+ - Define clear research questions
84
+ - Write a discussion guide
85
+ - Recruit representative participants (5-8)
86
+ - Plan for 45-60 minute sessions
87
+
88
+ During:
89
+ - Ask open-ended questions
90
+ - Follow up with "why" and "how"
91
+ - Avoid leading questions
92
+ - Listen more than you talk
93
+ - Take notes or record (with permission)
94
+
95
+ Question Examples:
96
+ ✓ "Tell me about the last time you..."
97
+ ✓ "Walk me through how you..."
98
+ ✓ "What was the hardest part about..."
99
+ ✓ "Why did you choose that approach?"
100
+
101
+ ✗ "Do you like feature X?" (leading)
102
+ ✗ "Would you use this?" (hypothetical)
103
+ ✗ "Isn't this confusing?" (leading)
104
+ ```
105
+
106
+ ### 2. Usability Testing
107
+
108
+ Observing users as they attempt to complete tasks with your product.
109
+
110
+ **When to use:**
111
+ - Validating design decisions
112
+ - Identifying usability issues
113
+ - Comparing design alternatives
114
+ - Before and after redesigns
115
+
116
+ **Types:**
117
+
118
+ | Type | Description | Sample Size |
119
+ |------|-------------|-------------|
120
+ | Moderated | Facilitator guides the session | 5-8 |
121
+ | Unmoderated | Participant completes alone | 10-20+ |
122
+ | Remote | Via video conferencing | Any |
123
+ | In-person | Same physical location | 5-8 |
124
+
125
+ **Best Practices:**
126
+
127
+ ```
128
+ Task Design:
129
+ - Realistic scenarios
130
+ - Specific, measurable goals
131
+ - Avoid hints in wording
132
+ - Test critical paths
133
+
134
+ Metrics:
135
+ - Task success rate
136
+ - Time on task
137
+ - Error rate
138
+ - Satisfaction rating (SUS, NPS)
139
+ - Qualitative observations
140
+
141
+ Running the Test:
142
+ - "Think aloud" protocol
143
+ - Don't help unless stuck
144
+ - Note where users struggle
145
+ - Ask follow-up questions after tasks
146
+ ```
147
+
148
+ ### 3. Surveys
149
+
150
+ Collecting structured data from many users.
151
+
152
+ **When to use:**
153
+ - Measuring satisfaction (NPS, CSAT)
154
+ - Validating findings at scale
155
+ - Prioritizing features
156
+ - Segmenting users
157
+ - Benchmarking over time
158
+
159
+ **Best Practices:**
160
+
161
+ ```
162
+ Question Design:
163
+ - One concept per question
164
+ - Avoid leading language
165
+ - Include "I don't know" option
166
+ - Mix question types
167
+
168
+ Question Types:
169
+ - Multiple choice (easy to analyze)
170
+ - Rating scales (1-5 or 1-7)
171
+ - Open-ended (qualitative insights)
172
+ - Matrix questions (use sparingly)
173
+
174
+ Keep It Short:
175
+ - 5-10 minutes maximum
176
+ - Front-load important questions
177
+ - Make it mobile-friendly
178
+ - Show progress indicator
179
+ ```
180
+
181
+ **Tools:** Typeform, Google Forms, SurveyMonkey, Qualtrics
182
+
183
+ ### 4. Card Sorting
184
+
185
+ Understanding how users categorize and label information.
186
+
187
+ **When to use:**
188
+ - Designing navigation
189
+ - Organizing content
190
+ - Creating taxonomies
191
+ - Validating IA decisions
192
+
193
+ **Types:**
194
+
195
+ | Type | Description | Use |
196
+ |------|-------------|-----|
197
+ | Open | Users create their own categories | Discovery |
198
+ | Closed | Users sort into predefined categories | Validation |
199
+ | Hybrid | Mix of open and closed | Refinement |
200
+
201
+ **Tools:** OptimalSort, Maze, Miro
202
+
203
+ ### 5. Tree Testing
204
+
205
+ Validating whether users can find items in your information architecture.
206
+
207
+ **When to use:**
208
+ - Testing navigation structure
209
+ - Validating IA changes
210
+ - Before/after IA redesigns
211
+
212
+ **Process:**
213
+
214
+ ```
215
+ 1. Create text-only sitemap (tree)
216
+ 2. Write tasks: "Find where to return an item"
217
+ 3. Users navigate the tree to find the target
218
+ 4. Measure:
219
+ - Success rate
220
+ - Directness (first click correct)
221
+ - Time to complete
222
+ ```
223
+
224
+ **Tools:** Treejack, UXtweak
225
+
226
+ ### 6. Analytics Review
227
+
228
+ Analyzing behavioral data to understand what users do.
229
+
230
+ **When to use:**
231
+ - Always (continuous)
232
+ - Identifying problem areas
233
+ - Measuring feature adoption
234
+ - Understanding user flows
235
+
236
+ **Key Metrics:**
237
+
238
+ ```
239
+ Engagement:
240
+ - Page views, sessions
241
+ - Time on page
242
+ - Bounce rate
243
+ - Feature usage
244
+
245
+ Conversion:
246
+ - Conversion rate
247
+ - Drop-off points
248
+ - Funnel completion
249
+
250
+ User Behavior:
251
+ - Click patterns (heatmaps)
252
+ - Scroll depth
253
+ - Search queries
254
+ - Error rates
255
+ ```
256
+
257
+ **Tools:** Google Analytics, Mixpanel, Amplitude, Hotjar, FullStory
258
+
259
+ ### 7. A/B Testing
260
+
261
+ Comparing two or more versions to see which performs better.
262
+
263
+ **When to use:**
264
+ - Optimizing specific metrics
265
+ - Validating design changes
266
+ - Testing copy variations
267
+ - Resolving design debates
268
+
269
+ **Requirements:**
270
+
271
+ ```
272
+ - Sufficient traffic/users
273
+ - Clear hypothesis
274
+ - Single variable testing (ideally)
275
+ - Statistical significance threshold
276
+ - Adequate test duration
277
+ ```
278
+
279
+ **Tools:** Optimizely, VWO, Google Optimize (deprecated), LaunchDarkly
280
+
281
+ ---
282
+
283
+ ## Research Planning
284
+
285
+ ### Research Questions
286
+
287
+ ```
288
+ Good research questions:
289
+ - Specific and focused
290
+ - Answerable through research
291
+ - Actionable outcomes
292
+
293
+ Examples:
294
+ ✓ "What prevents users from completing checkout?"
295
+ ✓ "How do users currently track their expenses?"
296
+ ✓ "Which onboarding flow leads to higher activation?"
297
+
298
+ Not:
299
+ ✗ "Is our product good?"
300
+ ✗ "What do users want?"
301
+ ✗ "Should we build feature X?"
302
+ ```
303
+
304
+ ### Participant Recruitment
305
+
306
+ **Sample Sizes:**
307
+
308
+ | Method | Typical Sample |
309
+ |--------|---------------|
310
+ | Interviews | 5-12 |
311
+ | Usability testing | 5-8 per round |
312
+ | Card sorting | 15-30 |
313
+ | Surveys | 100+ for quantitative |
314
+ | A/B tests | Varies (statistical power) |
315
+
316
+ **Recruitment Sources:**
317
+ - Existing user base
318
+ - Recruitment platforms (UserTesting, Respondent.io)
319
+ - Social media
320
+ - Intercept surveys
321
+ - Panel providers
322
+
323
+ **Screening:**
324
+ - Demographics
325
+ - Relevant experience
326
+ - Product usage
327
+ - Technical requirements
328
+
329
+ ---
330
+
331
+ ## Remote vs. In-Person Research
332
+
333
+ ### Remote Research
334
+
335
+ **Advantages:**
336
+ - Global reach
337
+ - Lower cost
338
+ - More convenient
339
+ - Larger sample sizes
340
+ - Natural environment
341
+
342
+ **Challenges:**
343
+ - Technical issues
344
+ - Harder to build rapport
345
+ - Less contextual observation
346
+ - Distractions
347
+
348
+ **Tools:** Zoom, UserTesting, Lookback, Maze
349
+
350
+ ### In-Person Research
351
+
352
+ **Advantages:**
353
+ - Deeper rapport
354
+ - Full context observation
355
+ - Non-verbal cues visible
356
+ - Better for complex tasks
357
+ - Prototype testing
358
+
359
+ **Challenges:**
360
+ - Geographic limitations
361
+ - Higher cost
362
+ - Scheduling difficulties
363
+ - Lab environment effect
364
+
365
+ ---
366
+
367
+ ## Research Analysis
368
+
369
+ ### Affinity Mapping
370
+
371
+ Grouping observations to find patterns.
372
+
373
+ ```
374
+ 1. Write each observation on a sticky note
375
+ 2. Group similar observations
376
+ 3. Name the groups
377
+ 4. Identify themes and patterns
378
+ 5. Prioritize findings
379
+ ```
380
+
381
+ **Tools:** Miro, FigJam, physical sticky notes
382
+
383
+ ### Thematic Analysis
384
+
385
+ ```
386
+ 1. Familiarize with data
387
+ 2. Generate initial codes
388
+ 3. Search for themes
389
+ 4. Review themes
390
+ 5. Define and name themes
391
+ 6. Report findings
392
+ ```
393
+
394
+ ### Quantitative Analysis
395
+
396
+ ```
397
+ Basic:
398
+ - Descriptive statistics
399
+ - Task success rates
400
+ - Comparison of means
401
+
402
+ Advanced:
403
+ - Statistical significance testing
404
+ - Regression analysis
405
+ - Cohort analysis
406
+ ```
407
+
408
+ ---
409
+
410
+ ## Presenting Research Findings
411
+
412
+ ### Research Report Structure
413
+
414
+ ```
415
+ 1. Executive Summary
416
+ - Key findings
417
+ - Recommendations
418
+
419
+ 2. Research Overview
420
+ - Goals
421
+ - Methods
422
+ - Participants
423
+
424
+ 3. Detailed Findings
425
+ - Organized by theme
426
+ - Evidence and quotes
427
+ - Severity ratings
428
+
429
+ 4. Recommendations
430
+ - Prioritized actions
431
+ - Design implications
432
+ - Next steps
433
+ ```
434
+
435
+ ### Making Findings Actionable
436
+
437
+ ```
438
+ Instead of:
439
+ "Users were confused by the checkout flow"
440
+
441
+ Say:
442
+ "5 of 8 users couldn't find the promo code field.
443
+ Recommendation: Move promo code input above the order summary.
444
+ Impact: Could recover ~15% of abandoned carts."
445
+ ```
446
+
447
+ ---
448
+
449
+ ## 2026 Trends
450
+
451
+ ### AI in Research
452
+
453
+ - **Transcription:** Otter.ai, Dovetail
454
+ - **Analysis:** Pattern recognition in qualitative data
455
+ - **Synthesis:** Summarizing findings across studies
456
+ - **Moderation:** AI-assisted interview guides
457
+
458
+ 54% of researchers are experimenting with AI tools (2025 State of User Research)
459
+
460
+ ### Continuous Research
461
+
462
+ Moving from project-based to always-on research:
463
+ - Regular user touchpoints
464
+ - Embedded research in product teams
465
+ - Research repositories (Dovetail, Notion)
466
+ - Democratized research
467
+
468
+ ### Research Operations (ResOps)
469
+
470
+ - Standardized processes
471
+ - Participant panels
472
+ - Tool management
473
+ - Knowledge management
474
+ - Research training
475
+
476
+ ---
477
+
478
+ ## Ethical Considerations
479
+
480
+ ### Informed Consent
481
+
482
+ ```
483
+ Participants must know:
484
+ - Purpose of research
485
+ - How data will be used
486
+ - Their right to withdraw
487
+ - Recording/privacy details
488
+ - Compensation details
489
+ ```
490
+
491
+ ### Privacy
492
+
493
+ ```
494
+ - Anonymize data when possible
495
+ - Secure data storage
496
+ - Clear data retention policies
497
+ - GDPR/CCPA compliance
498
+ - Limit data access
499
+ ```
500
+
501
+ ### Inclusive Research
502
+
503
+ ```
504
+ - Recruit diverse participants
505
+ - Accommodate disabilities
506
+ - Consider cultural contexts
507
+ - Avoid biased questions
508
+ - Provide fair compensation
509
+ ```
510
+
511
+ ---
512
+
513
+ ## Tools Overview
514
+
515
+ | Category | Tools |
516
+ |----------|-------|
517
+ | Interviews | Zoom, UserInterviews.com |
518
+ | Usability | UserTesting, Maze, Lookback |
519
+ | Surveys | Typeform, SurveyMonkey |
520
+ | Analytics | Mixpanel, Amplitude, Hotjar |
521
+ | Card Sorting | OptimalSort, Maze |
522
+ | Repository | Dovetail, Condens, Notion |
523
+ | Prototyping | Figma, ProtoPie |
524
+
525
+ ---
526
+
527
+ ## Sources
528
+
529
+ - [User Interviews - State of User Research 2025](https://www.userinterviews.com/state-of-user-research-report)
530
+ - [Nielsen Norman Group - Research Methods](https://www.nngroup.com/articles/which-ux-research-methods/)
531
+ - Portigal, S. (2013). "Interviewing Users"
532
+ - Kuniavsky, M. (2012). "Observing the User Experience"
533
+ - [Maze - UX Research Methods](https://maze.co/guides/ux-research/)