How-to · Product Management · By Dean Peters (PM)

How to use Problem Statement Framework in your AI agent

Install and use the Problem Statement Framework skill in Claude Code, Cursor, Codex, Gemini CLI, OpenCode, and Windsurf — with sample prompts.

What you'll get

This skill helps product managers, founders, and team leads write user-centered problem statements that capture who is affected, what they're trying to do, what's blocking them, and how it feels. It uses a structured framework to align stakeholders on the real problem before anyone proposes a solution. The result is a crisp, one-sentence problem statement backed by empathy and evidence.

Step 1 — Get the skill source URL

The Problem Statement Framework skill lives at:

Step 2 — Add it to your AI agent

Copy one of these prompts and paste it into your AI tool. The agent will fetch and install the skill for you.

Claude Code

Add the agent skill from https://github.com/deanpeters/Product-Manager-Skills/tree/main/skills/problem-statement to my project.

Cursor

Install this agent skill: https://github.com/deanpeters/Product-Manager-Skills/tree/main/skills/problem-statement

Codex

Add this skill to .codex/skills/: https://github.com/deanpeters/Product-Manager-Skills/tree/main/skills/problem-statement

Gemini CLI

Add the skill at https://github.com/deanpeters/Product-Manager-Skills/tree/main/skills/problem-statement to my .gemini/skills/ directory.

OpenCode

Install this agent skill from https://github.com/deanpeters/Product-Manager-Skills/tree/main/skills/problem-statement

Windsurf

Add this skill: https://github.com/deanpeters/Product-Manager-Skills/tree/main/skills/problem-statement

Step 3 — Try these prompts

Once the skill is installed, ask your AI things like:

  • Kicking off discovery or user research and need to align the team on what problem you're solving
  • Stakeholders are pushing for features but no one has articulated the underlying user problem
  • Pitch why a problem is worth solving to engineering, design, or executives
  • Writing a PRD and want to start with a rock-solid problem definition

What this skill does

  • Guides you through a five-part narrative: who the user is, what they're trying to do, what's blocking them, why, and how it makes them feel
  • Produces a single-sentence problem statement that teams can rally around
  • Helps you avoid solution smuggling and ensures you're solving a problem worth solving
  • Provides quality checks and examples to validate your problem framing with real users
Made byDean Peters (PM)
CategoryProduct Management