mcpField
U
user-research

user-research

github.com/nicepkgDesign & UI28847 installsUpdated 40w ago
Repository

About user-research

user-research is a skill for product and design teams seeking to understand customer needs, behaviors, and pain points. It covers interviews, surveys, usability testing, observation, analytics, and methods for synthesizing findings.

Key features

  1. 01Guidance for selecting research methods
  2. 02Interview structure and questioning techniques
  3. 03Survey design and sample-size calculation
  4. 04Affinity mapping for research insights
  5. 05Persona and journey-map templates

Use cases

  1. 01Plan interview or survey research for a new product
  2. 02Find usability issues in an existing experience
  3. 03Synthesize themes and pain points from interviews
  4. 04Identify opportunities along a user journey

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/nicepkg/ai-workflow --skill user-research

After installing, type/user-researchin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

assets/
config.yaml
schema.json
references/
GUIDE.md
PATTERNS.md
scripts/
validate.py

Details

From the project README

User Research Skill

Conduct effective user research to understand customer needs, behaviors, and pain points. Master interview techniques and insight synthesis.

Research Methods

Method Selection Guide
MethodWhenSampleDuration
InterviewsDeep understanding15-2545-60 min
SurveysQuantitative validation100+5-10 min
UsabilityUX issues5-830-60 min
ObservationReal behavior3-52-4 hours
AnalyticsScale patternsAll usersOngoing

Qualitative Research

Interview Structure
OPENING (5 min):
- Intro & rapport
- Permission to record
- Context setting

CONTEXT (10 min):
- Role and responsibilities
- Day-to-day workflow
- Tools used

DEEP DIVE (20 min):
- "Walk me through [process]..."
- "Tell me about last time [problem]..."
- "What frustrates you most?"

IMPACT (10 min):
- "What happens when [problem]?"
- "How much time/money does it cost?"

FUTURE (10 min):
- "What would ideal look like?"
- "What would you pay for [solution]?"

CLOSING (5 min):
- "Anything else?"
- "Can I follow up?"
Interview Best Practices
  • Listen 70%, talk 30%
  • Ask "Why?" 5 times
  • Avoid leading questions
  • Use silence effectively
  • Capture quotes verbatim

Quantitative Research

Survey Design

Question Types:

  • Rating scale (1-5, 1-10)
  • Multiple choice
  • Open-ended (limit 1-2)
  • Ranking

NPS Question: "How likely are you to recommend [product] to a friend? (0-10)"

Sample Size Calculator
For 95% confidence, 5% margin:
- Population 100 → Sample 80
- Population 500 → Sample 217
- Population 1000 → Sample 278
- Population 10000 → Sample 370

Synthesis

Affinity Mapping
  1. Write each insight on sticky note
  2. Group similar insights
  3. Name each group (theme)
  4. Rank by frequency/impact
  5. Extract top 5-10 themes
Persona Template
NAME: [Descriptive name]
ROLE: [Job title, company type]
QUOTE: "[Real quote from research]"

GOALS:
- [Goal 1]
- [Goal 2]

FRUSTRATIONS:
- [Pain 1]
- [Pain 2]

BEHAVIORS:
- [How they work]
- [Tools they use]

NEEDS:
- [Need 1]
- [Need 2]
Journey Map
StageActionsEmotionsPain PointsOpportunities
AwareSearchCuriousHard to findSEO, content
ConsiderCompareConfusedToo many optionsComparison
PurchaseBuyAnxiousComplex checkoutSimplify
UseOnboardOverwhelmedSteep learningBetter UX

Troubleshooting

Yaygın Hatalar & Çözümler
HataOlası SebepÇözüm
Low responseWrong incentive$50-100 gift card
Surface insightsLeading questions"Why?" 5x
Conflicting dataMixed segmentsSegment analysis
No showScheduling issuesCalendar hold, reminder
Debug Checklist
[ ] Research plan documented mi?
[ ] Sample size sufficient mi?
[ ] Questions non-leading mi?
[ ] Recording consent alındı mı?
[ ] Synthesis done within 24h mi?
[ ] Insights actionable mi?
Recovery Procedures
  1. Low Participation → Increase incentive, new channels
  2. Conflicting Data → Segment by user type
  3. Shallow Insights → Follow-up interviews

Learning Outcomes

  • Plan effective research studies
  • Conduct insightful interviews
  • Design valid surveys
  • Synthesize research data
  • Present actionable insights

Comments

Markdown supported