Agent skill

Discovery Interview Guide

by mohitagw15856 in mohitagw15856/pm-claude-skills

Create a structured user discovery interview guide with screener questions, a discussion guide, and a synthesis framework.

MITAuto-check passedProduct & Project Management

Install Discovery Interview Guide

skills CLI
$ npx skills add mohitagw15856/pm-claude-skills --skill discovery-interview-guide -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install mohitagw15856/pm-claude-skills discovery-interview-guide --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/mohitagw15856/pm-claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/discovery-interview-guide .claude/skills/discovery-interview-guide && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
discovery-interview-guide
GitHub stars
1.4k
Token cost
~2k tokens
SKILL.md length
1,041 words
Files
4 (incl. references)
Skills in repo
1,348
Repo updated
First seen
Licence
MIT

At a glance

Create a structured user discovery interview guide with screener questions, a discussion guide, and a synthesis framework.

  • Works in 5 steps: Warm-Up (5 min) → Context Setting (10 min) → Problem Exploration (25 min) — THE CORE → …
  • Planning user interviews
  • SKILL.md covers Core Principles, Interview Structure (60…, Output Format and Required Inputs, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Discovery Interview Guide is an agent skill from mohitagw15856/pm-claude-skills. Create a structured user discovery interview guide with screener questions, a discussion guide, and a synthesis framework. Use when planning user interviews, customer discovery sessions, Jobs-to-be-Done research, or problem validation. Produces a complete guide covering warm-up, problem exploration, and a per-session synthesis template.

Its SKILL.md is about 2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `references/question-craft.md`, `references/worked-example.md` and `templates/guide-skeleton.md`).

It sits in Product & Project Management, covering User research. The repository describes itself as: 1255 professional Agent Skills for Claude, ChatGPT, Gemini, Cursor & Codex — PRDs, postmortems, leases, medical bills, layoffs, go-bags, new countries. Plain markdown, MIT, in… The licence is MIT.

When your agent uses it

  • Planning user interviews
  • Customer discovery sessions
  • Jobs-to-be-Done research
  • Problem validation

Example prompts

  • “/discovery-interview-guide”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Warm-Up (5 min)
  2. Context Setting (10 min)
  3. Problem Exploration (25 min) — THE CORE
  4. Current Solutions (10 min)
  5. Wrap-Up (10 min)

What it can do on your machine

Read from SKILL.md and the folder at commit 1cbf1f0. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Discovery Interview Guide loads about 2k tokens when it runs, and up to ~4.5k if it reads all its reference files. Until then it costs about 91 tokens; SKILL.md has 1,041 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~91
When it runs · the whole SKILL.md, loaded when a task matches
~2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from mohitagw15856/pm-claude-skills at commit 1cbf1f0, republished under its MIT licence (© mohitagw15856). 1,041 words, ~1,956 tokens.

Download SKILL.mdSave it as .claude/skills/discovery-interview-guide/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
discovery-interview-guide
description
Create a structured user discovery interview guide with screener questions, a discussion guide, and a synthesis framework. Use when planning user interviews, customer discovery sessions, Jobs-to-be-Done research, or problem validation. Produces a complete guide covering warm-up, problem exploration, and a per-session synthesis template.

Discovery Interview Guide Skill

Design interviews that surface genuine insight — not validation of what you already believe. Every guide follows a story-based, past-behaviour-focused structure.

Core Principles

  1. Never ask about the future. "Would you use X?" tells you nothing. "Tell me about the last time you did X" tells you everything.
  2. Interview for behaviour, not opinion. Opinions are cheap. Behaviour is evidence.
  3. The 5 Whys. Every surface answer is a door. Keep opening doors.
  4. Confirm the problem before exploring the solution. Never show a prototype until you've confirmed the pain exists unprompted.

Interview Structure (60 minutes standard)

1. Warm-Up (5 min)

Build rapport. Get them talking. Don't discuss the topic yet.

  • "Tell me a bit about your role and what a typical week looks like for you."
  • "What tools do you rely on most day-to-day?"
2. Context Setting (10 min)

Understand their world before diving into the problem space.

  • "Walk me through how you currently [handle the domain area]."
  • "What does that process look like from start to finish?"
  • "Who else is involved when you do this?"
3. Problem Exploration (25 min) — THE CORE

Surface pain without leading.

  • "Tell me about the last time you had to [relevant task]. What happened?"
  • "What was the hardest part of that?"
  • "How did you handle it?"
  • "What did you try before settling on that approach?"
  • "What does it cost you when this goes wrong?" (time, money, stress, reputation)
  • "If you could wave a magic wand and change one thing about this process, what would it be?"

⚠️ Do not mention your product or feature during this phase.

4. Current Solutions (10 min)

Understand the competitive landscape from their perspective.

  • "What tools or workarounds do you use today for this?"
  • "What do you like about [current solution]? What frustrates you?"
  • "Have you tried other approaches? What happened?"
5. Wrap-Up (10 min)
  • "Is there anything about this topic we haven't covered that you think I should know?"
  • "Is there anyone else you'd recommend I speak to?"
  • "Would you be open to a follow-up if I have more questions?"

Output Format

Discovery Interview Guide — [Topic] — [Date]

Research Goal: [One sentence: what decision will this research inform?] Target Participant Profile: [Role, company size, behaviour qualifier]

Screener Questions (for recruiting):

  1. [Question] → Must answer: [Y/N or specific]
  2. [Question] → Must answer: [Y/N or specific]
  3. [Disqualifier question] → Disqualify if: [answer]

Interview Guide:

[Full structured guide using the format above, customised to the specific research topic]

Synthesis Template (fill after each interview):

  • Key quote: "[verbatim]"
  • Core pain: [1 sentence]
  • Current workaround: [what they're doing today]
  • Intensity (1–5): [how painful is this?]
  • Surprise/unexpected finding: [anything that challenged your assumptions]

Pattern Detection (after 5+ interviews):

  • Pain mentioned by [X/N] participants: [theme]
  • Workaround used by [X/N] participants: [theme]
  • Most emotionally charged moment in interviews: [observation]

Required Inputs

Ask the user for these if not provided:

  • Research topic or question (what decision will this inform?)
  • Target participant profile (role, behaviour, company type)
  • Session length (30 / 45 / 60 / 90 minutes)
  • Number of interviews planned
  • Known hypotheses to test or avoid confirming prematurely (optional)

Deeper Materials

This skill ships with support files — use them when they are available:

  • references/question-craft.md — Question Craft: Getting Truth Instead of Politeness. Apply it while producing the output; it carries the calibration and judgment calls the method summary above compresses.
  • templates/guide-skeleton.md — a fill-in version of the deliverable with the quality gates inline. Offer it when the user wants to work the document themselves rather than have it generated.
Show full SKILL.md (462 more words)Show less

Scoring Rubric (0–40)

Score any output of this skill before handing it over; 32+ is ship-quality.

Dimension0510
Behavioural anchoringQuestions are hypothetical ("Would you use…?") or answerable yes/noMostly past-tense, but a few opinion or future-tense questions slipped into the core sectionEvery problem question is anchored to a specific past event ("tell me about the last time…") and open-ended
Solution containmentThe product or feature appears in the screener or early questions, anchoring every answerProduct withheld from questions but the guide gives the interviewer no script for when participants ask what's being builtProduct absent from all phases before pain is confirmed, with an inline interviewer note and deflection script guarding the boundary
Screener selectivityScreeners are self-assessments anyone can pass ("Are you responsible for X?")Screeners qualify on role and firmographics but include no behaviour check or disqualifierScreeners qualify on recent, verifiable behaviour, include an explicit disqualifier, and would be hard to guess the "right" answer to
Synthesis machineryNo per-session template or pattern-detection plan; synthesis left to memoryTemplate exists but lacks intensity rating or surprise capture; pattern thresholds not tied to planned interview countPer-session template with anchored intensity scale and surprise field, plus pattern detection gated at 5+ interviews with X/N counts matched to the planned sample

Quality Checks

  • No future-tense questions ("would you...") — only past-behaviour questions
  • Product or solution not mentioned until after pain is confirmed
  • Questions open-ended (cannot be answered yes/no)
  • Synthesis template included for per-session notes
  • Screener questions identify and disqualify wrong participants

Guidelines

  • Recommend 5–8 interviews to reach thematic saturation for most discovery questions
  • Always record with permission — transcripts beat notes
  • If user is new to interviewing: remind them to stay silent after asking a question (aim for 80/20 participant-to-interviewer talking ratio)
  • Never synthesise during the interview — do it after, when you can look across sessions
  • Flag confirmation bias: if user writes questions that lead toward a predetermined answer, rewrite them as open-ended alternatives

Anti-Patterns

  • Do not use future-tense questions ("Would you use this?") — hypothetical responses do not predict real behaviour and produce false confidence in an idea
  • Do not mention your product or solution before problem exploration is complete — doing so anchors the participant's responses and invalidates the discovery
  • Do not synthesise across fewer than 5 interviews — themes from 2–3 interviews reflect anecdote, not pattern; wait for saturation
  • Do not write screener questions that are too easy to pass — if participants can guess the "right" answer, you will recruit the wrong people
  • Do not treat participant opinions as evidence of future behaviour — what people say they will do consistently diverges from what they actually do

Example Trigger Phrases

  • "Plan user interviews."
  • "Write a customer discovery interview guide."
  • "Plan Jobs-to-be-Done interviews."
  • "Help me validate this problem with customers."

© mohitagw15856, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references) in skills/discovery-interview-guide of mohitagw15856/pm-claude-skills.

  • SKILL.md
  • references/question-craft.md
  • references/worked-example.md
  • templates/guide-skeleton.md

Open the folder on GitHubat commit 1cbf1f0

Compare with similar skills

Discovery Interview Guide next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Discovery Interview Guide compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Discovery Interview Guide this skillmohitagw15856/pm-claude-skills1.4k—~2kAutomated safety check: PassMIT
User Research Cookiycookiy-ai/user-research-skill1.6k—~954Automated safety check: PassMIT
Fable DomainSahir619/fable-method2.3k—~2.6kAutomated safety check: PassMIT
Produck Feedback To Buildtryproduck/produck-skills511—~1kAutomated safety check: PassApache-2.0
Customer InterviewsRefoundAI/lenny-skills1.4k—~1.7kAutomated safety check: PassMIT
Product Discovery Brief Builderopen-mercato/skills231—~3kAutomated safety check: PassMIT

Similar skills

  • User Research Cookiy

    cookiy-ai/user-research-skill

    End-to-end user research assistant — qualitative and quantitative.

    1.6k GitHub stars~954 tokensUpdated 1 mo ago
    Product & Project ManagementAuto-check passed
  • Fable Domain

    Sahir619/fable-method

    Discuss a domain with the user, research it from real sources, then generate a trusted skill bundle for it - a step-by-step workflow with a flowchart, a domain adapter, a trap fixture, and a smoke…

    2.3k GitHub stars~2.6k tokensUpdated 7 days ago
    Product & Project ManagementAuto-check passed
  • Produck Feedback To Build

    tryproduck/produck-skills

    Pulls full in-context user feedback tickets through the Produck MCP server and turns them into an aligned product change instead of a guess.

    511 GitHub stars~1k tokensUpdated 1 mo ago
    Product & Project ManagementAuto-check passed
  • Customer Interviews

    RefoundAI/lenny-skills

    Help users conduct high-impact customer interviews that move beyond surface-level feature requests to identify root emotional frustrations and specific causal triggers.

    1.4k GitHub stars~1.7k tokensUpdated 2 mo ago
    Product & Project ManagementAuto-check passed
  • Guides a product discovery conversation and writes product-brief.md with the problem, evidence, scope, decisions and the next open question, for existing, client or own ideas.

    231 GitHub stars~3k tokensUpdated 5 days ago
    Product & Project ManagementAuto-check passed
  • Discovery Synthesis

    andreaskelm/pm-brain

    Plan customer discovery, turn interview snapshots into synthesis and evidence-based opportunities, build or update an Opportunity Solution Tree, map jobs and segments, and design RAT tests for the…

    234 GitHub stars~2.3k tokensUpdated yesterday
    Product & Project ManagementAuto-check passed

More from mohitagw15856/pm-claude-skills

All 1,348 skills in this repo
  • Car Tco

    mohitagw15856/pm-claude-skills

    Compare the total cost of car ownership across buy-new, buy-used, lease, and keep-your-current-car — depreciation, insurance, maintenance ramp, and fuel over a real horizon, not just the monthly…

    1.4k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Cs Health Scorecard

    mohitagw15856/pm-claude-skills

    Build a customer health scorecard for a specific account. An agent skill from mohitagw15856/pm-claude-skills.

    1.4k GitHub stars~2.4k tokensUpdated yesterday
    Auto-check passed
  • Exit Waterfall

    mohitagw15856/pm-claude-skills

    Compute who gets what at each exit price from a cap table — liquidation preferences, conversion points, and where the founders' share collapses.

    1.4k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Feature Prioritisation

    mohitagw15856/pm-claude-skills

    Apply prioritisation frameworks (RICE, MoSCoW, Kano, ICE, Opportunity Scoring) to rank features and backlog items.

    1.4k GitHub stars~2k tokensUpdated yesterday
    Auto-check passed
  • Fire Number

    mohitagw15856/pm-claude-skills

    Compute a financial-independence (FIRE) target and years-to-reach with every assumption labeled as an assumption — plus a sensitivity table instead of a single false-precision answer.

    1.4k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Freelance Rate

    mohitagw15856/pm-claude-skills

    Derive a freelance day/hourly rate backwards from target income, honest billable utilization, overhead, and the self-employment tax premium — the arithmetic that proves a rate is not salary÷2000.

    1.4k GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed

Questions about Discovery Interview Guide

What does Discovery Interview Guide do?

Create a structured user discovery interview guide with screener questions, a discussion guide, and a synthesis framework. Discovery Interview Guide is an agent skill from mohitagw15856/pm-claude-skills. Create a structured user discovery interview guide with screener questions, a discussion guide, and a synthesis framework.

When should I use Discovery Interview Guide?

Discovery Interview Guide fits situations like: planning user interviews; customer discovery sessions; jobs-to-be-Done research; problem validation.

How do I install Discovery Interview Guide in Claude Code?

Run `npx skills add mohitagw15856/pm-claude-skills --skill discovery-interview-guide -a claude-code`. Or copy the skill folder (skills/discovery-interview-guide in mohitagw15856/pm-claude-skills) into .claude/skills/discovery-interview-guide in your project. Claude Code loads it when a task matches its description.

How do I install Discovery Interview Guide in Codex?

Run `npx skills add mohitagw15856/pm-claude-skills --skill discovery-interview-guide -a codex`. Or copy the skill folder (skills/discovery-interview-guide in mohitagw15856/pm-claude-skills) into .agents/skills/discovery-interview-guide in your project. Codex loads it when a task matches its description.

Can I use Discovery Interview Guide in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add mohitagw15856/pm-claude-skills --skill discovery-interview-guide -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/discovery-interview-guide, .gemini/skills/discovery-interview-guide, .github/skills/discovery-interview-guide and .opencode/skills/discovery-interview-guide in your project.

What does Discovery Interview Guide need to run?

SKILL.md names no scripts, command-line tools or credentials: Discovery Interview Guide is instructions for the agent only.

Does Discovery Interview Guide access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Discovery Interview Guide safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Discovery Interview Guide use?

Discovery Interview Guide is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Discovery Interview Guide use?

About 2k tokens (SKILL.md is roughly 7.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.6k tokens, read only when the agent opens those files.

What are the alternatives to Discovery Interview Guide?

Skills that share tags, products or a category with Discovery Interview Guide: User Research Cookiy (cookiy-ai/user-research-skill, 1.6k stars), Fable Domain (Sahir619/fable-method, 2.3k stars), Produck Feedback To Build (tryproduck/produck-skills, 511 stars) and Customer Interviews (RefoundAI/lenny-skills, 1.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Discovery Interview Guide?

mohitagw15856 (a GitHub user) maintains it in mohitagw15856/pm-claude-skills, which has 1,434 GitHub stars. The repository holds 1,348 skills in this directory. The repository was last updated on October 9, 2026.

Source: mohitagw15856/pm-claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.