discover-interview-synthesis — Claude Code skill: interview synthesis
This skill turns interview notes and transcripts into themes, quotes, insights and recommendations. Useful after a round of user research when the team needs to see what you heard.
npx skills add product-on-purpose/pm-skills --skill discover-interview-synthesis -a claude-codeWhat discover-interview-synthesis does
The skill reads notes, transcripts and recordings, tags observations by topic and keeps the ones that show up across several participants. It collects quotes with participant IDs attached, turns themes into insight statements that explain why something matters rather than just what was said, and proposes recommendations with a confidence note. Limitations get their own section: what you did not learn, where the sample is biased.
Output follows the template in references/TEMPLATE.md — research overview, key themes, notable quotes, insights, recommendations and an appendix. A finished example sits in references/EXAMPLE.md. The skill asks for at least 3 participants to find meaningful patterns, and the description suggests a round of 5 or more.
When .claude/pm-skills.local.md exists, the skill reads phase and active_initiative from it and writes personas plus findings as an interpretation artifact that deliver-prd picks up later. It proposes the entry and waits for confirmation first; with memory_auto_append: true it appends on its own. The file is re-read right before writing, because a parallel session can overwrite your edits and there is no way to recover them.
What it helps with
- pull themes out of notes from several interviews
- pick quotes that show where users struggle
- write insights that give a reason, not a paraphrase
- rank recommendations by how strong the evidence is
- state research limitations and sample bias honestly
Example prompts for the agent
- Synthesize the interviews in
interviews/into themes, quotes and recommendations - Turn five customer calls into one findings report
- Run discover-interview-synthesis over the usability session transcripts
How to install discover-interview-synthesis
1Skills CLI (Vercel)
npx skills add product-on-purpose/pm-skills --skill discover-interview-synthesis -a claude-code2Manually: put the files in place
~/.claude/skills/discover-interview-synthesis/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/discover-interview-synthesis/
1Skills CLI (Vercel)
npx skills add product-on-purpose/pm-skills --skill discover-interview-synthesis -a codex2Manually: put the files in place
.agents/skills/discover-interview-synthesis/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add product-on-purpose/pm-skills --skill discover-interview-synthesis -a cursor2Manually: put the files in place
.cursor/skills/discover-interview-synthesis/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install product-on-purpose/pm-skills discover-interview-synthesis2Manually: put the files in place
.github/skills/discover-interview-synthesis/SKILL.md1Skills CLI (Vercel)
npx skills add product-on-purpose/pm-skills --skill discover-interview-synthesis -a gemini-cli2Platform CLI
gemini skills install https://github.com/product-on-purpose/pm-skills --path skills/discover-interview-synthesisManually: put the files in place
.devin/skills/discover-interview-synthesis/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add product-on-purpose/pm-skills --skill discover-interview-synthesis -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about discover-interview-synthesis
How do I install discover-interview-synthesis in Claude?
Run npx skills add product-on-purpose/pm-skills --skill discover-interview-synthesis -a claude-code. The skill lands at ~/.claude/skills/discover-interview-synthesis/SKILL.md.
What does discover-interview-synthesis do?
It turns raw interview data into a structured synthesis: participant profiles, recurring themes, quotes, insights and recommendations. It follows the template in references/TEMPLATE.md.
How is it different from foundation-meeting-recap?
foundation-meeting-recap summarizes one internal meeting for the people who attended it. This skill aggregates research conversations and looks for patterns across them.
Source text
SKILL.md · Apache-2.0
---
name: discover-interview-synthesis
description: Synthesizes user research interviews into actionable insights, patterns, and recommendations. Use after conducting user interviews, customer calls, or usability sessions to extract and communicate findings across participants. Distinct from foundation-meeting-recap, which summarizes one internal meeting for its attendees; this skill aggregates research conversations into evidence-backed findings.
license: Apache-2.0
metadata:
phase: discover
version: "2.3.0"
updated: 2026-07-05
category: research
frameworks: [triple-diamond, lean-startup, design-thinking]
author: product-on-purpose
---
<!-- PM-Skills | https://github.com/product-on-purpose/pm-skills | Apache 2.0 -->
# Interview Synthesis
An interview synthesis transforms raw user research data into structured insights that drive product decisions. Rather than simply listing what participants said, a good synthesis identifies patterns across conversations, connects observations to underlying user needs, and translates findings into actionable recommendations.
## When to Use
- After completing a round of user interviews (typically 5+ participants)
- Following customer discovery calls or sales feedback sessions
- After usability testing sessions to consolidate observations
- When stakeholders need a summary of research findings
- Before ideation sessions to ground the team in user reality
## When NOT to Use
- You are summarizing one internal meeting for its attendees -> use `foundation-meeting-recap`
- You need patterns across multiple meetings over time -> use `foundation-meeting-synthesize`
- Your data is survey responses rather than interviews -> use `measure-survey-analysis`
- The findings are synthesized and you are ready to frame the problem -> use `define-problem-statement`
- You have synthesized findings and want to map them onto a customer's journey across stages and touchpoints -> use `discover-journey-map`
## Instructions
When asked to synthesize interview findings, follow these steps:
1. **Gather the Raw Material**
Collect all interview notes, transcripts, or recordings. Ensure you have data from at least 3 participants to identify meaningful patterns. Note the research objective and methodology used.
2. **Create Participant Profiles**
Document each participant with relevant context: their role, segment, tenure, and any notable characteristics. This helps readers assess the representativeness of findings.
3. **Identify Recurring Themes**
Read through all notes and tag observations by topic. Look for themes that appear across multiple participants (ideally 3+). Distinguish between frequently mentioned topics and one-off comments.
4. **Extract Meaningful Quotes**
Capture 3-5 verbatim quotes per theme that powerfully illustrate the insight. Good quotes are specific, emotional, or particularly articulate. Always attribute quotes to participant IDs.
5. **Synthesize into Insights**
Transform themes into insight statements. An insight goes beyond observation ("users mentioned X") to interpretation ("users need Y because of Z"). Connect what you heard to why it matters.
6. **Formulate Recommendations**
Based on the insights, propose prioritized actions. Each recommendation should tie directly to an insight. Note confidence level based on strength of evidence.
7. **Document Limitations**
Acknowledge what you didn't learn, sample biases, or areas needing further research. Honest limitations increase credibility.
## Project Memory Contract
Active only when `.claude/pm-skills.local.md` exists. With no file, ignore this section entirely
and behave exactly as described above.
- **Reads:** `phase` and `active_initiative`, so findings are framed against the initiative in flight instead of asking you to restate it.
- **Writes:** the personas and findings as an `interpretation` artifact, so a later skill can consume them without you pasting them again.
- **Posture:** propose the entry and wait for confirmation before writing, unless
`memory_auto_append: true` is set, in which case append and echo what was written.
- **Write discipline:** re-read the file immediately before writing, never from the copy that
produced the proposal. If it changed in between, merge your entry into the current state and
re-propose rather than overwriting; add only your own entry and leave every other field and
section byte-identical. Nothing enforces this at runtime and the file is gitignored, so a
careless whole-file write loses another session's work with no way to recover it.
This is the writer half of the loop the cohort exists to demonstrate: what this skill records, `deliver-prd` later reads.
## Output Format
Use the template in `references/TEMPLATE.md` to structure the output. A complete synthesis fills every template section: Research Overview; Key Themes; Notable Quotes; Insights; Recommendations; and Appendix.
## Quality Checklist
Before finalizing, verify:
- [ ] Themes are supported by evidence from 3+ participants
- [ ] Quotes are verbatim and attributed to participant IDs
- [ ] Insights explain "why" not just "what"
- [ ] Recommendations are specific and actionable
- [ ] Participant identities are protected (no PII)
- [ ] Limitations and biases are acknowledged
## Examples
See `references/EXAMPLE.md` for a completed example.
© product-on-purpose · Apache-2.0 · product-on-purpose/pm-skills