interview-script · owl-listener — Claude Code skill: what it does, how to install
Creates a structured user interview guide with open questions and facilitator notes. Use it before qualitative research interviews.
npx skills add Owl-Listener/designer-skills --skill interview-script -a claude-codeWhat interview-script does
This skill drafts a user interview guide from the topic you provide. It clarifies the research goal, target participants, and interview duration, then lays out an introduction, warm-up, core exploration, scenario walkthroughs, and wrap-up.
Questions move from broad context to specific details. The skill applies JTBD probing, adds follow-up prompts, and checks each question for leading wording or a yes-or-no answer.
It reads supplied personas, research goals, and product context before drafting the guide. Facilitator notes cover neutral phrasing, tangents, and time management. Bring those materials first, because they shape the resulting script.
What it helps with
- draft a user interview guide
- turn leading questions into open prompts
- probe past behaviour with JTBD questions
- organise questions by research theme
- add notes for interview facilitators
Example prompts for the agent
- Create an interview guide to explore why people abandon registration.
- Draft interview questions using the attached personas and research goals.
- Write a script about how users complete this task in the product.
How to install interview-script
1Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill interview-script -a claude-code2Manually: put the files in place
~/.claude/skills/interview-script/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/interview-script/
1Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill interview-script -a codex2Manually: put the files in place
.agents/skills/interview-script/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill interview-script -a cursor2Manually: put the files in place
.cursor/skills/interview-script/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Owl-Listener/designer-skills interview-script2Manually: put the files in place
.github/skills/interview-script/SKILL.md1Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill interview-script -a gemini-cli2Platform CLI
gemini skills install https://github.com/Owl-Listener/designer-skills --path design-research/skills/interview-scriptManually: put the files in place
.devin/skills/interview-script/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill interview-script -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 interview-script
How do I install interview-script in Claude Code?
Run npx skills add Owl-Listener/designer-skills --skill interview-script -a claude-code, then run npx skills add Owl-Listener/designer-skills --skill interview-script -a claude-code again. The skill file is at ~/.claude/skills/interview-script/SKILL.md.
What does interview-script do?
It produces a ready-to-use guide for qualitative user interviews. The output includes interview stages, open questions, follow-up prompts, and facilitator notes.
How does interview-script avoid leading questions?
It checks whether a question implies an answer or can be answered with yes or no. Such questions are rewritten as open invitations for the participant to describe their experience.
Source text
SKILL.md · MIT
---
name: interview-script
description: Write a structured interview guide — warm-up, core exploration, and wrap-up. Use before running interviews. For analysing what comes back, use `summarize-interview`.
---
# Interview Script
Create a structured user interview script for qualitative research.
## Context
You are a senior UX researcher preparing an interview script for $ARGUMENTS. If the user provides files (personas, research goals, product context), read them first.
## Domain Context
- User Interviews (Steve Portigal, Interviewing Users): Open-ended questions that reveal motivations, behaviors, and mental models.
- Follow the funnel approach: broad context questions before specific feature questions.
- Use JTBD probing: When did you last...? What were you trying to accomplish? What happened next?
- Avoid leading questions, hypotheticals, and yes/no questions.
## Instructions
1. **Clarify objectives**: Confirm the research goals, target participants, and interview duration.
2. **Create the script** with these sections:
- **Introduction** (2-3 min): Welcome, explain purpose, set expectations, get consent
- **Warm-up** (3-5 min): Easy context-setting questions about their background and role
- **Core exploration** (20-30 min): Deep-dive questions organized by research theme, with follow-up probes
- **Specific scenarios** (10-15 min): Walk-through of specific tasks or experiences
- **Wrap-up** (3-5 min): Summary, anything we missed, next steps, thank you
3. **Include probing techniques**: "Tell me more about that", "Why was that important?", "What happened next?"
4. **Add facilitator notes**: Tips for staying neutral, handling tangents, and managing time.
5. Think step by step. Present the script in a ready-to-use format.
## Question Quality Guardrails
**Ensure all questions are non-leading.** A leading question contains the answer or implies a preferred response. Replace any question that assumes sentiment, behaviour, or outcome.
| Leading (avoid) | Non-leading (use) |
|---|---|
| "Was that frustrating?" | "How did you feel about that?" |
| "Did you find it easy?" | "How easy or difficult was that for you?" |
| "Did you like the feature?" | "What did you notice about that feature, if anything?" |
| "Would you use this?" | "How would you use this in your work, if at all?" |
**Test each question before including it:** If the question contains its own implied answer, rewrite it as an open invitation. If the question can be answered with yes or no, extend it ("...and why?").
## Further Reading
- Interviewing Users — Steve Portigal
- Just Enough Research — Erika Hall
© Owl-Listener · MIT · Owl-Listener/designer-skills
Similar skills
Everything for Design →interview-script by other authors comes first.