problem-statement SKILL.md skillA

problem-statement from deanpeters/product-manager-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add deanpeters/product-manager-skills/problem-statement@git:20260810.b68bf96

Pins git:20260810.b68bf96 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
deanpeters/product-manager-skills
Path
skills/problem-statement/SKILL.md
Versions recorded
5
Latest version
git:20260810.b68bf96, committed Aug 10, 2026
First version recorded
Feb 5, 2026
Size
10,949 bytes
Repository stars
7,599
License
a license file GitHub does not identify

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.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

## 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.`
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add deanpeters/product-manager-skills/problem-statement@sha256:bd55dc2c0c1cca2c

The line at the top of this page pins the label git:20260810.b68bf96, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_crlkhx5ydshunm5j.svg)](https://markdownregistry.com/a/art_crlkhx5ydshunm5j)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Feb 5, 2026 and Aug 10, 2026, about one every 46 days.

versioncommittedcommitsizeaudit
git:20260810.b68bf96 latest2026-08-10 b68bf96 10,949 BA view · diff
git:20260704.6a4fbf22026-07-04 6a4fbf2 10,513 BA view · diff
git:20260309.0a8f6ac2026-03-09 0a8f6ac 9,753 BA view · diff
git:20260205.5d8ce732026-02-05 5d8ce73 9,419 BA view · diff
git:20260205.0bbbae72026-02-05 0bbbae7 11,478 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (10949 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

deanpeters/product-manager-skills · 7,599 stars · license a license file GitHub does not identify · pushed 2026-10-16 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_crlkhx5ydshunm5j
GET https://markdownregistry.com/api/v1/resolve?ref=deanpeters/product-manager-skills/problem-statement
GET https://markdownregistry.com/api/v1/blob/bd55dc2c0c1cca2c1d0bf4da874667d5e256700759aa2f18b72835314cbe9ec1

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from deanpeters/product-manager-skills

AGENTS.md AGENTS.md file
deanpeters/product-manager-skills · AGENTS.md
git:20260901.1b5a524 · audit A · 7,599 stars
CLAUDE.md CLAUDE.md file
deanpeters/product-manager-skills · CLAUDE.md
git:20260810.c430baa · audit A · 7,599 stars
acquisition-channel-advisor SKILL.md skill
deanpeters/product-manager-skills · skills/acquisition-channel-advisor/SKILL.md · Evaluate acquisition channels using unit economics, customer quality, and scalability. Use when deciding whether to…
git:20260810.b68bf96 · audit A · 7,599 stars
agent-orchestration-advisor SKILL.md skill
deanpeters/product-manager-skills · skills/agent-orchestration-advisor/SKILL.md · Design multi-agent AI workflows with clear boundaries, handoffs, and monitoring. Use when a complex PM task should run…
git:20260704.6a4fbf2 · audit A · 7,599 stars
ai-shaped-readiness-advisor SKILL.md skill
deanpeters/product-manager-skills · skills/ai-shaped-readiness-advisor/SKILL.md · Assess whether your product work is AI-first or AI-shaped. Use when evaluating AI maturity and choosing the next team…
git:20260704.6a4fbf2 · audit A · 7,599 stars
altitude-horizon-framework SKILL.md skill
deanpeters/product-manager-skills · skills/altitude-horizon-framework/SKILL.md · Understand the PM-to-Director transition through altitude and horizon thinking. Use when diagnosing scope…
git:20260704.6a4fbf2 · audit A · 7,599 stars
ansoff-matrix SKILL.md skill
deanpeters/product-manager-skills · skills/ansoff-matrix/SKILL.md · Map evidence-backed growth options across the Ansoff Matrix with risk-rated sequencing. Use when the question is where…
git:20260717.eb7a51e · audit A · 7,599 stars
autonomous-investigation SKILL.md skill
deanpeters/product-manager-skills · skills/autonomous-investigation/SKILL.md · The protocol behind every investigation skill. Use when AI research must proceed without you: search-plan gate…
git:20260717.eb7a51e · audit A · 7,599 stars
battle-card-builder SKILL.md skill
deanpeters/product-manager-skills · skills/battle-card-builder/SKILL.md · Research and draft a competitive battle card from public evidence — every claim labeled and sourced. Use when a rep…
git:20260717.eb7a51e · audit A · 7,599 stars
business-health-diagnostic SKILL.md skill
deanpeters/product-manager-skills · skills/business-health-diagnostic/SKILL.md · Diagnose SaaS business health across growth, retention, efficiency, and capital. Use when preparing a business review…
git:20260704.6a4fbf2 · audit A · 7,599 stars
company-intel SKILL.md skill
deanpeters/product-manager-skills · skills/company-intel/SKILL.md · Research a company, industry, or competitor set using web search and seven analytical lenses. Use when you need…
git:20260810.b68bf96 · audit A · 7,599 stars
company-research SKILL.md skill
deanpeters/product-manager-skills · skills/company-research/SKILL.md · Create a company research brief with executive quotes, product strategy, and org context. Use when preparing for…
git:20260810.b68bf96 · audit A · 7,599 stars

Every file in deanpeters/product-manager-skills

Other files named problem-statement

problem-statement SKILL.md skill
ninjasln-labs/agent-skills · problem-statement/SKILL.md · Write a user-centered problem statement with who is blocked, what they are trying to do, why it matters, and how it…
v1.1.0 · audit A · 3 stars

Browse by kind, by grade A, or by owner.