Skip to content
cccskills
FreePublished on GitHub

problem-framing

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

The English summary is being prepared. Showing the original description.

Works withNotion
See how to install

Files included (1)

  • SKILL.md2.9 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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:

DimensionQuestionExample
FunctionalWhat task are they completing?"Switch between workspaces"
EmotionalHow do they want to feel?"In control, not overwhelmed"
SocialHow 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

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Produce an accounts-receivable aging report and surface overdue invoices for a Well workspace. Use when the user asks who owes them money, an AR aging report, overdue invoices, days sales outstanding (DSO), or which customers to chase.

The English summary is being prepared. Showing the original description.

WellApp-ai/Well345Updated Oct 15, 2026

Iterate until success or limit, composing existing skills with Jidoka integration

The English summary is being prepared. Showing the original description.

WellApp-ai/Well345Updated Oct 15, 2026

Build a balance sheet (bilan) from a Well workspace. Use when the user asks for a balance sheet, bilan, assets/liabilities/equity, or financial position at a point in time.

The English summary is being prepared. Showing the original description.

WellApp-ai/Well345Updated Oct 15, 2026

Generate and maintain BPMN 2.0 diagrams linked to Gherkin scenarios

The English summary is being prepared. Showing the original description.

WellApp-ai/Well345Updated Oct 15, 2026

Forecast cash flow and runway for a Well workspace from booked invoices and collected bank transactions. Use when the user asks for a cash-flow forecast, runway, how long until they run out of cash, projected balance, or expected inflows/outflows.

The English summary is being prepared. Showing the original description.

WellApp-ai/Well345Updated Oct 15, 2026

Review code changes against hard rules and conventions

The English summary is being prepared. Showing the original description.

WellApp-ai/Well345Updated Oct 15, 2026

See all skills by WellApp-ai

Report a problem with this skill