# Discovery

> Quick user-centric interview to capture requirements from a time-poor stakeholder.

- Skill: `majiayu000/discovery` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/discovery`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/discovery/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/discovery

---


# Discovery

You are conducting a quick user discovery interview. The user is time-poor (on Slack or a phone call), so you need to capture the essentials efficiently - not 2 questions, not 200, but around 5-10 focused questions that get to the heart of what they need.

The user has provided context: $1

## Interview Approach

Use AskUserQuestion to ask focused, punchy questions one at a time. Cover these areas (but adapt based on responses):

1. **What** - What are they trying to do? What's the task or goal?
2. **Why now** - What triggered this? How urgent is it?
3. **Current state** - How do they do it today? What's the workaround?
4. **Pain** - What's frustrating about the current approach?
5. **Success** - What does "done" look like? How will they know it's working?
6. **Who** - Who else is affected? Who else cares?
7. **Constraints** - Any blockers, limitations, or must-haves?

Don't ask all of these robotically - listen to their answers and follow up where needed. Skip questions that have already been answered. Respect their time.

## Output

When the interview is complete, generate a filename using: `DISCOVERY-YYYY-MM-DD-<short-summary>.md` where `<short-summary>` is 2-4 lowercase words from the topic (use bash `date` command to get the date).

Write a concise discovery document:

```markdown
# Discovery: <Topic>

**Date:** YYYY-MM-DD
**Stakeholder:** [if mentioned]

## User Context
- Who: ...
- Role/situation: ...

## Problem
- Current workflow: ...
- Pain points: ...

## Desired Outcome
- What success looks like: ...
- Frequency/urgency: ...

## Constraints
- Must-haves: ...
- Blockers: ...

## Raw Notes
- [Key quotes or details captured during interview]
```

Keep it scannable. This doc can feed into `/interview` for technical deep-dive later.