jtbd-job-stories

Write Jobs-to-be-Done job stories framing needs by situation, motivation, and outcome.

3|2|Updated Aug 24, 2026
One-click install
npx skills add https://github.com/hero-engine/hero --skill jtbd-job-stories-hero-engine
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: jtbd-job-stories
Source: https://github.com/hero-engine/hero/tree/main/domains/pm/skills/jtbd-job-stories
Command: npx skills add https://github.com/hero-engine/hero --skill jtbd-job-stories-hero-engine

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams often write user stories around personas that carry no real information, producing vague requirements that fail to capture why a need exists. This Skill provides the Jobs-to-be-Done job-story format — "When [situation], I want [motivation], so [outcome]" — so product work is framed around the trigger and motivation that actually predict behavior. ## Core Features & Use Cases - Job-Story Format Guidance: Teaches the situation-motivation-outcome structure with concrete good and weak examples, plus the four forces (push, pull, anxiety, habit) behind a product switch. - Research Synthesis: Shows how to harvest job stories from interviews, tickets, and journey maps, and how to force-rank situations by frequency times intensity. - Job Story vs INVEST Distinction: Clarifies when to use a discovery-stage job story versus a delivery-ready INVEST user story, with a comparison table and anti-pattern list. - Use Case: After a round of user interviews, a product manager synthesizes raw quotes into ranked job stories, then feeds the top opportunities into an opportunity solution tree before writing INVEST stories for engineering. ## Quick Start Ask the agent to turn these interview notes about users struggling with manual data exports into prioritized JTBD job stories.

Frequently Asked Questions about jtbd-job-stories

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write a Jobs-to-be-Done job story?▼

Use the format "When [situation], I want [motivation], so [outcome]." The situation clause carries the concrete trigger context, the motivation states what the person wants to do without naming an implementation, and the outcome names the state they are trying to reach.

What is the difference between a job story and a user story?▼

A job story frames the need during discovery using a situation rather than a persona, answering why the need exists. An INVEST user story is the delivery-ready atom engineering builds against, with testable acceptance criteria answering what to build and when it is done.

When should I use job stories instead of personas?▼

Use job stories when the trigger situation matters more than who has the need, or when a persona slot carries no real information. Personas still serve as research artifacts anchoring whose outcome matters, but the situation predicts behavior better than demographics.

How do I prioritize job stories from user research?▼

Rank job stories by frequency times intensity: how often the situation occurs and how much it hurts when it does. Rare-but-agonizing and constant-but-mild situations both deserve attention, while rare-and-mild ones usually do not.

What are common job story mistakes to avoid?▼

Avoid persona-smuggling demographics into the When clause, baking the solution into the situation, outcomes that merely restate the motivation, overly broad everyone-situations, and handing a raw job story to engineering as a delivery spec.