problem-framing
Frame problems using JTBD Job Stories, HMW questions, and persona validation
Install
mkdir -p .claude/skills/problem-framing && curl -L -o skill.zip "https://mcp.directory/api/skills/download/5102" && unzip -o skill.zip -d .claude/skills/problem-framing && rm skill.zipInstalls to .claude/skills/problem-framing
About this skill
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:
-
Search for personas database:
API-post-search with query "Personas" or "User Personas" -
Query the database:
API-query-data-source with database_id from search results -
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-framingcompetitor-scan- Research how others solve this problem
More by WellApp-ai
View all skills by WellApp-ai →You might also like
flutter-development
aj-geddes
Build beautiful cross-platform mobile apps with Flutter and Dart. Covers widgets, state management with Provider/BLoC, navigation, API integration, and material design.
drawio-diagrams-enhanced
jgtolentino
Create professional draw.io (diagrams.net) diagrams in XML format (.drawio files) with integrated PMP/PMBOK methodologies, extensive visual asset libraries, and industry-standard professional templates. Use this skill when users ask to create flowcharts, swimlane diagrams, cross-functional flowcharts, org charts, network diagrams, UML diagrams, BPMN, project management diagrams (WBS, Gantt, PERT, RACI), risk matrices, stakeholder maps, or any other visual diagram in draw.io format. This skill includes access to custom shape libraries for icons, clipart, and professional symbols.
ui-ux-pro-max
nextlevelbuilder
"UI/UX design intelligence. 50 styles, 21 palettes, 50 font pairings, 20 charts, 8 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient."
godot
bfollington
This skill should be used when working on Godot Engine projects. It provides specialized knowledge of Godot's file formats (.gd, .tscn, .tres), architecture patterns (component-based, signal-driven, resource-based), common pitfalls, validation tools, code templates, and CLI workflows. The `godot` command is available for running the game, validating scripts, importing resources, and exporting builds. Use this skill for tasks involving Godot game development, debugging scene/resource files, implementing game systems, or creating new Godot components.
nano-banana-pro
garg-aayush
Generate and edit images using Google's Nano Banana Pro (Gemini 3 Pro Image) API. Use when the user asks to generate, create, edit, modify, change, alter, or update images. Also use when user references an existing image file and asks to modify it in any way (e.g., "modify this image", "change the background", "replace X with Y"). Supports both text-to-image generation and image-to-image editing with configurable resolution (1K default, 2K, or 4K for high resolution). DO NOT read the image file first - use this skill directly with the --input-image parameter.
fastapi-templates
wshobson
Create production-ready FastAPI projects with async patterns, dependency injection, and comprehensive error handling. Use when building new FastAPI applications or setting up backend API projects.
Related MCP Servers
Browse all serversCipher empowers agents with persistent memory using vector databases and embeddings for seamless context retention and t
Leverage OpenAI o3 Search for advanced web results, outperforming Bing AI and other engines with unrivaled AI search cap
Optimize hyper parameters effortlessly with Optuna, the best AutoML software for automated analysis, visualization, and
Access Hacker News stories, comments, and profiles using the Firebase API with integrated hacker news algolia features a
Enhance Java code with Aibolit Java Code Analyzer. Identify design, maintainability, and architectural issues beyond sur
Dual-Cycle Reasoner enables agents to detect repetitive behavior, diagnose failure causes, and recover with advanced met
Stay ahead of the MCP ecosystem
Get weekly updates on new skills and servers.