Claude Marketplaces
SkillsMCP serversMarketplacesDigestTools
Submit

This week in Claude

Every Monday: Claude Code, Agent SDK, MCP, and the Anthropic platform moves worth your time.

Skills by category
Frontend DevelopmentBackend & APIsTesting & QASecurityDevOps & CI/CDGit & Pull RequestsDocumentationCode Review & QualityAI & Agent BuildingSkill Development
MCP servers by category
Sales & MarketingWeb & Browser AutomationDatabasesAI & LLM ToolsCloud & InfrastructureCommunication & MessagingDeveloper ToolsDesign & CreativeDocuments & KnowledgeSearch & Web Crawling
Marketplaces by category
AI Agents & OrchestrationLLM IntegrationDevelopment ToolsFrontend & UIBackend & APIsDatabasesTesting & Code QualityDevOps & CloudSecurity & ComplianceGit & Version Control
Claude Marketplaces

An independent directory of skills, plugins and MCP servers for Claude Code. Not affiliated with Anthropic.

Browse

  • Skills
  • MCP servers
  • Marketplaces
  • Weekly digest
  • Skill index
  • MCP index
  • Marketplace index

Site

  • About
  • Tools
  • Submit
  • Feedback
  • Privacy
  • llms.txt
  • Plugins reference

Maker

  • Snug
  • Agent Caffeine
  • knobs
  • Wax
  • Vectoys
  • mertduzgun.com
Crafted at
Skills/Productivity & Planning
deanpeters avatar

Problem Statement

deanpeters/product-manager-skills

This is for when someone drops a feature request in your lap and you need to back up and figure out what problem you're actually solving. It walks you through a structured framework: who's blocked, what they're trying to do, what's stopping them, the root cause, and how it feels. The output is a one-sentence problem statement you can share with stakeholders before anyone starts building. It's heavy on the Jobs-to-be-Done angle and explicitly calls out anti-patterns like solution smuggling and generic personas. Use it to align teams during discovery or when kicking off a PRD, but only after you've done actual user research, not as a way to dress up assumptions.

installs
2.6K
GitHub stars
7.7K
last updated
Aug 21, 2026
View on GitHubSave

Install

$ npx -y skills add deanpeters/product-manager-skills --skill problem-statement --agent claude-code

Installs into .claude/skills of the current project.

Files

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.

Input

Works best with: Who the user is and what they're struggling to do. Also useful: What's blocking them, why it matters, how it feels, and supporting evidence.

Anything supplied with the invocation itself — text after the skill name, a pasted context dump, or an appended ARGUMENTS: line — counts as answers already given. Use it and skip whatever it covers; don't re-ask.

Arriving empty-handed? That works too. The skill asks for the user and their goal first — a problem statement without a specific 'who' is a solution looking for cover.

Example invocation: Problem statement: clinic schedulers double-book exam rooms because the calendar doesn't show equipment availability.

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:

## 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

## 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:

## 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:

**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

SKILL.md on GitHub

Sponsors

SnugThe clipboard manager you and your agent can use, safelyAgent CaffeineClose your lid, come back to finished workWaxBlock anything with supervision, without erasing your iPhoneOpen StepsSponsoredFree and open-source skills that make AI coding agents easier to understand, verify, and control.

Details

Repository
github.com/deanpeters/product-manager-skills
Categories
Productivity & Planning, Sales & Marketing
First seen
Apr 16, 2026

More from deanpeters/product-manager-skills

All 49
  • Eol Message2.6K
  • Director Readiness Advisor2.6K
  • Executive Onboarding Playbook2.6K
  • Positioning Statement2.5K
  • Storyboard2.5K
  • User Story Splitting2.5K
  • Positioning Workshop2.5K
  • Pestel Analysis2.5K
  • Press Release2.4K
  • Pol Probe2.4K
  • Pol Probe Advisor2.4K
  • Saas Revenue Growth Metrics2.4K
  • Workshop Facilitation2.3K
  • Proto Persona2.3K
  • Saas Economics Efficiency Metrics2.3K
  • Tam Sam Som Calculator2.3K
  • User Story Mapping Workshop2.2K
  • Recommendation Canvas2.1K
  • Skill Authoring Workflow2.1K
  • Vp Cpo Readiness Advisor2K
  • Product Sense Interview Answer1.7K
  • Organic Growth Advisor1.5K
  • Pm Skill Creator1.4K
  • Prd Development4.7K

Recommended

More Productivity & Planning
1agricidaniel avatarblog-briefagricidaniel/claude-blogGenerate detailed content briefs for blog posts with target keywords, content outlines, competitive analysis, recommended statistics, image and chart suggestion2.6Kinstalls
2posthog avatarimplementing-agent-modesposthog/posthogGuidelines to create/update a new mode for PostHog AI agent. Modes are a way to limit what tools, prompts, and prompt injections are applied and under what cond2.6Kinstalls
3refoundai avataranalyzing-user-feedbackrefoundai/lenny-skillsHelp users convert massive volumes of qualitative and quantitative feedback into high-confidence product decisions through rigorous synthesis and internal immer2.6Kinstalls
4pydantic avatarpydantic-ai-harnesspydantic/skillsExtend Pydantic AI agents with batteries-included capabilities from pydantic-ai-harness -- Code Mode (collapse many tool calls into one sandboxed Python executi2.6Kinstalls
5deanpeters avatareol-messagedeanpeters/product-manager-skillsWrite a clear, empathetic EOL announcement with rationale, customer impact, and next steps. Use when retiring a product, feature, or plan without creating avoid2.6Kinstalls
6eronred avatarapp-launcheronred/aso-skillsWhen the user wants to plan a launch strategy for a new app or major update. Also use when the user mentions "app launch", "launch plan", "launch checklist", "p2.6Kinstalls