Back to Skills

job-stories

Create job stories using the 'When [situation], I want to [motivation], so I can [outcome]' format with detailed acceptance criteria. Use when writing job stories, creating JTBD-style backlog items, or expressing user situations and motivations.

24,410stars2,506forksUpdated 7/25/2026

Security Assessment

Safe(97/100)
Security Score97/100

About job-stories

Job Stories is a product-management skill that generates backlog items in the Jobs-to-be-Done format 'When [situation], I want to [motivation], so I can [outcome],' paired with detailed acceptance criteria. It solves the problem of user stories that anchor on roles and personas rather than the actual situation and motivation driving a user's behavior, shifting the focus to user context and desired outcomes so requirements describe the job to be done rather than who is doing it.

The skill accepts arguments for the product name, the feature to break down, a link to design files (Figma, Miro, etc.), and the user context or scenarios. It follows an eight-step process: identifying triggering situations, defining motivations, clarifying outcomes, applying the JTBD framing, writing outcome-validating acceptance criteria in observable and measurable language, linking to design mockups, and outputting the finished stories. It supplies a reusable story template and a worked example (tracking weekly snack spending) with six to eight acceptance criteria covering summaries, real-time updates, progress indicators, notifications, edge cases, and navigation. The documented deliverable is a complete set of job stories for a feature, each following the format with outcome-focused acceptance criteria and links to design.

It is intended for product managers, product owners, and teams writing JTBD-style backlog items, expressing user situations and motivations, or focusing on user context instead of roles. It is a single-file SKILL.md that produces written artifacts and includes a link to a Jobs-to-be-Done masterclass for further reading.

FAQ

What format do the generated stories follow?

Every story uses the Jobs-to-be-Done structure 'When [situation], I want to [motivation], so I can [outcome],' accompanied by six to eight acceptance criteria written in observable, measurable language and focused on validating outcomes.

What inputs does it take?

It accepts arguments for the product or system name, the feature to break into stories, a link to design files such as Figma or Miro, and the user situations or job scenarios that provide context.

How is a job story different from a traditional user story?

Job stories emphasize the situation and motivation that trigger a need rather than a role or persona, applying the JTBD principle of focusing on the job to be done instead of who is doing it.

What does it produce?

A complete set of job stories for the feature, each in the 'When...I want...so I can' format with detailed outcome-focused acceptance criteria and clear links to design and prototypes.

Install job-stories

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill