problem-discovery
Skill0 starsChanged 4 months agoMITView on GitHub
Understand WHO has the problem and their world before designing solutions — Customer Persona, Problem Statement (mad-lib format), Empathy Map (Dave Gray), and Customer Ecosystem & Workflow mapping. Use early in validation, whenever the target customer is fuzzy, or when a founder describes their solution but can't crisply describe the person suffering the problem.
4 other projects use a version of this, 1 of them edited.
Adopted by
Most recently taken up by
- kinhluan/skillstheir own version, first seen Nov 8, 2026
- ajstars1/founder-stackedited, first seen Oct 25, 2026
- drv3nkman/business-problem-toolkittheir own version, first seen Oct 20, 2026
- SanketSapkal/founder-skillstheir own version, first seen Apr 30, 2026
Other versions4 projects use a version of this.
Word for word · 0
None found.
Edited · 1
- ajstars1/founder-stack★ 194% same
Wrote their own version · 3
- SanketSapkal/founder-skills★ 10same name
- kinhluan/skills★ 6same name
- drv3nkman/business-problem-toolkit★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository10 other files it gives its agents.
- business-model-canvasSkill
- customer-discoverySkill
- experimentsSkill
- facts-assumptions-unknownsSkill
- jtbdSkill
- secondary-researchSkill
- startup-coachSkill
- startup-scorecardSkill
- value-proposition-canvasSkill
- where-to-playSkill
The file
We split this skill into the rules it gives an agent
3 rules. 0 are common, 3 are distinctive, and 0 are very specific to this project.
0
Common
Most of the 4 edited versions we read keep these.
3
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 12
Consider 2+ candidate archetypes first.
- Distinctive: line 28
Add: who else is affected if this continues, and who will pay for a solution (user ≠ buyer, often).
- Distinctive: line 37
Ecosystem map: every entity around the customer — users, buyers, influencers, saboteurs, suppliers, channels, regulators, payment methods.
“Common” is measured: kept by at least 6 in 10 of the 4 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Problem Discovery — Persona, Problem Statement, Empathy Map, Ecosystem & Workflow
Four tools, run together (they feed each other), all producing labeled hypothesis drafts to be destroyed or confirmed by real interviews. Everything drafted pre-interview is [ASSUMPTION] by definition.
1. Customer Persona (provisional, pre-discovery)
Consider 2+ candidate archetypes first; pick a primary with justification, keep the runner-up listed. Then fill:
- Name (fictional, for role-playing — label it so)
- Description — demographics, goals, needs
- Key problems/needs your idea aims to solve
- Current solutions available to them (real, findable ones)
- Desired outcomes — what success looks like for them (must eventually come from their mouth, not yours)
Rebuild the persona from real quotes after interviews. Watch for the early-adopter tell: the person with the most acute version of the problem (per Talking to Humans) often isn't the "average" customer — real interviews frequently reveal a sharper archetype than the founder's initial guess.
2. Problem Statement — use this exact mad-lib
When
<context>occurs,<customer>struggles with<problem>. Because of this, they feel<emotional response>and experience<quantifiable/practical impact>. Currently, they use<alternative solutions>despite<alternative shortcomings>.
Quality bars:
<quantifiable impact>must be a number with a source, or written as[UNKNOWN — measure via interviews]. Never invent it.<alternatives>must be real. "We have no competitors" is almost always false — customers are doing something today (a shop visit, a spreadsheet, a workaround, postponing). The status quo is the real competitor.- Add: who else is affected if this continues, and who will pay for a solution (user ≠ buyer, often).
- Honest check: if you have negative-space evidence (a silent launch, low signups), state what it does and doesn't imply — "no felt pain" vs "offer never reached them" are different diagnoses.
3. Empathy Map (Dave Gray, XPLANE — gamestorming.com)
Quadrants: Says / Thinks / Does / Feels, plus Pains and Gains. Pre-interview: fill "Says" with things to listen for — never invented quotes. Post-interview: replace with verbatim customer language. Rank pains/gains WITH customers, not for them.
4. Ecosystem Map + Customer Workflow
- Ecosystem map: every entity around the customer — users, buyers, influencers, saboteurs, suppliers, channels, regulators, payment methods. Mark the critical roles in the purchase, consumption, and payment decisions. Identify the possible saboteur (whoever loses if you win — often the incumbent relationship).
- Customer workflow: the step-by-step process the customer follows TODAY, without your product — where time, money, and frustration occur, and where your solution would slot in. Draw today's workflow, not the imagined future one.
- The bundling check: friction that looks separable often isn't (e.g., if two errands always happen in one trip, removing one saves less than it appears). Find which steps are truly independent before valuing their removal.
- Quantify frictions as
[ASSUMPTION → measure]: steps, trips, minutes, delay rates, rework rates.
Output
Persona + problem statement + empathy map + ecosystem/workflow (mermaid diagrams welcome), every field labeled [FACT/ASSUMPTION/UNKNOWN], ending with the 5 highest-value interview questions this analysis raises — the goal of these drafts is to be proven wrong cheaply. Hand those questions to /customer-discovery.
Credits: Empathy Map — Dave Gray (XPLANE). Persona/problem-statement/workflow structures as practiced in evidence-first incubation programs; customer archetype discipline — Steve Blank.
Ledger discipline (v2): reference Belief Ledger IDs ([A4], [F7]) for every claim; propose new/changed items in a closing "Ledger delta" section rather than restating claims — restated claims drift.
Fill-in templates: TEMPLATES.md in this skill's folder — copy the structures into your project's discovery/ and fill with labels.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

