interviews
GitHub管理创始人客户发现访谈全流程，包括起草、优化脚本及分析转录内容。用于准备访谈、生成或修改脚本、更新状态、提取洞察、评估技巧并调整假设。
Trigger Scenarios
Install
npx skills add davepoon/buildwithclaude --skill interviews -g -y
SKILL.md
Frontmatter
{
"name": "interviews",
"description": "Manages the founder's customer discovery interview lifecycle — drafting scripts tailored to a target segment, refining existing ones, managing script status, and analyzing interview transcripts to extract insights, review technique, and update hypothesis state. Use when the founder wants to prep for interviews, draft a discovery script, refine questions, change a script's status, analyze a completed interview (transcript, paste, or recollection), extract insights, or review how an interview went."
}
Interviews
Help the founder run the full customer discovery interview loop — from preparing a script to analyzing what was said afterward.
This skill covers two phases:
- Script management — drafting, refining, and managing the lifecycle of reusable interview scripts.
- Transcript analysis — after an interview has happened, extracting statements, linking them to hypotheses, reviewing the founder's interviewing technique, and recommending hypothesis state changes.
An interview script is a reusable guide, not a teleprompter: it anchors the conversation around the assumptions being tested while leaving room for the founder to follow threads that open up. Most founders need one script for their primary segment; occasionally a second script for an adjacent segment.
Before you start
Read startup/core.md to load project context (name, seed description, and all fields under ## Core — especially Audience).
Check if startup/interview-scripts/ contains any .md files.
Scaffold the folders if they don't exist yet:
mkdir -p startup/interview-scripts
mkdir -p startup/interviews/transcripts
When scripts already exist
Load and understand them for context. Infer intent from the conversation — don't mechanically ask "what do you want to do?" If the founder is:
- Referring to a specific script — load that file, discuss, help edit the relevant section
- Iterating after running interviews — help revise questions that didn't land, add follow-ups that proved useful, tighten or expand as needed
- Drafting a script for a different segment — start a new script (route to the reference file below if they want a guided draft, or draft directly if they know what they want)
- Changing status — read the file, propose the change, write it back
draft— still being shaped, not yet usedready— actively in use for interviewsretired— superseded or no longer in rotation
When adding or updating scripts, follow the file conventions:
- YAML frontmatter with
status(draft,ready,retired),length_minutes(number — 15/30/45/60), andtarget_persona(one-line segment descriptor) - H1 heading: script title — segment + focus, e.g. "Freelance designers — invoice chasing"
## Target Persona— 2–4 sentences describing who this script is for and why## Opening— what the founder says at the start: purpose, consent to record, framing## Core Questions— numbered questions with optional indented probes## Closing— wrap-up, referrals ask, thank-you- Optional
## Notes— facilitation tips for the founder
Slug convention: lowercase the title, replace spaces and non-alphanumeric characters with hyphens, collapse multiple hyphens. "Freelance designers — invoice chasing" → freelance-designers-invoice-chasing.
Read before writing, propose before saving, get confirmation.
When no scripts exist
Check prerequisites:
-
core.mdis missing or has noAudienceor similar information that provides this information under## Core: Mention that a defined target audience sharpens the script considerably — suggest filling that in first (via thewhats-nextskill or directly incore.md). Do not block: if the founder wants to proceed with a rough persona, proceed. -
startup/hypotheses/is empty or has fewer than 3 hypotheses: Mention that scripts work best when they're built around specific hypotheses to test — suggest invoking thehypothesesskill first. Do not block: if the founder insists on drafting a script now, proceed. -
Prerequisites met (or founder insists): Load the reference file for the guided script-creation conversation:
.claude/skills/interviews/references/initial-interview-script.md
The reference file's instructions take over from this point.
When a transcript arrives
After the founder runs an interview, they may bring back a transcript, paste text into chat, or simply recount a conversation from memory. In any of these cases, the workflow is the same: save the source material, dispatch the interview-analyst subagent, then dispatch the hypotheses-manager subagent, surface recommendations to the founder, and route confirmed hypothesis changes through the hypotheses skill.
Recognize this intent when the founder:
- Points at a transcript file under
startup/interviews/transcripts/(or similar) - Pastes transcript-shaped text (dialogue, Q&A, long monologue) into chat
- Describes a conversation from memory ("I talked to someone at a coffee shop…", "I had a call with a designer and she said…")
- Asks to analyze, review, or extract insights from a completed interview
Load the Layer 2 reference file that owns this workflow end-to-end:
.claude/skills/interviews/references/transcript-analysis.md
The reference file's instructions take over from this point, including the three input branches (file / pasted / recollection), dispatching both subagents, summarizing to the founder, and routing confirmed edits through the hypotheses skill.
Do not extract statements, evaluate hypothesis state, or edit hypothesis files yourself — the reference file describes how to delegate that work to the two subagents.
Version History
- 502fc01 Current 2026-07-05 15:17
