.claude/skills/user-research-synthesis/SKILL.md
Turn user interviews into actionable insights. Advanced synthesis techniques and frameworks.
npx skillsauth add pisithrps/yapzee user-research-synthesisInstall 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.
When the PM types /user-research-synthesis, transform raw user interview notes, transcripts, and observations into actionable product insights.
Automatic Context Checks: When this skill is invoked, immediately check:
| Source | Files/Folders | Search Terms | What to Extract |
|--------|---------------|--------------|-----------------|
| Existing Research | context-library/research/*.md | topic from chat, user segments | Previous findings to avoid duplication |
| Related PRDs | context-library/prds/*.md | problem related to interviews | Problem framing and hypothesis |
| Strategy Context | context-library/strategy/*.md | user segment, strategic fit | How findings ladder to strategy |
| Previous Synthesis | outputs/research-synthesis/ | topic name | Past research to build on |
| Interview Guides | context-library/research/interview-guides/ | topic | What questions were asked |
Context Priority:
Cross-Skill Links:
/prd-draft to turn insights into feature spec/competitor-analysis/retention-analysis for churn patterns/write-prod-strategyBefore we synthesize, let me understand what you've learned...
Checking:
context-library/research/ for previous findings on this topiccontext-library/prds/ for the problem statementBased on what I find, I'll show you:
Topic:
Sample:
Context from Previous Research:
This is a 4-step process:
When the PM types /user-research-synthesis, start with:
Let's turn your user research into actionable insights.
**What data do you have?**
Upload or paste any combination of:
- Interview transcripts (from Grain, Otter.ai, or manual notes)
- Usability test recordings or notes
- Customer support tickets
- Sales call summaries
- Survey responses (open-ended)
- Slack messages from customer channels
You can upload multiple files or just paste everything into this chat.
**How many interviews/data points?**
[Let me know so I can gauge the scope]
**What were you trying to learn?**
(e.g., "Why users churn after the first week" or "Pain points in the onboarding flow")
As you upload, I'll automatically start flagging:
Once I have your data, I'll say:
Great, I've reviewed [X] interviews/data points.
I'm going to extract individual observations - each one gets its own "sticky note."
This will take a few minutes. I'll create:
- User quotes (in their exact words)
- Observed behaviors (what they actually did)
- Pain points (explicit problems they mentioned)
- Workarounds (clever hacks they've built)
- Context (their role, goals, environment)
Processing now...
I'll create a structured list like this:
## Observation #1
**Type:** Pain Point
**User:** Marcus (PM, Spotify)
**Quote:** "I have 47 voice memos on my phone that are just 'remember to follow up with design about X.' I never convert them."
**Context:** Uses multiple task managers, frustrated with manual entry
**Emotion:** Frustration (high)
## Observation #2
**Type:** Behavior
**User:** Priya (PM, Notion)
**Quote:** "Half my tasks come from casual hallway conversations."
**Behavior:** Captures ideas verbally but loses them before writing down
**Context:** Fast-paced startup environment
[... continues for all observations]
As I extract, I'll flag:
After extraction, I'll say:
I've extracted [X] observations from your data.
Now I'm going to group these into themes using affinity mapping.
I'll look for:
- Patterns that appear across multiple users
- Contradictions (where users disagree)
- Underlying needs beneath surface-level requests
- Jobs-to-be-done that aren't being solved
Clustering now...
I'll create theme clusters like this:
## Theme 1: "Task Capture Friction"
**Frequency:** 6 out of 8 users mentioned this
**Severity:** High (blocks daily workflow)
**Key Observations:**
- [Observation #1: Marcus voice memos]
- [Observation #2: Priya hallway conversations]
- [Observation #5: Jake loses tasks from Slack]
- [Observation #12: Sarah Excel spreadsheet workaround]
**Pattern:**
Users capture tasks in the moment (voice, text, conversation) but face friction converting them into their task manager. The "structuring" step is the bottleneck.
**Direct Quotes:**
- "I never convert them." - Marcus
- "Then 3 days later I'm like... wait, what API thing?" - Priya
**Jobs-to-be-done:**
When I have a spontaneous task idea, I want to capture it instantly without thinking about structure, so that I don't lose track of commitments.
---
## Theme 2: "Context Loss Between Tools"
**Frequency:** 5 out of 8 users
**Severity:** Medium
[... continues for each theme]
When users disagree, I'll explicitly call it out:
## 🔴 Contradiction Detected: "Manual Control vs Automation"
**User Group A (3 users):** Want AI to automatically assign tasks
- "Just figure out who it should go to" - Jake
- "I don't want to think about it" - Maria
**User Group B (5 users):** Want full manual control
- "AI might get this wrong" - Priya
- "I need to decide priority myself" - Marcus
**Recommendation:**
Default to manual with an "AI suggestion" that users can accept/reject. This preserves control while reducing friction.
After clustering, I'll create your final output:
I've identified [X] major themes from your research.
Now I'll translate these into actionable recommendations with:
- What to build (prioritized)
- What NOT to build (non-goals)
- Open questions (what you still need to learn)
- Success metrics (how to measure if you solved the problem)
Generating recommendations...
# User Research Synthesis: [Topic]
**Date:** [Today's date]
**Interviews:** [X participants]
**Synthesized by:** [PM name]
---
## Executive Summary
**Top 3 Insights:**
1. [Insight with impact]
2. [Insight with impact]
3. [Insight with impact]
**Recommended Actions:**
1. [Build this first]
2. [Explore this next]
3. [Deprioritize this]
---
## Theme 1: [Theme Name]
**User Impact:** [% of users affected]
**Severity:** [High/Medium/Low]
**Current Workaround:** [How users solve this today]
### The Problem
[Describe the core issue in user language]
### Supporting Evidence
- **Direct Quote:** "[Exact user words]" - [User name]
- **Observed Behavior:** [What you saw them do]
- **Frequency:** [X out of Y users mentioned this]
### Recommended Solution
**Build:** [Specific feature/change]
**Why this solution:**
- Addresses the root cause: [explain]
- Fits into existing workflow: [explain]
- Validated by user behavior: [explain]
**What NOT to build:**
- [Alternative you considered but rejected]
- [Why it won't work]
**Success Metrics:**
- Primary: [How you'll measure success]
- Guardrail: [Metric that can't get worse]
**Open Questions:**
- [ ] [What you still need to validate] - @[who to ask]
- [ ] [Edge case to test]
---
[Repeat for each theme]
---
## Themes We're NOT Addressing (And Why)
### Theme X: [Lower priority theme]
**Why we're not prioritizing:**
- Only 2 out of 8 users mentioned it
- Workarounds exist and aren't too painful
- Doesn't align with our Q2 strategy
---
## Contradictions & Open Questions
[List any conflicts in the data]
[List assumptions that need more validation]
---
## Appendix: Raw Observations
[All extracted observations for reference]
As I analyze, I'll flag any data that might be unreliable:
❌ Future predictions: "I would definitely use this" ❌ Hypotheticals: "If you built X, I would Y" ❌ Compliments: "This is great!" (without specifics) ❌ Feature requests: "You should add Z" (without context)
✅ Past behaviors: "Last time I tried to do X, I had to Y" ✅ Specific stories: "Here's exactly what happened..." ✅ Observed patterns: "Every single time I do this..." ✅ Workarounds: "Here's my hack for this problem"
From Aakash Gupta's Customer Interview Framework:
1. The Time Machine Question
2. The Money Question
3. The Workaround Deep-Dive
4. The Switching Cost Question
5. The Budget Authority Question
6. The Failure Story
7. The Champion Question
8. The Recent Purchase Question
When users give surface-level answers, dig deeper:
User: "I want better search"
You: "Why do you need better search?"
User: "I can't find my old tasks"
You: "Why do you need to find old tasks?"
User: "Because I reference them for new projects"
You: "Why do you reference old tasks?"
User: "Because I repeat similar patterns"
You: "Why don't you have templates?"
User: "I DO have templates, but they're scattered across 3 tools"
→ Real problem: Template organization, not search
Apply this during synthesis - I'll automatically run "5 Whys" on pain points to find root causes.
Who you DIDN'T talk to matters as much as who you did.
After interviews, I'll create a "Missing Voices" section:
## 🚨 Missing Segments (Research Gaps)
**Who we talked to:**
- 8 enterprise PMs (large companies, >1000 employees)
- All technical backgrounds
- All English-speaking, US-based
**Who we DIDN'T talk to:**
- Small company PMs (<100 employees)
- Non-technical PMs (marketing, ops)
- International users (Asia, Europe, LatAm)
- Free tier users (only talked to paid)
**Risks:**
- Our insights may not apply to SMB market
- May miss non-technical user pain points
- International workflows might differ significantly
- Free users might have different needs
**Recommendation:**
- Next round: 5 interviews with SMB PMs
- Test prototypes with non-technical users
- Consider international user research
This prevents building for a narrow segment while claiming broad applicability.
For each theme, I'll assess emotional intensity:
This helps prioritize which problems to solve first.
For each theme, I'll translate into JTBD format:
When [situation],
I want to [motivation],
So I can [outcome].
Example:
Not all user feedback is equally valuable. I'll help you:
Users are great at describing problems, terrible at designing solutions.
When I see a feature request, I'll dig into:
If you went into interviews with a hypothesis, I'll flag:
Remember: the users who agreed to be interviewed are not representative of all users.
I'll remind you:
Research synthesis:
outputs/research-synthesis/[topic]-[date].mdcontext-library/research/[topic]-synthesis.md for future referenceAfter synthesis:
/prd-draft to turn top themes into feature spec/write-prod-strategy/competitor-analysisFeeds into:
/prd-draft - Auto-populate Hypothesis with user quotes and insights/write-prod-strategy - Themes inform strategic pillars/status-update - Key research findings go in stakeholder updates/competitor-analysis - If competitors mentioned, extract those mentionsPulls from:
context-library/research/ - What questions were asked?context-library/prds/ - What was the original problem hypothesis?/interview-guide - Questions asked in the interviewcontext-library/meetings/ - Past conversations about this problemAfter synthesis, I'll offer:
Your research synthesis is complete!
**Next steps:**
1. **Create a PRD** - Use `/prd-draft` to turn these insights into a spec
2. **Update roadmap** - Which themes should we prioritize this quarter?
3. **Share with stakeholders** - I can help draft a summary for leadership
4. **Plan follow-up research** - What open questions need validation?
What would you like to do first?
When you use /prd-draft after synthesis, I'll automatically:
Do this within 24 hours of your last interview while insights are fresh.
Share the raw observations with designers and engineers. Let them help cluster themes. They'll spot patterns you might miss.
Don't stop at surface-level problems. Keep asking "Why?" until you get to the root cause.
Bad: "Users want a faster app" Good: "Users abandon tasks mid-flow because load times break their mental model of the workflow"
Use exact quotes. Don't paraphrase into "product-speak." User language is powerful for presentations.
The most valuable insights are often the ones that contradicted your assumptions.
When synthesis is complete, I'll create:
All files will be saved to:
outputs/research-synthesis/[topic]-[date].mdcontext-library/personal-context-pm-background.md (updated)After synthesis, I might recommend additional research if:
Rule of thumb: After 5-8 interviews with the right users, you should have 3-5 clear themes with strong supporting evidence. If not, talk to more people.
Remember: User research isn't about validation. It's about discovery. The goal isn't to hear what you want; it's to learn what you need to know.
Before presenting output to the PM, verify:
outputs/research-synthesis/[topic]-[date].mdcontext-library/research/ for past findings, context-library/prds/ for related problem statements, and context-library/strategy/ for strategic fit/prd-draft suggested: If actionable findings exist that could become features, the output explicitly suggests running /prd-draft as a next stepdevelopment
Product strategy docs using 7-component framework
tools
Review week's progress, meetings, learnings
tools
Set next week's priorities
business
Systematically process user interviews to extract actionable insights. Batch processes interviews and generates research reports.