Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
refoundai avatar

Problem Definition

  • 1.8k installs
  • 1.2k repo stars
  • Updated July 16, 2026
  • refoundai/lenny-skills

problem-definition is an agent skill that Help users define problems clearly before jumping to solutions. Use when someone is scoping a new feature, validating a product idea, struggling to articulate what they'r.

About

The problem-definition skill. Help users define problems clearly before jumping to solutions. Use when someone is scoping a new feature, validating a product idea, struggling to articulate what they're building, or falling into the "shiny object trap" with new technology. **Understand the current framing** - Ask how they're currently thinking about the problem 2. **Dig into the struggling moment** - Help them articulate the specific context where users feel stuck 3. **Separate problem from solution** - Ensure they haven't conflated a desired feature with the underlying need 4. **Validate the problem matters** - Help them confirm the problem is urgent and widespread enough to solve ## Core Principles ### Digitizing analog isn't enough Bret Taylor: "Why use this instead of the Yellow Pages?. It was a digital version of something that had come before." Simply digitizing an analog predecessor often fails because it lacks a native reason to exist on the new platform.

  • Understand the current framing - Ask how they're currently thinking about the problem
  • Dig into the struggling moment - Help them articulate the specific context where users feel stuck
  • Separate problem from solution - Ensure they haven't conflated a desired feature with the underlying need
  • Validate the problem matters - Help them confirm the problem is urgent and widespread enough to solve
  • "What is the user doing right before they encounter this problem? What are they trying to accomplish?"

Problem Definition by the numbers

  • 1,805 all-time installs (skills.sh)
  • Ranked #269 of 3,301 Productivity & Planning skills by installs in the Skillselion catalog
  • Security screen: MEDIUM risk (skills.sh audit)
  • Data as of Jul 28, 2026 (Skillselion catalog sync)
At a glance

problem-definition capabilities & compatibility

Capabilities
understand the current framing ask how they're · dig into the struggling moment help them artic · separate problem from solution ensure they hav · validate the problem matters help them confirm · "what is the user doing right before they encoun
Use cases
testing · debugging · ci cd
From the docs

What problem-definition says it does

**Understand the current framing** - Ask how they're currently thinking about the problem 2.
SKILL.md
**Dig into the struggling moment** - Help them articulate the specific context where users feel stuck 3.
SKILL.md
npx skills add https://github.com/refoundai/lenny-skills --skill problem-definition

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs1.8k
repo stars1.2k
Security audit3 / 3 scanners passed
Last updatedJuly 16, 2026
Repositoryrefoundai/lenny-skills

How do I apply problem-definition correctly using the SKILL.md workflows and reference files?

Help users define problems clearly before jumping to solutions. Use when someone is scoping a new feature, validating a product idea, struggling to articulate what they're building, or falling into th

Who is it for?

Developers and software engineers working with problem-definition patterns from the skill documentation.

Skip if: Skip when cached docs are empty, boilerplate-only, or outside the skill documented scope.

When should I use this skill?

Help users define problems clearly before jumping to solutions. Use when someone is scoping a new feature, validating a product idea, struggling to articulate what they're building, or falling into the "shiny object trap

What you get

Grounded problem-definition guidance with highlights, triggers, and evidence quotes from SKILL.md.

  • problem statement drafts
  • interview insight summaries

By the numbers

  • Draws on insights from 91 podcast guests
  • Includes 123 documented guest mentions

Files

SKILL.mdMarkdownGitHub ↗

Problem Definition

Help the user define problems clearly before jumping to solutions using frameworks from 91 product leaders.

How to Help

When the user asks for help with problem definition:

1. Understand the current framing - Ask how they're currently thinking about the problem 2. Dig into the struggling moment - Help them articulate the specific context where users feel stuck 3. Separate problem from solution - Ensure they haven't conflated a desired feature with the underlying need 4. Validate the problem matters - Help them confirm the problem is urgent and widespread enough to solve

Core Principles

Digitizing analog isn't enough

Bret Taylor: "Why use this instead of the Yellow Pages? It was a digital version of something that had come before." Simply digitizing an analog predecessor often fails because it lacks a native reason to exist on the new platform. Ask "why should a customer give this the time of day?"

Prototype to define the problem

Jake Knapp + John Zeratsky: "This idea of getting unstuck and turning maybe some abstract ideas or some concepts that you've been discussing, turning that into a concrete prototype, something that you can look at and you can click around." Moving from abstract concepts to concrete prototypes is the fastest way to define and solve a problem.

Avoid the shiny object trap

Marily Nika: "There is something called the shiny object trap, and I'm always telling people, 'Hey, don't do AI for the sake of doing AI.' Make sure there is a problem there." Ensure AI (or any new technology) is used to solve a specific, validated user pain point rather than for its own sake.

Struggling moments cause demand

Bob Moesta: "A struggling moment causes demand. And you start to realize that in some cases that struggling moment exists and can exist for a long time and nobody solved it." Demand is created by a specific "struggling moment" in a user's life, not by the product itself. Study the context that makes users' behavior rational.

See the end from the beginning

Ryan Singer: "We are not going to start something unless we can see the end from the beginning. We're not going to take a big concept and then say, 'What's the estimate for this thing?'" Ensure the team can visualize the completed feature before committing resources. Avoid starting with fuzzy concepts.

The solution is what customers buy

Marty Cagan: "People don't buy the problem, they buy your solution. Obviously they don't buy it if it's not solving something they care about, but there are many products that are solving what they care about." While understanding the problem is necessary, competitive advantage comes from the quality of the solution. Don't over-rotate on problem validation if the problem is well-understood.

Spend more time on the problem

Christopher Lochhead: "Spend more time on the problem than the solution." Deeply understanding the customer's perspective of the problem is more valuable than internal product brainstorming. Listen to hear their perspective rather than just pitching your solution.

Qualify the problem type

Christopher Miller: "I don't know that we even talk about problems without a qualifier. Are we talking about a business problem? Are we talking about a customer problem?" Effective problem definition requires distinguishing between business needs and customer pain points to avoid "customer-hostile" solutions.

Questions to Help Users

  • "What is the user doing right before they encounter this problem? What are they trying to accomplish?"
  • "Why hasn't this problem been solved already? What makes it hard?"
  • "Is this a business problem or a customer problem? Are they the same?"
  • "If you solved this problem perfectly, how would the user's life be different?"
  • "Can you describe a specific person experiencing this problem in a specific moment?"
  • "What are people doing today to work around this problem?"

Common Mistakes to Flag

  • Solution-first thinking - Starting with a feature idea and working backward to justify it
  • Technology-first thinking - Wanting to use AI/blockchain/etc. and looking for problems to apply it to
  • Abstract problem statements - Defining problems so broadly they don't point to any specific solution
  • Conflating business and customer problems - Solving for internal metrics without addressing user needs
  • Skipping the struggling moment - Not understanding the specific context where pain occurs

Deep Dive

For all 123 insights from 91 guests, see references/guest-insights.md

Related Skills

  • positioning-messaging
  • prioritizing-roadmap
  • scoping-cutting
  • product-taste-intuition

Related skills

How it compares

Use problem-definition for qualitative pain framing; use product-name when the open question is naming, not problem clarity.

FAQ

Who is problem-definition for?

Developers and software engineers working with problem-definition patterns from the skill documentation.

When should I use problem-definition?

Help users define problems clearly before jumping to solutions. Use when someone is scoping a new feature, validating a product idea, struggling to articulate what they're building, or falling into the "shiny object trap" with new technology.

Is problem-definition safe to install?

Review the Security Audits panel on this page before installing in production.

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.