user-interview-synthesis
Skill1 starsChanged 35 days agoMITView on GitHub
Synthesize customer interview notes or transcripts into evidence-backed themes, verbatim quotes, jobs-to-be-done, and opportunities in customer voice, ready to feed an Opportunity Solution Tree. Works on a single interview (snapshot) or many (cross-interview synthesis), separates what customers did from what they said they want, and counts evidence honestly. Use when the user shares interview notes, call transcripts, customer call recordings' text, discovery notes, sales call notes, user research, usability test notes, "what did customers say", "synthesize these interviews", "find patterns", "affinity map", or "interview snapshot".
3 other projects use a version of this.
Adopted by
Most recently taken up by
- Bellistri-Nick/pm-skillstheir own version, first seen Nov 15, 2026
- designedbythanh/ai-skills-library-product-designtheir own version, first seen Oct 1, 2026
- megandmartin/agent-skills-repotheir own version, first seen Jul 24, 2026
Other versions3 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 3
- megandmartin/agent-skills-repo★ 3same name
- designedbythanh/ai-skills-library-product-design★ 2same name
- Bellistri-Nick/pm-skills★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository3 other files it gives its agents.
- opportunity-solution-treeSkill
- stakeholder-updateSkill
- unslopSkill
The file
We split this skill into the rules it gives an agent
11 rules. 0 are common, 10 are distinctive, and 1 is very specific to this project.
0
Common
Most of the 3 edited versions we read keep these.
10
Distinctive
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 14
Count honestly: Every theme shows how many interviews support it (n/N).
- Very specific: line 27
If the research question is missing, ask for it once.
- Distinctive: line 64
Keep it to one screen. Every opportunity must point at a quote or a described behavior.
- Distinctive: line 83
Do this extraction internally or show it in a collapsible appendix if the user wants it.
- Distinctive: line 101
If the research is exploratory, add a JTBD line per key segment:
- Distinctive: line 105
Only write jobs supported by stories in the data.
- Distinctive: line 143
Leading questions: If transcripts include interviewer questions, flag answers that were prompted ("Would it be helpful if...?" → "Yes") and …
- Distinctive: line 150
Never fabricate quotes, participants, counts or details.
- Distinctive: line 152
Keep the customer's language in opportunities.
- Distinctive: line 153
Don't recommend solutions unless asked.
- Distinctive: line 157
If the user says "quick", "top takeaways", or "TL;DR": return the 3 strongest themes with evidence counts and one quote each, plus the …
“Common” is measured: kept by at least 6 in 10 of the 3 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
User Interview Synthesis
Synthesis turns raw conversations into a small number of well-evidenced insights a team can act on. The failure modes are well known: cherry-picked quotes that confirm what the PM already believed, feature requests mistaken for needs, themes backed by one loud customer, and summaries so generic they could describe any product. This skill is built to avoid them.
Principles
- Behavior over opinion. What a customer did last week outweighs what they say they would do. Stories about specific past events are the strongest evidence.
- Needs over requests. A feature request is a clue to a need. Record the request, then dig for the underlying need.
- Count honestly. Every theme shows how many interviews support it (n/N). One vivid quote is an anecdote, not a pattern.
- Verbatim means verbatim. Quotes are copied exactly from the input. Never paraphrase inside quote marks, never stitch fragments together, never invent.
- Separate observation from interpretation. Label which is which.
- Look for disconfirming evidence. Actively report what contradicts the leading theme and what surprised you.
Step 0: Inputs
Check for:
- The notes or transcripts (one or many)
- The research question or decision this research supports
- Participant context (role, company size, segment, customer vs prospect, plan tier)
- The current outcome or OST, if one exists
If the research question is missing, ask for it once. If the user says "just synthesize", infer one from the notes, state it at the top as [assumed research question], and proceed.
Notes quality check: if notes are mostly the interviewer's summaries rather than the customer's words, say so. Themes from summary-only notes get lower confidence.
Mode A: Interview snapshot (one interview)
Produce a one-page snapshot (Torres-style):
INTERVIEW SNAPSHOT: [participant id / role, company type, segment] | [date]
Memorable quote: "[verbatim]"
Quick facts
- Role, context, tools they use today, how often they do the job
The story (what actually happened, in sequence)
1. [trigger]
2. [what they did]
3. [where it broke / what was hard]
4. [workaround]
5. [outcome]
Opportunities (customer voice)
- "[need / pain / desire]" [evidence: quote or behavior]
- ...
Insights and surprises
- [anything that challenges current assumptions]
Feature requests mentioned (with underlying need if discovered)
- Request: ... → Need: ... / Need unknown
Follow-ups
- [questions to ask next time, people to talk to, data to check]Keep it to one screen. Every opportunity must point at a quote or a described behavior.
Mode B: Cross-interview synthesis (many interviews)
1. Extract atomic observations
Go interview by interview. Pull one observation per line, each tagged:
[P#] [type] observation (quote if available)
Types:
- [did] past behavior or story
- [pain] friction, frustration, cost, risk
- [workaround] hacks, spreadsheets, manual steps, other tools (strong signal of an unmet need)
- [goal] what they're ultimately trying to achieve
- [request] explicit feature ask
- [context] constraints, environment, who else is involved
- [said] opinion, prediction, hypothetical ("I would use...")
Do this extraction internally or show it in a collapsible appendix if the user wants it. Don't skip it: it's what keeps themes honest.
2. Cluster into themes
Group observations into themes by underlying need, not by feature area or by interview question. Then for each theme:
- Name it as an insight, a full sentence that says something non-obvious. "Onboarding" is a topic. "Admins can't start until IT approves the integration, so the first week is wasted waiting" is an insight.
- Evidence count: n/N participants. Note segments if the pattern is concentrated ("4/5 enterprise, 0/4 SMB").
- Strength: behavior-backed (did / workaround) vs opinion-backed (said / request). A theme backed only by [said] and [request] is weak, say so.
- Best 1 to 3 quotes, verbatim, attributed to participant id.
- Counter-evidence: participants who said or did the opposite.
3. Translate to opportunities
For each theme, write opportunities in customer voice (something a customer could say about their own experience, not a solution). Apply the solution-in-disguise test: if it names something we'd build, ask "why would they want that?" and rewrite.
4. Jobs to be done (when useful)
If the research is exploratory, add a JTBD line per key segment:
When [situation], I want to [motivation], so I can [expected outcome].
Only write jobs supported by stories in the data.
Output (Mode B)
SYNTHESIS: [research question] | N = [#] interviews | [segments] | [date range]
TL;DR (3 bullets max: the most important insights for the decision at hand)
Themes (ordered by strength of evidence, not by how interesting they are)
1. [Insight sentence]
Evidence: n/N [segments] | Strength: behavior / mixed / opinion-only
"[verbatim quote]" (P3)
"[verbatim quote]" (P7)
Counter-evidence: [P5 did/said ...] or none found
Opportunities: "[customer voice]", "[customer voice]"
2. ...
Feature requests (table)
| Request | # | Underlying need (if known) | Maps to theme |
Surprises / things that challenge our assumptions
What we still don't know (and suggested next interviews or data pulls)
Opportunities for the OST (flat list, customer voice, with evidence tag [interviews n/N])The final opportunity list is formatted to drop straight into the opportunity-solution-tree skill.
Bias checks (always run before final output)
- Confirmation: Did the themes mostly confirm what the user expected (from their framing of the request)? If so, look again for disconfirming evidence and report it.
- Loudest voice: Is any theme driven mostly by one participant? Mark it as an anecdote.
- Recency / vividness: Is a theme ranked high because of a great quote rather than evidence count?
- Sample skew: Are segments, roles or customer types missing that matter for the decision? Name them.
- Leading questions: If transcripts include interviewer questions, flag answers that were prompted ("Would it be helpful if...?" → "Yes") and down-weight them.
- Small N honesty: With fewer than 5 interviews, frame themes as hypotheses to validate, not findings.
Report the most important bias issue in a short Caveats line at the end.
Rules
- Never fabricate quotes, participants, counts or details. If a quote isn't in the input, it doesn't exist.
- Anonymize by default (P1, P2...) unless the user wants names. Remove personal data that isn't needed (emails, phone numbers).
- Keep the customer's language in opportunities; it's often better than ours.
- Don't recommend solutions unless asked. Synthesis feeds discovery; jumping to solutions here biases the next step.
Quick-pass mode
If the user says "quick", "top takeaways", or "TL;DR": return the 3 strongest themes with evidence counts and one quote each, plus the single biggest caveat.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

