problem-statement

Write user-centered problem statements capturing persona, outcome, barrier, root cause, and emotional impact.

Updated Jul 21, 2026
One-click install
npx skills add https://github.com/BrunoL28/product-onboarding-skill --skill problem-statement-brunol28
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: problem-statement
Source: https://github.com/BrunoL28/product-onboarding-skill/tree/main/skills/problem-statement
Command: npx skills add https://github.com/BrunoL28/product-onboarding-skill --skill problem-statement-brunol28

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams often jump to solutions before agreeing on the actual problem, producing requirements docs that smuggle in features, confuse business pain with user pain, or mistake symptoms for root causes. This Skill guides product managers through framing a problem from the user's perspective so the team aligns before anyone proposes a solution. ## Core Features & Use Cases - Structured narrative drafting: Builds the five-line I am / Trying to / But / Because / Which makes me feel narrative, with a dedicated test for each line, including the root-cause check that catches the commonest failure. - Facilitated discovery with collapse rule: Runs a question-budgeted facilitation loop, but collapses to extraction when a proto-persona or research summary already exists upstream, asking only about the missing root cause. - Validation gates and quality checks: Enforces five framing checks (solution smuggling, user-vs-business, root cause, emotion provenance, specificity) plus a read-aloud gate where the pass condition is "yes, exactly" from people who live the problem. - Use Case: A PM at a bank uses the Skill to frame why first-time disputers feel abandoned after reporting fraud, producing a Problem Framing Canvas whose root cause (an ops-only back-office queue) directly shapes the architecture discussion. ## Quick Start Use the problem-statement skill to draft a problem framing canvas for our cardholders who cannot see the status of their fraud disputes.

Frequently Asked Questions about problem-statement

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write a user-centered problem statement for product discovery?▼

Use the five-line narrative structure: I am (persona in a specific moment), Trying to (desired outcome), But (barrier), Because (root cause), Which makes me feel (emotional impact). Then compress it into one sentence: persona needs a way to achieve outcome because root cause, which currently causes impact.

How to tell if a problem statement is actually a solution in disguise?▼

Check whether any line names a feature, screen, or technology, such as "users need a dashboard." If so, ask what outcome that feature was supposed to produce and put the outcome in instead. The skill runs this solution-smuggling test as a formal quality gate.

What is the difference between the But and Because lines in problem framing?▼

The But line states the barrier blocking the outcome; the Because line states the root cause behind that barrier. If both lines say the same thing, you have a symptom twice and no cause, so keep asking why until the answer is a structural fact about the system or organization.

Can I use a problem statement skill when a proto-persona already exists?▼

Yes. When a proto-persona or research summary exists upstream, the skill skips interviewing and extracts the persona, pains, and quotes directly, reporting what was found, inferred, or still missing. It then asks only about the root cause, which persona documents usually lack.

Why do problem statements fail validation even when they read well?▼

Fluent drafts commonly fail on fabricated emotions not found in research, root causes that restate the symptom, and framings generic enough for a competitor's deck. The skill's five framing checks and read-aloud gate with real users exist to catch exactly these failures.