mcpField
U
user-research

user-research

github.com/yonatangrossDesign & UI300128 installsUpdated today
Repository

About user-research

User Research is a structured research-method skill for product teams, covering personas, journey maps, interviews, usability testing, and Jobs-to-be-Done. It helps researchers choose methods for their questions and turn findings into actionable product insights.

Key features

  1. 01Selects methods by research question
  2. 02Builds personas and empathy maps
  3. 03Maps user journeys
  4. 04Guides interviews and usability tests
  5. 05Applies Jobs-to-be-Done

Use cases

  1. 01Explore user needs and unmet problems
  2. 02Validate designs and find usability issues
  3. 03Map experience stages and pain points
  4. 04Translate research findings into product requirements

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/yonatangross/orchestkit --skill user-research

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

Bundled files

References and scripts installed along with SKILL.md.

test-cases.json
references/
interview-guide-template.md
journey-map-workshop.md
user-story-workshop-guide.md
rules/
_sections.md
research-journey-mapping.md
research-personas.md
research-user-interviews.md

Details

From the project README

User Research

Frameworks for building deep user understanding through structured research methods. Covers personas, journey mapping, interviews, usability testing, and Jobs-to-be-Done.

Research Method Selection

Choose the right method for your question:

MethodWhen to UseSample SizeTimeOutput
User InterviewsEarly discovery, deep understanding5-82-3 weeksQualitative insights
Usability TestingValidate designs, find issues5-101-2 weeksActionable fixes
SurveysQuantify attitudes, preferences100+1-2 weeksStatistical data
Card SortingInformation architecture15-301 weekIA recommendations
A/B TestingCompare alternatives1000+2-4 weeksStatistical winner

Rule of thumb: Start with interviews (5-8 participants) to discover unknowns. Switch to surveys once you have hypotheses to validate.

Persona Quick Reference

Personas are fictional composites built from research synthesis. Keep to 3-5 max.

## Persona: [Name]

### Demographics
- Age: [Range]
- Role: [Job title]
- Company: [Type/size]
- Tech savviness: [Low/Medium/High]

### Quote
> "[Characteristic statement that captures their mindset]"

### Goals
1. [Primary goal - what success looks like]
2. [Secondary goal]

### Pain Points
1. [Frustration with current state]
2. [Obstacle they face]

### Key Insight
[The most important thing to remember about this persona]

Incorrect — vague persona without goals:

Persona: Sarah, Age 35, Marketing Manager. Likes social media and coffee.

Correct — actionable persona with goals and pain points:

Persona: DevOps Dana
Quote: "I don't have time for tools that create more work than they save."
Goals: Reduce deployment failures, give devs self-service capabilities
Pain Points: Alert fatigue from false positives, context-switching between 10+ tools
Key Insight: Evaluates tools by "time saved vs. time invested" — needs immediate value.

Journey Map Structure

Maps the end-to-end experience for a specific persona and scenario.

## Journey Map: [Journey Name]

### Persona + Scenario
[Which persona | What they're trying to accomplish]

### Stages: Aware → Consider → Purchase → Onboard → Use → Retain

For each stage:
- **Touchpoints:** [Channel/interaction point]
- **Actions:** [What user does]
- **Emotions:** [Satisfied / Neutral / Frustrated]
- **Pain Points:** [Friction]
- **Opportunities:** [How we improve]

Common B2B SaaS stages: Awareness → Evaluation → Purchase → Onboarding → Adoption → Expansion → Advocacy/Churn

JTBD Framework

People don't buy products — they hire them to do specific jobs.

JTBD Statement Format:

When [situation], I want to [motivation], so I can [expected outcome].

Example:

When I'm preparing for a board review, I want to quickly see revenue trends,
so I can answer questions confidently without scrambling for data.

Job Dimensions:

DimensionDescription
FunctionalPractical task to accomplish
EmotionalHow the user wants to feel
SocialHow the user wants to be perceived

Opportunity Score: Importance + (Importance - Satisfaction) — scores > 10 indicate high-opportunity areas.

Empathy Map

Quick tool for building shared understanding in workshops:

+-------------------------+-------------------------------+
|         SAYS            |            THINKS             |
| Direct quotes           | Worries and concerns          |
| Questions asked         | Aspirations                   |
+-------------------------+-------------------------------+
|         DOES            |            FEELS              |
| Observable actions      | Emotional state               |
| Workarounds             | Frustrations and delights     |
+-------------------------+-------------------------------+
|         PAINS           |            GAINS              |
| Fears and obstacles     | Wants and needs               |
+-------------------------+-------------------------------+

Interview Best Practices

DoDon't
Ask open-ended questionsAsk leading questions
Ask "why" and "how"Accept surface answers
Follow interesting threadsStick rigidly to script
Take verbatim notesParaphrase or interpret

Standard interview arc: Warm-up (5 min) → Context setting (10 min) → Deep dive (25 min) → Wrap-up (5 min)

Rules (Load On-Demand)

Read these files for detailed guidance:

References

Related Skills

  • ork:write-prd — Translate research insights into structured product requirements
  • ork:product-frameworks — Full PM framework suite (business cases, prioritization, metrics, OKRs)

Version: 1.0.0

Comments

Markdown supported