Agent skill

Discovery Interviews Surveys

by nicepkg in nicepkg/ai-workflow

A skill your agent uses when validating product assumptions before building, discovering unmet user needs, understanding customer problems and workflows, testing concepts or positioning, researching…

MITAuto-check passedProduct & Project Management

Install Discovery Interviews Surveys

skills CLI
$ npx skills add nicepkg/ai-workflow --skill discovery-interviews-surveys -a claude-code

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

GitHub CLI
$ gh skill install nicepkg/ai-workflow discovery-interviews-surveys --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/nicepkg/ai-workflow.git skills-src && mkdir -p .claude/skills && cp -r skills-src/workflows/product-manager-workflow/.claude/skills/discovery-interviews-surveys .claude/skills/discovery-interviews-surveys && 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-interviews-surveys
GitHub stars
285
Token cost
~3k tokens
SKILL.md length
1,280 words
Files
4
Skills in repo
61
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when validating product assumptions before building, discovering unmet user needs, understanding customer problems and workflows, testing concepts or positioning, researching…

  • Works in 5 steps: Interview guides: Open-ended questions… → Survey instruments: Scaled questions for… → JTBD probes: Questions focused on… → …
  • Validating product assumptions before building
  • SKILL.md covers Table of Contents, Purpose, When to Use and What Is It?, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Discovery Interviews Surveys is an agent skill from nicepkg/ai-workflow. Use when validating product assumptions before building, discovering unmet user needs, understanding customer problems and workflows, testing concepts or positioning, researching target markets, identifying jobs-to-be-done and hiring triggers, uncovering pain points and workarounds, or when users mention user research, customer interviews, surveys, discovery interviews, validation studies, or voice of customer.

Its SKILL.md is about 3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files (for example `resources/evaluators/rubric_discovery_interviews_surveys.json`, `resources/methodology.md` and `resources/template.md`).

It sits in Product & Project Management, covering User research. The repository describes itself as: 🚀 170+ pre-built skills for Claude Code, Cursor, Codex & 14+ AI tools. Stop re-teaching your AI the same things. One command → instant domain expertise. Marketing, SEO, Trading… The licence is MIT.

When your agent uses it

  • Validating product assumptions before building
  • Discovering unmet user needs
  • Understanding customer problems and workflows
  • Testing concepts

Example prompts

  • “/discovery-interviews-surveys”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Interview guides: Open-ended questions that reveal problems and context
  2. Survey instruments: Scaled questions for quantitative validation at scale
  3. JTBD probes: Questions focused on hiring/firing triggers and desired outcomes
  4. Bias-avoidance techniques: Past behavior focus, "show me" requests, avoiding hypotheticals
  5. Analysis frameworks: Thematic coding, affinity mapping, statistical analysis

What it can do on your machine

Read from SKILL.md and the folder at commit d167b41. 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 Interviews Surveys loads about 3k tokens when it runs. Until then it costs about 111 tokens; SKILL.md has 1,280 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~111
When it runs · the whole SKILL.md, loaded when a task matches
~3k

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 nicepkg/ai-workflow at commit d167b41, republished under its MIT licence (© nicepkg). 1,280 words, ~3,039 tokens.

Download SKILL.mdSave it as .claude/skills/discovery-interviews-surveys/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
discovery-interviews-surveys
description
Use when validating product assumptions before building, discovering unmet user needs, understanding customer problems and workflows, testing concepts or positioning, researching target markets, identifying jobs-to-be-done and hiring triggers, uncovering pain points and workarounds, or when users mention user research, customer interviews, surveys, discovery interviews, validation studies, or voice of customer.

Discovery Interviews & Surveys

Table of Contents

Purpose

Discovery Interviews & Surveys help you learn from users systematically to:

  • Validate assumptions before investing in building
  • Discover real problems users experience (not just stated needs)
  • Understand jobs-to-be-done (what users "hire" your product to do)
  • Identify pain points and current workarounds
  • Test concepts and positioning with target audience
  • Uncover unmet needs that users may not articulate directly

This moves from guessing to evidence-based product decisions.

When to Use

Use this skill when:

  • Pre-build validation: Testing product ideas before development
  • Problem discovery: Understanding user pain points and workflows
  • Jobs-to-be-done research: Identifying hiring/firing triggers and desired outcomes
  • Market research: Understanding target audience, competitive landscape, willingness to pay
  • Concept testing: Validating positioning, messaging, feature prioritization
  • Post-launch learning: Understanding adoption barriers, churn reasons, expansion opportunities
  • Customer satisfaction research: Identifying satisfaction/dissatisfaction drivers
  • UX research: Mental models, task flows, usability issues
  • Voice of customer: Gathering qualitative insights for roadmap prioritization

Trigger phrases: "user research", "customer interviews", "surveys", "discovery", "validation study", "voice of customer", "jobs-to-be-done", "JTBD", "user needs"

What Is It?

Discovery Interviews & Surveys provide structured approaches to learn from users while avoiding common biases (leading questions, confirmation bias, selection bias).

Key components:

  1. Interview guides: Open-ended questions that reveal problems and context
  2. Survey instruments: Scaled questions for quantitative validation at scale
  3. JTBD probes: Questions focused on hiring/firing triggers and desired outcomes
  4. Bias-avoidance techniques: Past behavior focus, "show me" requests, avoiding hypotheticals
  5. Analysis frameworks: Thematic coding, affinity mapping, statistical analysis

Quick example:

Bad interview question (leading, hypothetical): "Would you pay $49/month for a tool that automatically backs up your files?"

Good interview approach (behavior-focused, problem-discovery):

  1. "Tell me about the last time you lost important files. What happened?"
  2. "What have you tried to prevent data loss? How's that working?"
  3. "Walk me through your current backup process. Show me if possible."
  4. "What would need to change for you to invest time/money in better backup?"

Result: Learn about actual problems, current solutions, willingness to change—not hypothetical preferences.

Workflow

Copy this checklist and track your progress:

Discovery Research Progress:
- [ ] Step 1: Define research objectives and hypotheses
- [ ] Step 2: Identify target participants
- [ ] Step 3: Choose research method (interviews, surveys, or both)
- [ ] Step 4: Design research instruments
- [ ] Step 5: Conduct research and collect data
- [ ] Step 6: Analyze findings and extract insights

Step 1: Define research objectives

Specify what you're trying to learn, key hypotheses to test, success criteria for research, and decision to be informed. See Common Patterns for typical objectives.

Step 2: Identify target participants

Define participant criteria (demographics, behaviors, firmographics), sample size needed, recruitment strategy, and screening questions. For sampling strategies, see resources/methodology.md.

Step 3: Choose research method

Based on objective and constraints:

  • For deep problem discovery (5-15 participants) → Use resources/template.md for in-depth interviews
  • For concept testing at scale (50-200+ participants) → Use resources/template.md for quantitative validation
  • For JTBD research → Use resources/methodology.md for switch interviews
  • For mixed methods → Interviews for discovery, surveys for validation

Step 4: Design research instruments

Create interview guide or survey with bias-avoidance techniques. Use resources/template.md for structure. Avoid leading questions, focus on past behavior, use "show me" requests. For advanced question design, see resources/methodology.md.

Step 5: Conduct research

Execute interviews (record with permission, take notes) or distribute surveys (pilot test first). Use proper techniques (active listening, follow-up probes, silence for thinking). See Guardrails for critical requirements.

Step 6: Analyze findings

For interviews: thematic coding, affinity mapping, quote extraction. For surveys: statistical analysis, cross-tabs, open-end coding. Create insights document with evidence. Self-assess using resources/evaluators/rubric_discovery_interviews_surveys.json. Minimum standard: Average score ≥ 3.5.

Common Patterns

Pattern 1: Problem Discovery Interviews

  • Objective: Understand user pain points and current workflows
  • Approach: 8-12 in-depth interviews, open-ended questions, focus on past behavior and actual solutions
  • Key questions: "Tell me about the last time...", "Walk me through...", "What have you tried?", "How's that working?"
  • Output: Problem themes, frequency estimates, current workarounds, willingness to change
  • Example: B2B SaaS discovery—interview potential customers about current tools and pain points

Pattern 2: Jobs-to-be-Done Research

  • Objective: Identify why users "hire" products and what triggers switching
  • Approach: Switch interviews with recent adopters or switchers, focus on timeline and context
  • Key questions: "What prompted you to look?", "What alternatives did you consider?", "What almost stopped you?", "What's different now?"
  • Output: Hiring triggers, firing triggers, desired outcomes, anxieties, habits
  • Example: SaaS churn research—interview recent churners about switch to competitor

Pattern 3: Concept Testing (Qualitative)

  • Objective: Test product concepts, positioning, or messaging before launch
  • Approach: 10-15 interviews showing concept (mockup, landing page, description), gather reactions
  • Key questions: "In your own words, what is this?", "Who is this for?", "What would you use it for?", "How much would you expect to pay?"
  • Output: Comprehension score, perceived value, target audience clarity, pricing anchors
  • Example: Pre-launch validation—test landing page messaging with target audience

Pattern 4: Survey for Quantitative Validation

  • Objective: Validate findings from interviews at scale or prioritize features
  • Approach: 100-500 participants, mix of scaled questions (Likert, ranking) and open-ends
  • Key questions: Satisfaction scores (CSAT, NPS), feature importance/satisfaction (Kano), usage frequency, demographics
  • Output: Statistical significance, segmentation, prioritization (importance vs satisfaction matrix)
  • Example: Product roadmap prioritization—survey 500 users on feature importance

Pattern 5: Continuous Discovery

  • Objective: Ongoing learning, not one-time project
  • Approach: Weekly customer conversations (15-30 min), rotating team members, shared notes
  • Key questions: Varies by current focus (new features, onboarding, expansion, retention)
  • Output: Continuous insight feed, early problem detection, relationship building
  • Example: Product team does 3-5 customer calls weekly, logs insights in shared doc
Show full SKILL.md (412 more words)Show less

Guardrails

Critical requirements:

  1. Avoid leading questions: Don't telegraph the "right" answer. Bad: "Don't you think our UI is confusing?" Good: "Walk me through using this feature. What happened?"

  2. Focus on past behavior, not hypotheticals: What people did reveals truth; what they say they'd do is often wrong. Bad: "Would you use this feature?" Good: "Tell me about the last time you needed to do X."

  3. Use "show me" not "tell me": Actual behavior > described behavior. Ask to screen-share, demonstrate current workflow, show artifacts (spreadsheets, tools).

  4. Recruit right participants: Screen carefully. Wrong participants = wasted time. Define inclusion/exclusion criteria, use screening survey.

  5. Sample size appropriate for method: Interviews: 5-15 for themes to emerge. Surveys: 100+ for statistical significance, 30+ per segment if comparing.

  6. Avoid confirmation bias: Actively look for disconfirming evidence. If 9/10 interviews support hypothesis, focus heavily on the 1 that doesn't.

  7. Record and transcribe (with permission): Memory is unreliable. Record interviews, transcribe for analysis. Take notes as backup.

  8. Analyze systematically: Don't cherry-pick quotes that support preferred conclusion. Use thematic coding, count themes, present contradictory evidence.

Common pitfalls:

  • ❌ Asking "would you" questions: Hypotheticals are unreliable. Focus on "have you", "tell me about when", "show me"
  • ❌ Small sample statistical claims: "80% of users want feature X" from 5 interviews is not valid. Interviews = themes, surveys = statistics
  • ❌ Selection bias: Interviewing only enthusiasts or only detractors skews results. Recruit diverse sample
  • ❌ Ignoring non-verbal cues: Hesitation, confusion, workarounds during "show me" reveal truth beyond words
  • ❌ Stopping at surface answers: First answer is often rationalization. Follow up: "Tell me more", "Why did that matter?", "What else?"

Quick Reference

Key resources:

Typical workflow time:

  • Interview guide design: 1-2 hours
  • Conducting 10 interviews: 10-15 hours (including scheduling)
  • Analysis and synthesis: 4-8 hours
  • Survey design: 2-4 hours
  • Survey distribution and collection: 1-2 weeks
  • Survey analysis: 2-4 hours

When to escalate:

  • Large-scale quantitative studies (1000+ participants)
  • Statistical modeling or advanced segmentation
  • Longitudinal studies (tracking over time)
  • Ethnographic research (observing in natural setting) → Use resources/methodology.md or consider specialist researcher

Inputs required:

  • Research objective: What you're trying to learn
  • Hypotheses (optional): Specific beliefs to test
  • Target persona: Who to interview/survey
  • Job-to-be-done (optional): Specific JTBD focus

Outputs produced:

  • discovery-interviews-surveys.md: Complete research plan with interview guide or survey, recruitment criteria, analysis plan, and insights template

© nicepkg, 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 in workflows/product-manager-workflow/.claude/skills/discovery-interviews-surveys of nicepkg/ai-workflow.

  • SKILL.md
  • resources/evaluators/rubric_discovery_interviews_surveys.json
  • resources/methodology.md
  • resources/template.md

Open the folder on GitHubat commit d167b41

Compare with similar skills

Discovery Interviews Surveys 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 Interviews Surveys compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Discovery Interviews Surveys this skillnicepkg/ai-workflow285—~3kAutomated 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-skills510—~1kAutomated safety check: PassApache-2.0
MITRE Problem Framing Canvasdeanpeters/Product-Manager-Skills7.2k2 repos~4.5kAutomated safety check: PassCustom licence
Customer InterviewsRefoundAI/lenny-skills1.4k—~1.7kAutomated 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 5 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.

    510 GitHub stars~1k tokensUpdated 1 mo ago
    Product & Project ManagementAuto-check passed
  • MITRE Problem Framing Canvas

    deanpeters/Product-Manager-Skills

    Guides a three-phase canvas, looking inward, looking outward, then reframing, to produce an equity-aware problem statement.

    7.2k GitHub starsUsed in 2 repos~4.5k tokens
    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.

    227 GitHub stars~3k tokensUpdated 3 days ago
    Product & Project ManagementAuto-check passed

More from nicepkg/ai-workflow

All 61 skills in this repo
  • Capture Triage

    nicepkg/ai-workflow

    Processes Drafts Pro captures from the Inbox folder. An agent skill from nicepkg/ai-workflow.

    285 GitHub stars~3k tokensUpdated 8 mo ago
    Auto-check passed
  • Legacy To AI Ready

    nicepkg/ai-workflow

    Transform legacy codebases into AI-ready projects with Claude Code configurations.

    285 GitHub stars~2.2k tokensUpdated 8 mo ago
    Auto-check: notes
  • Newsletter Coach

    nicepkg/ai-workflow

    Writing coach that extracts educational content from your daily experiences and turns it into publish-ready newsletter drafts.

    285 GitHub stars~3.7k tokensUpdated 8 mo ago
    Auto-check passed
  • Webfluence

    nicepkg/ai-workflow

    Content web architecture framework. An agent skill from nicepkg/ai-workflow.

    285 GitHub stars~1.4k tokensUpdated 8 mo ago
    Auto-check passed
  • Workflow Creator

    nicepkg/ai-workflow

    Create complete Claude Code workflow directories with curated skills.

    285 GitHub stars~2.6k tokensUpdated 8 mo ago
    Auto-check passed
  • Media Processing

    nicepkg/ai-workflow

    Video/audio/image processing with FFmpeg and ImageMagick. An agent skill from nicepkg/ai-workflow.

    285 GitHub stars~2.4k tokensUpdated 8 mo ago
    Auto-check: notes

Questions about Discovery Interviews Surveys

What does Discovery Interviews Surveys do?

A skill your agent uses when validating product assumptions before building, discovering unmet user needs, understanding customer problems and workflows, testing concepts or positioning, researching…. Discovery Interviews Surveys is an agent skill from nicepkg/ai-workflow. Use when validating product assumptions before building, discovering unmet user needs, understanding customer problems and workflows, testing concepts or positioning, researching target markets, identifying jobs-to-be-done and hiring triggers, uncovering pain points and workarounds, or when users mention user research, customer interviews, surveys, discovery interviews, validation studies, or voice of customer.

When should I use Discovery Interviews Surveys?

Discovery Interviews Surveys fits situations like: validating product assumptions before building; discovering unmet user needs; understanding customer problems and workflows; testing concepts.

How do I install Discovery Interviews Surveys in Claude Code?

Run `npx skills add nicepkg/ai-workflow --skill discovery-interviews-surveys -a claude-code`. Or copy the skill folder (workflows/product-manager-workflow/.claude/skills/discovery-interviews-surveys in nicepkg/ai-workflow) into .claude/skills/discovery-interviews-surveys in your project. Claude Code loads it when a task matches its description.

How do I install Discovery Interviews Surveys in Codex?

Run `npx skills add nicepkg/ai-workflow --skill discovery-interviews-surveys -a codex`. Or copy the skill folder (workflows/product-manager-workflow/.claude/skills/discovery-interviews-surveys in nicepkg/ai-workflow) into .agents/skills/discovery-interviews-surveys in your project. Codex loads it when a task matches its description.

Can I use Discovery Interviews Surveys 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 nicepkg/ai-workflow --skill discovery-interviews-surveys -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-interviews-surveys, .gemini/skills/discovery-interviews-surveys, .github/skills/discovery-interviews-surveys and .opencode/skills/discovery-interviews-surveys in your project.

What does Discovery Interviews Surveys need to run?

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

Does Discovery Interviews Surveys 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 Interviews Surveys 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 Interviews Surveys use?

Discovery Interviews Surveys 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 Interviews Surveys use?

About 3k tokens (SKILL.md is roughly 12k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Discovery Interviews Surveys?

Skills that share tags, products or a category with Discovery Interviews Surveys: 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, 510 stars) and MITRE Problem Framing Canvas (deanpeters/Product-Manager-Skills, 7.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Discovery Interviews Surveys?

nicepkg (a GitHub organization) maintains it in nicepkg/ai-workflow, which has 285 GitHub stars. The repository holds 61 skills in this directory. The repository was last updated on January 20, 2026.

Source: nicepkg/ai-workflow on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.