Agent-Skills.md

Agent Skills: Problem Framing Skill

Frame problems using JTBD Job Stories, HMW questions, and persona validation

UncategorizedID: wellapp-ai/well/problem-framing

Repository

wellapp-ai/well
WellApp-aiLicense: MIT
33550

Install this agent skill to your local

pnpm dlx add-skill https://github.com/WellApp-ai/Well/tree/HEAD/cursor-rules/skills/problem-framing

Skill Files

Browse the full folder contents for problem-framing.

Download Skill

Loading file tree…

cursor-rules/skills/problem-framing/SKILL.md

Skill Metadata

Name
problem-framing
Description
Frame problems using JTBD Job Stories, HMW questions, and persona validation

Problem Framing Skill

Frame problems effectively using Jobs-to-be-Done, How Might We questions, and persona validation from Notion.

When to Use

  • At the start of DIVERGE loop (Ask mode)
  • When exploring a new feature or problem space
  • Before ideation to ensure clear problem definition

Instructions

Phase 1: Job Story Definition

Create a Job Story in this format:

When [situation/context],
I want to [motivation/action],
So I can [expected outcome/benefit].

Example:

When I'm managing multiple client workspaces,
I want to switch between them quickly,
So I can respond to urgent requests without losing context.

Phase 2: How Might We (HMW) Question

Reframe the problem as an opportunity question:

How might we [opportunity that addresses the job story]?

Guidelines:

  • Start broad, then narrow if needed
  • Avoid suggesting solutions in the question
  • Focus on the user's goal, not the feature

Example:

How might we help users navigate between workspaces seamlessly?

Phase 3: Persona Lookup (Notion MCP)

Fetch relevant personas from Notion database:

  1. Search for personas database:

    API-post-search with query "Personas" or "User Personas"

  2. Query the database:

    API-query-data-source with database_id from search results

  3. Get persona details:

    API-retrieve-a-page + API-get-block-children for each relevant persona

Extract these fields:

  • Name
  • Role / Job Title
  • Goals (what they want to achieve)
  • Pain Points (what frustrates them)
  • Context (environment, constraints)

Phase 4: Three Dimensions Check

Validate the problem addresses all three job dimensions:

| Dimension | Question | Example | |-----------|----------|---------| | Functional | What task are they completing? | "Switch between workspaces" | | Emotional | How do they want to feel? | "In control, not overwhelmed" | | Social | How do they want to be perceived? | "Responsive, professional" |

Output Format

After running this skill, output:

## Problem Framing

### Job Story
When [situation],
I want to [motivation],
So I can [outcome].

### How Might We
How might we [opportunity]?

### Relevant Personas

| Persona | Role | Goals | Pain Points |
|---------|------|-------|-------------|
| [Name] | [Role] | [Goals] | [Pain Points] |

### Three Dimensions

| Dimension | Definition |
|-----------|------------|
| Functional | [Task] |
| Emotional | [Feeling] |
| Social | [Perception] |

Invocation

Invoke manually with "use problem-framing skill" or follow Ask mode DIVERGE loop which references this skill's phases.

Related Skills

  • design-context - Run after problem-framing
  • competitor-scan - Research how others solve this problem