jobs-to-be-done
Skill8 starsChanged 10 months agoMITView on GitHub
Applies Bob Moesta's demand-side thinking and Jobs-to-be-Done framework to help product teams understand why customers switch, hire, and fire products. Use when conducting switch interviews, drawing forces diagrams, writing job statements, mapping demand timelines, understanding the struggling moment, analyzing why customers hire or fire your product, exploring passive or active looking behavior, researching JTBD, or when user mentions Bob Moesta, demand-side thinking, big hire, little hire, push/pull/anxiety/habit, or the four forces of progress.
23 other projects use a version of this.
Adopted by
Most recently taken up by
- miguelclavel/ux-research-skillstheir own version, first seen Nov 8, 2026
- vijaysuperpositionist/skillstheir own version, first seen Nov 1, 2026
- deanpeters/Product-Manager-Skillstheir own version, first seen Oct 25, 2026
- OptionalGanesh/claude-skillstheir own version, first seen Oct 20, 2026
- anilkk/jobs-to-be-done-claude-skilltheir own version, first seen Oct 15, 2026
- fzfclee/consulting-skillstheir own version, first seen Oct 13, 2026
Used with
Projects with it also use proto-persona, usability-test-plan and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
nandanosqlSkillproto-persona
Create hypothesis-driven user personas before doing full research. Uses behavioral attributes, goals, and frustrations to model target users quickly for early-stage alignment.
Also in 4 projects that use this
launchapp-devSkillusability-test-plan
Design a usability test plan with tasks, success metrics, participant criteria, and facilitation guide. Use when planning moderated or unmoderated usability testing sessions.
Also in 3 projects that use this
nandanosqlSkillacquisition-channel-advisor
Evaluate and recommend customer acquisition channels based on product type, target audience, budget, and stage — covering organic, paid, referral, partnerships, and product-led growth.
Also in 3 projects that use this
brainbytes-devSkillbalanced-scorecard
Also in 3 projects that use this
- +8 more from nandanosql
Other versions23 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 23
- deanpeters/Product-Manager-Skills★ 8ksame name
- wondelai/skills★ 2.7ksame name
- launchapp-dev/animus-cli★ 39same name
- deciqAI/knowledge-skills★ 13same name
- DIAL-Studio/pm-agent-harness-kit★ 12same name
- flpbalada/fb-skills★ 8same name
- fzfclee/consulting-skills★ 6same name
- The-Utopia-Studio/skills★ 6same name
- Dragoon0x/product-skills★ 4same name
- Adhamxon/claude-code-skills★ 2same name
13 more not listed
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 repository4 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- continuous-discoverySkill
- shape-upSkill
- story-mappingSkill
The file
We split this skill into the rules it gives an agent
2 rules. 0 are common, 1 is distinctive, and 1 is very specific to this project.
0
Common
Most of the 20 edited versions we read keep these.
1
Distinctive
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 36
Every switching decision is shaped by four forces operating simultaneously:
- Very specific: line 46
Use the AskUserQuestion tool to determine what the user needs:
“Common” is measured: kept by at least 6 in 10 of the 20 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
Jobs-to-be-Done
I help product teams understand demand from the customer's point of view — why they switch, what they're hiring a product to do, and what forces drive or block that decision. This is not about demographics or psychographics. It is about the causal mechanisms behind a purchase.
The Jobs-to-be-Done framework, as developed by Bob Moesta, starts with a deceptively simple question: when a customer switched to your product, what was happening in their life that made them say "today is the day"? The struggling moment. Everything else flows from that.
Essential Principles
Jobs Are About Progress, Not Tasks
A job is not a task someone performs. It is the progress a person is trying to make in a specific circumstance. When someone hires a milkshake for a morning commute, the job is not "consume calories" — it is "make this commute manageable and give me something to do with my hand." Understanding the job means understanding the life circumstances that created the need.
Demand-Side Thinking
Most product teams think supply-side: they start with a product and ask how to make it better or sell it to more people. Demand-side thinking starts with the customer and asks: what forces are acting on this person that caused them to make a switch? Supply-side thinking asks "what features do customers want?" Demand-side thinking asks "what was happening in their life when they decided to change?"
The Struggling Moment Is the Starting Point
Customers don't wake up wanting your product. They wake up with a problem they've been tolerating until something tips the balance. That tipping point — the struggling moment — is when the push of current frustration outweighs the combined drag of anxiety about change and the inertia of habit. Find the struggling moment and you find the causal mechanism of demand.
Products Are Hired and Fired
Customers don't "use" or "choose" products — they hire them for a job and fire them when the job isn't done well enough. This metaphor matters because it shifts your thinking from feature comparison to progress comparison. What progress was the customer trying to make? Did your product make that progress possible? When did they fire the last solution and hire yours?
Big Hire vs. Little Hire
The big hire is the moment of purchase — the customer brings the product home. The little hire happens every time they use it. A product can survive the big hire and fail at the little hire. Understanding both is essential: what caused the purchase decision, and what keeps them coming back (or drives them away)?
Four Forces Drive Every Switch
Every switching decision is shaped by four forces operating simultaneously:
- Push: frustration with the current situation driving the customer away
- Pull: the attraction of a new solution pulling the customer toward it
- Anxiety: fear of making the wrong choice holding the customer back
- Habit: the comfort of the familiar keeping the customer where they are
Push and Pull create demand. Anxiety and Habit suppress it. A switch happens when Push + Pull > Anxiety + Habit.
Intake
Use the AskUserQuestion tool to determine what the user needs:
Question: "What are you trying to understand about your customers?"
Options:
- Conduct a switch interview — Walk through why a customer switched to (or away from) your product, from first thought to post-purchase
- Analyze the four forces — Map Push, Pull, Anxiety, and Habit for a customer segment or decision context
- Write a job statement — Capture the job in a complete, testable format with functional, emotional, and social dimensions
- Map a demand timeline — Plot the customer's decision journey from first thought to satisfaction or disappointment
Routing
| Response | Workflow |
| 1, "interview", "switch", "why they switched", "churned", "purchased", "first thought", "timeline" | workflows/switch-interview.md |
| 2, "forces", "push", "pull", "anxiety", "habit", "four forces", "forces diagram", "why they didn't switch" | workflows/analyze-forces.md |
| 3, "job statement", "write a job", "when I", "so I can", "functional", "emotional", "social job" | workflows/write-job-statement.md |
| 4, "timeline", "demand timeline", "decision journey", "energy", "win/loss", "passive looking", "active looking" | workflows/map-demand-timeline.md |
| other | Clarify intent, then route appropriately |
After identifying intent, read the matching workflow and follow it exactly.
Framework Selection
Different JTBD activities call for different reference material:
| Activity | Primary References | Key Frameworks |
| Switch interviews, understanding causation | interview-techniques.md, core-concepts.md | Timeline interview, struggling moment, passive/active looking |
| Forces analysis, diagnosing demand | forces-framework.md, core-concepts.md | Four forces of progress, force dominance patterns |
| Job statement writing, segmentation | core-concepts.md, interview-techniques.md | Functional/emotional/social dimensions, situation-based segmentation |
| Demand timeline mapping, win/loss analysis | interview-techniques.md, forces-framework.md | Passive looking, active looking, deciding moment, big/little hire |
For any JTBD activity, read the relevant reference files before proceeding.
References
Core Knowledge:
- core-concepts.md — Jobs, progress, hiring/firing, big/little hire, functional/emotional/social dimensions
- interview-techniques.md — Timeline interviewing, energy mapping, synthesis techniques
- forces-framework.md — Deep dive on Push, Pull, Anxiety, Habit, and their interactions
Quality and Voice:
- anti-patterns.md — 17 anti-patterns organized by activity phase
Workflows
| Workflow | Purpose |
| switch-interview.md | Conduct a timeline interview tracing the full customer switch from first thought to post-purchase |
| analyze-forces.md | Map and analyze the four forces of progress for a switching decision |
| write-job-statement.md | Write complete, validated job statements with all three dimensions |
| map-demand-timeline.md | Plot the customer demand timeline and identify key decision points |
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.

