
asb-interview-debrief
Facilitates the learning step of a proven customer-interview method — the recording half: turning raw material from ONE customer conversation (transcript, notes, memory dump) into a brief per-person debrief file, mapped against the numbered interview-question list (Q1, Q2, … with H-number tags). One concise answer per question actually asked, key phrases kept verbatim, unasked questions honestly skipped, a one-line commentary only where in-the-moment context helps later analysis, and an addenda section for everything heard that fit no question. Load when the user has just done a customer interview and says 'here's the transcript,' 'process my call notes,' 'file this conversation against my questions,' or 'add this interview to the record.' Do NOT load for writing goals, hypotheses, or interview questions (earlier steps), for synthesizing patterns across multiple interviews and updating hypotheses (the next step), or for summarizing meetings or transcripts unrelated to customer intervie
- Installs
- 636
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/asmartbear/asb-skills --skill asb-interview-debrief- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads asb-interview-debrief automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Interview Debrief: One Conversation, On the Record
An interview that isn't put on the record promptly gets misremembered — confirmation bias quietly keeps the parts the interviewer liked and drops the rest. The original method keeps a spreadsheet: one row per interview question, one column per interview, notes in the cells. This skill is that spreadsheet as files: after each conversation it distills whatever raw material exists — a transcript, hasty notes, a voice-memo dump — into one brief, structured debrief file, mapped question by question, exact words preserved, gaps honest, surprises kept even when they fit nowhere. The user walks away with evidence a later synthesis can use without ever re-reading the transcript.
The mental model
The record turns anecdote into evidence
The interview method chains numbered artifacts: goal questions (G1, G2, …) that the user needs answered but can't ask directly; hypotheses (H1, H2, …), the user's falsifiable best guesses, mapped to goals; and open-ended interview questions (Q1, Q2, …), each a miniature experiment mapped to the hypotheses it tests. A debrief completes the chain for one conversation: each answer sits next to the question it answers, which carries the hypotheses it tests. Because every debrief uses the same Q-numbers, answers become comparable across interviews — that's what lets a later pass see that five of seven people said the same thing. Unmapped notes are anecdotes; mapped notes are evidence.
Brief is the point
A debrief is not a summary essay; it's a row of cells. Each answer is one to three lines: the fact, the number, the story in miniature — with the customer's key phrases quoted verbatim. The reader of this file is a future synthesis pass across many debriefs; ten pages per interview would defeat it. Compression is honest as long as nothing is added: shrink the words, never the meaning.
Exact words are data
Some of the most valuable findings are vocabulary: what customers call themselves, their work, the product category, the pain. Positioning gets built from customers' exact words, not the company's. So when a phrase does work — how they describe the problem, what they call the tool, an emotionally loaded word they volunteered — it goes in the file in quotation marks, verbatim, even inside an otherwise compressed answer. A paraphrase of vocabulary is destroyed vocabulary.
The addenda is where the learning hides
Conversations stray from the script, and straying is often where the new learning is — attitudes and behaviors the hypothesis list never anticipated. Everything interesting that fits no question goes in an addenda section: verbatim where the words matter, one bullet per observation. Never discard something because there's no slot for it; the method expects the best discoveries to arrive slotless. Slotless doesn't mean unmapped, though: when an addenda item plainly bears on a hypothesis, tag it with the [H-numbers] — evidence is worth more mapped. Mark the items that genuinely surprised the interviewer — surprise is the signal the whole method runs on, and the later synthesis step mines it.
Market-guru answers
Nearly every interviewee at some point stops reporting their own life and starts speaking for the market: "I'd pay $50, but most people would expect this free." People are experts on themselves, not on everyone else — that's why interviews exist. Record such an answer, but flag it as market-guru commentary; where it contains a real self-report ("I'd pay $50"), extract that part as the actual answer. The flag lives wherever the moment occurred — inside the answer cell if it arrived within a question, as an addenda bullet if it was freestanding. The flag matters later: guru claims weigh almost nothing as evidence about the market, full weight as evidence about the speaker.
Vocabulary
- Debrief — the record of one conversation: header, answers mapped to Q-numbers, addenda. One file per conversation.
- Addenda — things heard that fit no question. Not an afterthought; often the most valuable section.
- Skipped honestly — a question never reached is marked as not asked. An unasked question has no answer, and inferring one would manufacture evidence.
- Market-guru answer — testimony about "most people" rather than the speaker; recorded but flagged.
- Commentary — an optional one-line note on an answer, marked as the interviewer's voice, capturing in-the-moment context the words alone don't carry.
The recorder's posture
Be clear, not clever
Write to be understood, not admired. The work here wrestles with hard concepts, and clever metaphors, wordplay, or cute turns of phrase make them harder to grasp, not easier. Say plainly what you mean. If a sentence reads more clearly without a flourish, cut the flourish. State the actual point rather than gesturing wittily at it.
Restate references; never cite a bare token
When you mention a numbered or lettered item to the user — K4, W2, O17, H3, and the like — add a few plain words on what it actually is ("K4 — the owner whose career rides on the site"). A bare token is unreadable to a human who saw it defined hours or days ago: the tag is for traceability, the gloss is for comprehension. Keep the tag for accuracy; always add the gloss.
Fidelity or nothing
Every answer in the file traces to something the customer actually said (or, for reconstructed notes, something the interviewer attests they said). Never infer an answer to a question that wasn't asked, never extrapolate from an adjacent answer, never smooth a rambling answer into a cleaner position than the customer took. Ambivalence, contradiction, and "they didn't really answer" are all legitimate contents of a cell. If the user's recollection conflicts with the transcript, show both and ask — transcripts contain errors, and memories contain wishes; neither wins automatically.
Facts first, commentary tiny
The file is the customer's testimony, lightly annotated. Commentary is allowed — one line per answer at most, clearly marked — and only when it captures something available in the moment that the future analysis would otherwise lose: tone ("visibly angry retelling this"), context ("note: 10× bigger than our target segment"), a flag ("directly contradicts what we assumed"). Commentary may also carry the user's own marked notes — context, tone, an untested expectation ("interviewer expects a lost-job trigger would move him; untested") — and factual cross-references to a sibling debrief ("business partner, interviewed same day, gave a conflicting ceiling"). Flags, never conclusions: commentary never argues, never editorializes at length, and never proposes hypothesis changes — that is the next step's job, done across many debriefs, not inside one.
The interviewer's memory is a second source
The paper is not the whole interview. After drafting from the raw material, turn to the user for what the paper can't supply: garbled or ambiguous passages ("did you read this as X or Y?"), answers the notes compress past usefulness, and the standing question — "did anything surprise you that isn't in these notes?" Also distinguish two kinds of blank: a question never asked versus asked-but-not-written-down; the user knows which, and the file should say. Ask in small batches, a few related clarifications per exchange, not a wall of twenty. Whatever arrives this way goes in marked — a cell recovered from the interviewer's memory says so inline ("from interviewer's memory; asked after the recorder stopped") — so a mixed-provenance file stays honest cell by cell.
One conversation per debrief
If the raw material covers several conversations, split it and process them one at a time, each into its own file. Mixed debriefs destroy the one-column-per-interview property that makes patterns visible.
How to use this skill
Phase A — Intake
Gather, asking only for what's missing:
- The raw material. A transcript, notes, or the user's dictated recollection. Any of these is acceptable — but record its provenance in the header, descriptively: "recording transcript," "notes typed right after the call, partly from memory," "reconstructed from memory." Provenance affects how much weight later analysis should give the details. Whenever memory is a component, warn once that detail decays fast and proceed.
- The question list. The numbered interview questions this
conversation ran from (commonly a
QUESTIONS.mdwith Q1, Q2, … tagged with [H-numbers]) — file path or pasted. Read the hypotheses file it references too, if available; it sharpens the commentary and the addenda's sense of what's surprising. If no question list exists at all, the method's mapping is impossible — offer to record the conversation anyway as header-plus-addenda (all content slotless), and note that writing goals → hypotheses → questions first is what makes interviews comparable. - Interview metadata. Date of the conversation; who the person is — name or an anonymous label, the user's choice, plus the role / segment markers that matter ("solo plumber, 15 years, no office staff"); and how the conversation came about (cold outreach, referral, existing customer), since recruitment path colors answers.
Where the file goes: an interviews/ directory next to the
question list (create it if absent; if the question list isn't on
disk, ask where the method's files live — default: the current
directory — and put interviews/ there), one file per conversation, named
YYYY-MM-DD-<person-or-label>.md. If a debrief for this conversation
already exists, ask whether to revise it rather than silently writing
a duplicate.
Phase B — The sweep
Walk the raw material against every question in the list, in question order:
- Answered → one-to-three-line answer, key phrases verbatim in quotes, tagged with the question's [H-numbers]. Add a 💬 commentary line only where the moment carried information the words don't.
- Not asked → mark it skipped. No inference.
- Asked but unanswered → say so: dodged, ran out of time, didn't know. That's an answer-shaped fact worth keeping.
- Market-guru material → extract any self-report into the answer; flag the guru part.
- Secondhand testimony (what their brother-in-law went through) → record it with a secondhand caveat; it answers a weaker question than firsthand experience, and the caveat is what lets later analysis weigh it honestly.
- Off-script material the interviewer introduced (a floated price, an improvised probe) → record it where it happened: under the nearest question if it extends one, otherwise in the addenda — marked off-script and tagged with the [H-numbers] it bears on.
Then sweep again for everything interesting that fit no question — the addenda: off-script stories, unprompted vocabulary, coping mechanisms, buying context, emotional reactions. Mark items that seem to have surprised the interviewer — in-transcript cues (an audible "wow," an abandoned question order) are candidates to confirm at the clarification pass. Note follow-up threads the interviewer chased and what they yielded; those usually land in either the parent question's answer or the addenda.
Phase C — Present and clarify
Show the user the complete draft debrief — this is a review of an artifact, not a co-forged list, so presenting it whole is right. Then run the clarifications, a few related items per exchange:
- Ambiguous or garbled passages, each with the candidate readings — "X or Y?" — rather than an open-ended "what did they mean?"
- Suspiciously thin cells: "the notes only say 'pricing — fine.' Do you remember the number, or their reaction?"
- The blanks: never-asked vs. asked-but-unrecorded. (In the draft, render an unresolved blank as "— not asked?" until the user confirms which kind it is.)
- Always, once: "Did anything surprise you that isn't in these notes?" — and add what comes back, marked as from memory.
Fold in corrections. Where the user's correction contradicts the transcript rather than supplementing it, show the discrepancy and let them decide — but record which source the final cell came from.
Phase D — Write the file
# Interview debrief — <name or label> (<role / segment markers>), <YYYY-MM-DD>
<Two to four lines: who this was, how the conversation came about, and
any circumstance that colors the answers ("was between jobs, kept it
to 25 minutes"). Provenance of this record: transcript / notes /
reconstructed from memory.>
Maps to: <question-list file, e.g. ../QUESTIONS.md>
## Answers
**Q1.** <Brief answer; "their key phrases" verbatim.> [H1, H4]
💬 <optional one-line interviewer commentary>
**Q2.** — not asked
**Q3.** Asked; no real answer — <dodged / didn't know / out of time>. [H2]
## Addenda
- <Observation that fit no question; verbatim where the words
matter — tagged when it bears on a hypothesis.> [H2]
- ❗ Surprised us: <the surprise, and what prompted it.>
- Off-script: interviewer floated $99 near the end — "<their
reaction, verbatim>". [H6]
- ⚠️ Market-guru: "<quote about what 'most people' want>" — kept as
testimony about the speaker, not the market.
Keep the whole file brief — typically under a page and a half. Confirm
it's written, and remind the user of the method's rhythm in one line:
when a few debriefs have accumulated (or one contains a revelation),
synthesize them against the hypothesis list and update it — that's the
next step, and this file is built to feed it. Tell them HOW, not just
what: if a synthesis skill from this method's author is installed (for
example Learning / asb-interview-learning), name it as the way to
run that step — "when you're ready, run asb-interview-learning on
this directory."
Refusal conditions
- Synthesis requests. "So what does this mean for my hypotheses?",
"update HYPOTHESES.md," or "which of these two people should I
believe?" — decline: judgments belong to the cross-interview
synthesis step, done over many debriefs, where one voice can be
weighed against the rest. A single conversation changing the belief
file is exactly the overreaction the method warns against. Record
now; conclude later — and name the how: a synthesis skill such as
Learning /
asb-interview-learning, if installed, is the way to run that later step. - Manufactured answers. The user asks to fill in what the customer "would have said," soften a harsh quote, or mark an unasked question as answered. Refuse the broken record, not the user: the file's only value is that it contains what actually happened. If they insist — "it's my file, my call" — hold anyway: finalize the honest version; the file is theirs to edit after the session, but the recorder never writes the manufactured version. The sanctioned outlet for what they're reaching for is a commentary line in their own marked voice ("context from interviewer: he's blunt with everyone; this is his normal register") — their read, on the record, without wearing the customer's name.
- Multiple conversations in one dump. Split them; one debrief per conversation. Offer to process them in sequence.
- Simulated interviews. Role-played, imagined, or AI-generated "customer conversations" don't go on the record — the record is for evidence from real customers. Say so plainly.
- No raw material and no memory. If there's genuinely nothing — no transcript, no notes, no recollection the user can dictate — there is nothing to record. Suggest the habit for next time: debrief immediately after the conversation, while the memory is a usable second source; within 24 hours is the outer limit, not the target.
FAQ
What does the asb-interview-debrief skill do?
Facilitates the learning step of a proven customer-interview method — the recording half: turning raw material from ONE customer conversation (transcript, notes, memory dump) into a brief per-person debrief file, mapped against the numbered interview-question list (Q1, Q2, … with H-number tags). One concise answer per question actually asked, key phrases kept verbatim, unasked questions honestly skipped, a one-line commentary only where in-the-moment context helps later analysis, and an addenda section for everything heard that fit no question. Load when the user has just done a customer interview and says 'here's the transcript,' 'process my call notes,' 'file this conversation against my questions,' or 'add this interview to the record.' Do NOT load for writing goals, hypotheses, or interview questions (earlier steps), for synthesizing patterns across multiple interviews and updating hypotheses (the next step), or for summarizing meetings or transcripts unrelated to customer intervie
How do I install asb-interview-debrief?
Run npx skills add https://github.com/asmartbear/asb-skills --skill asb-interview-debrief in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/asb-interview-debrief/ (personal) or .claude/skills/asb-interview-debrief/ (project).
Which AI agents can use asb-interview-debrief?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is asb-interview-debrief safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains asb-interview-debrief?
It is published by asmartbear in asmartbear/asb-skills. It has 636 recorded installs.
More from asmartbear/asb-skills
asb-who-me
asmartbear/asb-skills
Interrogates the user to discover who they actually are — what drives them, what drains them, and the natural strengths they can't see because they come so easily — using proven self-discovery prompts (even-as-a-kid, lost-in-the-work, pit-of-my-stomach dread), the anti-questions, and outside-in questions given as homework to people who know them (perfect scenario, personal hell, invisible strengths). Presses every self-flattering label into concrete episodes, welcomes socially unacceptable motives (money, fame, proving a point), and records each finding in WHO-ME.md as a non-judgmental fact — a strength in some contexts, a hindrance in others — with the contexts where it helps and hurts. Load when the user asks who they really are, what work fits them, what drives or drains them, why they keep burning out, or what to build given who they are. Do NOT load to inventory a company's or product's strengths or to distill the one or two decisive personal advantages — the voters step, which co
asb-voters
asmartbear/asb-skills
Distills a person's or company's strengths, experiences, and obsessions down to their one or two VOTERS — the decisive, idiosyncratically extreme traits that win the contest because customers who value them accept every other trade-off. Runs each candidate through a hard gauntlet: extremity earned through obsession (not mere competence), rarity among peers, decisiveness (name the weaknesses it overpowers), and reverberation (it must force decisions in product, pricing, and market). Caps the answer at two, records survivors in VOTERS.md — plus the near-miss 'special strengths' to deploy — and delivers the honest zero-voter verdict when nothing is extreme yet. Takes a self-portrait file (M-numbered), strengths or keystones charts, or a live capture. Load when the user asks what makes them special, what to bet the strategy on, their unfair advantage or superpower, or to 'find our voters.' Do NOT load to build the full self-portrait (the previous step) or to design the whole strategy — thi
asb-positioning
asmartbear/asb-skills
Converts marketing copy — headlines, ads, homepage claims, pitches, positioning statements — into value-first, vivid language: reframes save-time/save-money pitches as create-more-value pitches in the currency the customer measures value, fits each claim to the right level of the customer's needs (features at your level, the promise one level up, aspirations referenced but never promised, obviated steps bragged about), keeps every claim consistent with the declared pricing strategy (More for More, More for Less, or Less for Less), and forces specificity — no generic words, no clichés, show-don't-tell, real numbers only, claims passing the Opposite Test. Works one message at a time, recording survivors in POSITIONING.md. Sharper with an ideal-customer definition and a needs stack; works without. Load when the user wants marketing copy, positioning, headlines, or a pitch rewritten, sharpened, or audited. Do NOT load to build the needs stack or define the ideal customer — upstream steps t
asb-rude-qa
asmartbear/asb-skills
Interrogates a user's decision, plan, pitch, positioning, target market, pricing, or still-forming idea with sharp, unsparing questions — extended when useful to hostile or even unfair framings — until the plan sharpens into defensible decisions, or the user concludes it isn't a good idea after all. Acts as the constructive devil's advocate that the user cannot be for themselves. Load when the user wants to stress-test, attack, pressure-test, find holes in, or play devil's advocate against something they're attached to; when they ask to be "grilled," "beat up," or told "why I'm wrong"; when they suspect their plan contains wishful thinking, fluffy language, or an unnamed elephant in the room; or when they need to convert vague aspirations into real strategic decisions (with consequences accepted). Do NOT load for ordinary code review, prose editing, or general feedback requests without an adversarial frame.
asb-problem
asmartbear/asb-skills
Scores whether a business idea can become a viable business, walking the path from 'The Problem' to 'Viable Business Model': one specific target market is Fermi-scored on seven multiplying criteria (Plausible, Self-Aware, Lucrative, Liquid, Eager ×2, Enduring), every optimistic number is challenged unless evidence backs it, and when the verdict is bad, narrower niches are re-scored side by side. Load when the user asks whether their startup or product idea is viable, whether a market really exists for what they want to build, why a product that solves a real problem isn't selling, which of several target markets to pursue, whether to persevere or give up on a product, or says 'score my idea.' Do NOT load for general devil's-advocate stress-testing of plans or pitches without the viability question, for building a full ideal-customer profile, for writing customer-interview questions, or for execution problems like funnel optimization, hiring, or fundraising.
asb-needs-stack
asmartbear/asb-skills
Builds a customer Needs Stack — the ladder in which every need is a means to the end one level up (buy infrastructure → set up a WordPress site → have a personal website → get a book deal). Anchors the level the user's product satisfies, phrased as the customer's own goal in the customer's own words, then walks downward (the steps the product makes obsolete) and upward (what the customer really wants), crystallizing every level — specific wording, a true means-to-an-end link, named real-world occupants — before moving on. Records the stack in NEEDS-STACK.md with the user's level marked and each level's positioning role: what you do, promise, reference as aspiration, or brag about obviating. Load when the user asks what their customer really wants, what level their product operates at, who their real alternatives (not just competitors) are, or to 'build our needs stack.' Do NOT load to rewrite marketing copy from a finished stack — that is a separate positioning task that consumes this
Popular docs & writing skills
grill-with-docs
mattpocock/skills
A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.
lark-markdown
open.feishu.cn
飞书 Markdown:查看、创建、上传、编辑和比较飞书中的原生 Markdown 文件。当用户要操作飞书 Markdown 文件,或比较其远端版本及本地草稿时使用。纯本地 Markdown 文件操作不触发本 skill。不负责将 Markdown 导入为飞书在线文档,也不负责文件搜索、权限、评论、移动、删除等云空间管理操作。
writing-beats
mattpocock/skills
Writing, exploit; assemble raw material into a journey of beats, grounding each term before a beat leans on it.
writing-shape
mattpocock/skills
Writing, exploit: shape raw material into an article, paragraph by paragraph.
writing-fragments
mattpocock/skills
Writing, explore: mine raw fragments, no structure yet.
writing-for-agents
mattpocock/skills
Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.