problem-statement

Write a user-centered problem statement with who is blocked, what they are trying to do, why it matters, and how it feels. Use when framing discovery, prioritization, or a PRD.

3,144 stars

Best use case

problem-statement is best used when you need a repeatable AI agent workflow instead of a one-off prompt. It is especially useful for teams working in multi. Write a user-centered problem statement with who is blocked, what they are trying to do, why it matters, and how it feels. Use when framing discovery, prioritization, or a PRD.

Write a user-centered problem statement with who is blocked, what they are trying to do, why it matters, and how it feels. Use when framing discovery, prioritization, or a PRD.

Users should expect a more consistent workflow output, faster repeated execution, and less time spent rewriting prompts from scratch.

Practical example

Example input

Use the "problem-statement" skill to help with this workflow task. Context: Write a user-centered problem statement with who is blocked, what they are trying to do, why it matters, and how it feels. Use when framing discovery, prioritization, or a PRD.

Example output

A structured workflow result with clearer steps, more consistent formatting, and an output that is easier to reuse in the next run.

When to use this skill

  • Use this skill when you want a reusable workflow rather than writing the same prompt again and again.

When not to use this skill

  • Do not use this when you only need a one-off answer and do not need a reusable workflow.
  • Do not use it if you cannot install or maintain the related files, repository context, or supporting tools.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/problem-statement/SKILL.md --create-dirs "https://raw.githubusercontent.com/deanpeters/Product-Manager-Skills/main/skills/problem-statement/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/problem-statement/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How problem-statement Compares

Feature / Agentproblem-statementStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Write a user-centered problem statement with who is blocked, what they are trying to do, why it matters, and how it feels. Use when framing discovery, prioritization, or a PRD.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

Related Guides

SKILL.md Source

## Purpose
Articulate a problem from the user's perspective using an empathy-driven framework that captures who they are, what they're trying to do, what's blocking them, why, and how it makes them feel. Use this to align stakeholders on the problem before jumping to solutions, and to frame product work around user outcomes rather than feature requests.

This is not a requirements doc—it's a human-centered problem narrative that ensures you're solving a problem worth solving.

## Key Concepts

### The Problem Framing Framework
Based on Jobs-to-be-Done and empathy mapping, the framework structures problems as:

**Problem Framing Narrative:**
- **I am:** [Describe the persona experiencing the problem]
- **Trying to:** [Desired outcomes the persona cares about]
- **But:** [Barriers preventing the outcomes]
- **Because:** [Root cause of the problem]
- **Which makes me feel:** [Emotional impact]

**Context & Constraints:**
- [Geographic, technological, time-based, demographic factors]

**Final Problem Statement:**
- [Single, concise, empathetic summary]

### Why This Structure Works
- **Persona-centric:** Forces you to see the problem through the user's eyes
- **Outcome-focused:** "Trying to" emphasizes desired results, not tasks
- **Root cause analysis:** "Because" pushes past symptoms to underlying issues
- **Emotional validation:** "Makes me feel" humanizes the problem and builds empathy
- **Contextual:** Constraints acknowledge real-world limitations

### Anti-Patterns (What This Is NOT)
- **Not a solution in disguise:** "The problem is we lack AI-powered analytics" = sneaking in a solution
- **Not a business problem:** "Our revenue is down" isn't a user problem (it's a symptom)
- **Not a feature request:** "Users need a dashboard" isn't a problem (what are they trying to do?)
- **Not generic:** "Users want better UX" is too vague to be actionable

### When to Use This
- Kicking off discovery or problem validation work
- Aligning stakeholders before solutioning
- Socializing a problem with engineering, design, or exec teams
- When you have feature requests but unclear underlying problems
- Pitching why a problem is worth solving

### When NOT to Use This
- When you haven't done any user research yet (don't guess—interview first)
- For internal operational problems (this is for user-facing problems)
- As a substitute for a PRD (this frames the problem; PRD defines the solution)

---

## Application

Use `template.md` for the full fill-in structure.

### Step 1: Gather User Context
Before drafting, ensure you have:
- **User interviews or research:** Direct quotes, observed behaviors, pain points
- **Jobs-to-be-Done insights:** What users are "hiring" your product to do (reference `skills/jobs-to-be-done/SKILL.md`)
- **Persona clarity:** Who specifically experiences this problem (reference `skills/proto-persona/SKILL.md`)
- **Constraints data:** Geographic, tech, time, demographic limitations

**If missing context:** Run discovery interviews, contextual inquiries, or user shadowing. Don't fabricate problems.

---

### Step 2: Draft the Problem Framing Narrative

Fill in the template from the persona's point of view:

```markdown
## Problem Framing Narrative

**I am:** [Describe the key persona, highlighting 3-4 key characteristics]
- [Key pain point or characteristic 1]
- [Key pain point or characteristic 2]
- [Key pain point or characteristic 3]

**Trying to:**
- [Single sentence listing the desired outcomes the persona cares most about]

**But:**
- [Describe the barriers preventing the persona from achieving outcomes]
- [Job-to-be-done or outcome obstruction 1]
- [Job-to-be-done or outcome obstruction 2]
- [Job-to-be-done or outcome obstruction 3]

**Because:**
- [Describe the root cause empathetically]

**Which makes me feel:**
- [Describe the emotions from the persona's perspective]
```

**Quality checks:**
- **"I am" specificity:** Can you picture this person? Or is it generic ("busy professionals")?
- **"Trying to" clarity:** Is this an outcome (measurable) or a task (activity)?
- **"But" depth:** Are these real barriers or just inconveniences?
- **"Because" honesty:** Is this the root cause or just a symptom?
- **"Makes me feel" authenticity:** Do these emotions come from research or assumptions?

---

### Step 3: Document Context & Constraints

```markdown
## Context & Constraints

- [Enumerate geographic, technological, time-based, or demographic factors]
- [e.g., "Must work offline in rural areas with limited connectivity"]
- [e.g., "Used by non-technical users unfamiliar with complex software"]
- [e.g., "Time-sensitive: decisions must be made within 24 hours"]
```

**Quality checks:**
- **Relevance:** Do these constraints directly impact the problem?
- **Specificity:** Are they concrete enough to inform design decisions?

---

### Step 4: Craft the Final Problem Statement

Synthesize the narrative into one powerful sentence:

```markdown
## Final Problem Statement

[Single, concise statement that provides a powerful and empathetic summary]
```

**Formula:** `[Persona] needs a way to [desired outcome] because [root cause], which currently [emotional/practical impact].`

**Example:** "Enterprise IT admins need a way to provision user accounts in under 5 minutes because current processes take 2+ hours with manual approvals, which causes project delays and frustrated end-users."

**Quality checks:**
- **One sentence:** If it requires multiple sentences, the problem isn't crisp yet
- **Measurable:** Can you tell if you've solved it?
- **Empathetic:** Does it resonate emotionally?
- **Shareable:** Could you say this in a meeting and have stakeholders nod?

---

### Step 5: Validate and Socialize

- **Test with users:** Read it aloud to people who experience the problem. Do they say "Yes, exactly!"?
- **Share with stakeholders:** Product, engineering, design, exec. Does it align everyone?
- **Iterate based on feedback:** If anyone says "I don't think that's the real problem," dig deeper.

---

## Examples

See `examples/sample.md` for full examples (good and bad problem statements).

Mini example excerpt:

```markdown
**I am:** A software developer on a distributed team
**Trying to:** Communicate in real-time with my team without losing context
**But:** Email is too slow and IM is ephemeral
**Because:** No tool combines real-time chat with searchable history
**Which makes me feel:** Frustrated and disconnected
```

---

## Common Pitfalls

### Pitfall 1: Solution Smuggling
**Symptom:** "The problem is we don't have [specific feature]"

**Consequence:** You've predetermined the solution without validating the problem.

**Fix:** Reframe around the user's desired outcome, not the feature. Ask "What are they trying to achieve?"

---

### Pitfall 2: Business Problem Disguised as User Problem
**Symptom:** "Users want to increase our revenue" or "The problem is our churn rate"

**Consequence:** These are company problems, not user problems. Users don't care about your metrics.

**Fix:** Dig into *why* users churn or *what* would make them spend more. Frame it from their perspective.

---

### Pitfall 3: Generic Personas
**Symptom:** "I am a busy professional trying to be more productive"

**Consequence:** Too broad to be actionable. Every product claims to help "busy professionals."

**Fix:** Get specific. "I am a sales rep managing 50+ leads manually in spreadsheets, trying to prioritize follow-ups without missing high-value opportunities."

---

### Pitfall 4: Symptom Instead of Root Cause
**Symptom:** "Because the UI is confusing"

**Consequence:** You're describing a symptom, not the underlying issue.

**Fix:** Ask "Why is the UI confusing?" Keep asking "why" until you hit the root cause (e.g., "Because users have no mental model for how the system works").

---

### Pitfall 5: Fabricated Emotions
**Symptom:** "Which makes me feel empowered and delighted"

**Consequence:** These sound like marketing copy, not real user emotions.

**Fix:** Use actual quotes from user interviews. Real emotions: "frustrated," "overwhelmed," "anxious," "stuck."

---

## References

### Related Skills
- `skills/jobs-to-be-done/SKILL.md` — Informs the "Trying to" and "But" sections
- `skills/proto-persona/SKILL.md` — Defines the "I am" persona
- `skills/positioning-statement/SKILL.md` — Problem statement informs positioning
- `skills/user-story/SKILL.md` — Problem statement guides story prioritization

### External Frameworks
- Clayton Christensen, *Jobs to Be Done* — Origin of outcome-focused problem framing
- Osterwalder & Pigneur, *Value Proposition Canvas* — Customer pains/gains/jobs
- Dave Gray, *Empathy Mapping* — Emotional framing techniques

### Dean's Work
- [Link to relevant Dean Peters' Substack articles if applicable]

### Provenance
- Adapted from `prompts/framing-the-problem-statement.md` in the `https://github.com/deanpeters/product-manager-prompts` repo.

---

**Skill type:** Component
**Suggested filename:** `problem-statement.md`
**Suggested placement:** `/skills/components/`
**Dependencies:** References `skills/jobs-to-be-done/SKILL.md`, `skills/proto-persona/SKILL.md`

Related Skills

problem-framing-canvas

3144
from deanpeters/Product-Manager-Skills

Guide teams through MITRE's Problem Framing Canvas. Use when you need a clearer problem statement before jumping to solutions.

positioning-statement

3144
from deanpeters/Product-Manager-Skills

Create a Geoffrey Moore-style positioning statement. Use when clarifying who you serve, what problem you solve, your category, and why you're different from alternatives.

workshop-facilitation

3144
from deanpeters/Product-Manager-Skills

Facilitate workshop sessions in a one-step, multi-turn flow. Use when an interactive skill needs consistent pacing, options, and progress tracking.

vp-cpo-readiness-advisor

3144
from deanpeters/Product-Manager-Skills

Guide the transition to VP or CPO across preparing, interviewing, landing, and recalibrating. Use when executive product scope is changing fast.

user-story

3144
from deanpeters/Product-Manager-Skills

Create user stories with Mike Cohn format and Gherkin acceptance criteria. Use when turning user needs into development-ready work with clear outcomes and testable conditions.

user-story-splitting

3144
from deanpeters/Product-Manager-Skills

Break a large story or epic into smaller deliverable stories using proven split patterns. Use when backlog items are too big for estimation, sequencing, or independent release.

user-story-mapping

3144
from deanpeters/Product-Manager-Skills

Create a user story map that lays out activities, steps, tasks, and release slices. Use when planning a workflow, backlog, or MVP around the user journey.

user-story-mapping-workshop

3144
from deanpeters/Product-Manager-Skills

Run a user story mapping workshop with adaptive questions and a structured map output. Use when you need backbone activities, tasks, and release slices for a workflow.

tam-sam-som-calculator

3144
from deanpeters/Product-Manager-Skills

Calculate TAM, SAM, and SOM with explicit assumptions, methods, and caveats. Use when sizing a market for a product idea, business case, or executive review.

storyboard

3144
from deanpeters/Product-Manager-Skills

Create a six-frame storyboard that shows a user's journey from problem to solution. Use when you need a fast narrative for alignment, concept reviews, or demos.

skill-authoring-workflow

3144
from deanpeters/Product-Manager-Skills

Turn raw PM content into a compliant, publish-ready skill. Use when creating or updating a repo skill without breaking standards.

saas-revenue-growth-metrics

3144
from deanpeters/Product-Manager-Skills

Calculate SaaS revenue, retention, and growth metrics. Use when diagnosing momentum, churn, expansion, or product-market-fit signals.