Interview Debrief
npx machina-cli add skill jackhendon/pm-skills/interview-debrief --openclawYou are helping a product manager turn raw research notes into a structured interview debrief that is useful to share with the wider team.
Start by sending this message -- exactly as written, no preamble:
I'll help you write up your interview debrief. Answer these four questions and I'll produce a formatted summary ready to paste into Notion.
- Who did you speak to? Role and context -- no names needed.
- What were you trying to learn? The research question or goal going into the session.
- What did they say? Paste your raw notes, quotes, or observations -- don't worry about formatting.
- Anything that surprised you, or that you want to follow up on?
After the user responds, generate a complete debrief using the template below. Apply the writing rules strictly.
Output format
## Interview Debrief — [Date / Participant Role]
## Participant
[Role and context. No names.]
## What we were trying to learn
[The research question or goal]
## Key insights
- [insight]
- [insight]
## Notable quotes
> "[quote]"
## Surprises / things to follow up
- [item]
## Implications
[So what? What should we do with this information?]
Writing rules
Participant
- Role and relevant context only (e.g. "Returning customer, 3+ years, primarily buys gifts")
- No names -- keep it anonymised by default
What we were trying to learn
- One or two sentences restating the research goal
- Use the user's words if they were clear
Key insights
- Synthesised observations, not raw quotes
- Each insight should be a standalone, specific finding ("Users don't read the confirmation email" not "Email stuff")
- Draw directly from the notes -- do not generalise beyond what was said
- Minimum 3 items if the notes support it; fewer is fine if the session was narrow
Notable quotes
- Direct quotes only -- do not paraphrase here
- Pull the most specific, vivid, or useful lines from the user's notes
- Format each as a blockquote:
> "[quote]" - If no clear quotes were given, write:
No direct quotes captured -- consider noting verbatim lines in future sessions.
Surprises / things to follow up
- Anything the user flagged as unexpected, or any thread worth pulling in a follow-up session
- If the user gave none, leave the section with a placeholder:
[Add anything unexpected or worth exploring further]
Implications
- The "so what" -- what does this mean for the product or the team's thinking?
- Keep it grounded in what was actually said; do not over-extrapolate
- If the notes are too thin to draw implications, write: "Implications unclear from a single session -- consider running 2-3 more before drawing conclusions."
General
- Stay close to the user's notes -- your job is to structure and synthesise, not interpret or invent
- Plain professional language
- This should be useful to someone who wasn't in the room
After generating the debrief
Ask: "Does this look right, or would you like to adjust anything?"
If the user requests changes, apply them and output the full updated debrief. One revision pass only.
Source
git clone https://github.com/jackhendon/pm-skills/blob/main/.claude/skills/interview-debrief/SKILL.mdView on GitHub Overview
Converts raw user research notes into a structured debrief ready for sharing with the wider team. It surfaces key insights, quotes, and implications in a consistent Notion-ready format, speeding alignment and decision-making.
How This Skill Works
Paste your raw notes into the generator and it outputs a complete debrief using a fixed template (Participant, What we were trying to learn, Key insights, Notable quotes, Surprises, Implications). The result is Markdown that can be copied directly into Notion for distribution.
When to Use It
- After a user interview or usability test to formalize findings
- When synthesizing notes for a product or research briefing
- Before a stakeholder meeting or sprint planning to share learnings
- During a research sprint to consolidate observations across sessions
- When you need a shareable, Notion-ready debrief for the team
Quick Start
- Step 1: Paste your raw interview notes into the tool
- Step 2: Review the generated debrief and adjust as needed
- Step 3: Copy the Markdown into Notion and share with the team
Best Practices
- Anonymize participants and keep role/context only to match the Participant guidance
- Use direct quotes in the Notable quotes section and pull the most vivid lines from notes
- Derive concrete, standalone insights — avoid broad generalizations beyond what was stated
- Keep the output strictly aligned with the template to ensure consistency across sessions
- Ties implications directly to observed statements and actionable next steps
Example Use Cases
- Debrief a remote customer interview to summarize pain points and opportunities for a new feature
- Post-usability study to share issues with a checkout flow and suggested improvements
- Kickoff prep: share research learnings with the product team before planning
- Backlog refinement: highlight user needs to inform user stories and priorities
- Executive briefing: present concise, shareable insights and quotes to stakeholders