New: Earn 20% as an AgentAlley affiliate. Share your link and earn on every sale you refer. Join now New: Earn 20% as an affiliate. Join now

Write Jobs-to-be-Done job stories and map customer jobs

Job Story Mapper Skill

by mohitagw15856 · MIT license · ★ 1,395 on GitHub · updated Sep 23

Job Story Mapper Skill cover

Write Jobs-to-be-Done (JTBD) job stories and map customer jobs across functional, social, and emotional dimensions. Use when defining user needs, writing job stories, conducting JTBD research, or reframing features around customer outcomes.

---
name: job-story-mapper
description: "Write Jobs-to-be-Done (JTBD) job stories and map customer jobs across functional, social, and emotional dimensions. Use when defining user needs, writing job stories, conducting JTBD research, or reframing features around customer outcomes. Produces a job story map with opportunity scoring, pain intensity ratings, and product opportunity analysis."
---

# Job Story Mapper Skill

Stop writing features. Start understanding jobs. This skill translates product requirements and user interviews into precise job stories that keep the team focused on outcomes — not outputs.

## Jobs-to-be-Done Fundamentals

A "job" is the progress a customer is trying to make in a given situation. People don't buy products — they hire them to get a job done.

Three dimensions of every job:
- **Functional job:** The practical task ("get from A to B")
- **Emotional job:** How they want to feel ("feel confident I made the right choice")
- **Social job:** How they want to be perceived ("look like a competent professional to my team")

Overview

Stop writing features. Start understanding jobs. This skill translates product requirements and user interviews into precise job stories that keep the team focused on outcomes — not outputs.

Manual install (npx, ZIP)
Claude Codenpx skills add mohitagw15856/pm-claude-skills --skill job-story-mapper -g -a claude-code
Claude Code (manual)mkdir -p ~/.claude/skills && curl -sL https://codeload.github.com/mohitagw15856/pm-claude-skills/tar.gz/f6ca79348c55 \ | tar -xz -C ~/.claude/skills --strip-components=2 pm-claude-skills-f6ca79348c55/skills/job-story-mapper
Windows (PowerShell)New-Item -ItemType Directory -Force "$HOME\.claude\skills" | Out-Null; Invoke-WebRequest "https://m.agentalley.io/zip/c0140df0d01b93897a99/job-story-mapper.zip" -OutFile "$env:TEMP\job-story-mapper.zip"; Expand-Archive "$env:TEMP\job-story-mapper.zip" -DestinationPath "$HOME\.claude\skills" -Force
Claude.ai / desktopDownload the ZIP and upload it under Settings → Capabilities → Skills.
Codex, Cursor, other agentsPoint them at SKILL.md. The other files are plain text.

Connects with Agent Alley MCP · agentalley.io/mcp

Files included

  • SKILL.md7.5 KB
  • references/2 files · 11.8 KB
  • templates/1 file · 926 B
Read the files here
mohitagw15856/f6ca7934 files
SKILL.md
Show the full text157 lines

Job Story Mapper Skill

Stop writing features. Start understanding jobs. This skill translates product requirements and user interviews into precise job stories that keep the team focused on outcomes — not outputs.

Jobs-to-be-Done Fundamentals

A "job" is the progress a customer is trying to make in a given situation. People don't buy products — they hire them to get a job done.

Three dimensions of every job:

  • Functional job: The practical task ("get from A to B")
  • Emotional job: How they want to feel ("feel confident I made the right choice")
  • Social job: How they want to be perceived ("look like a competent professional to my team")

Great products address all three. Most roadmaps only address the functional one.


Job Story Format

Template:

When [situation/trigger], I want to [motivation/goal], so I can [expected outcome].

Not a user story: User stories focus on roles and features: "As a [role] I want [feature] so that [benefit]." Job stories focus on situations and motivations: "When [I'm in this specific situation] I want [this capability] so I can [achieve this outcome]."

The situation is the most important part. "When I'm in the middle of a sprint and my PM asks for an update" is a much richer trigger than "As a developer."


Mapping Process

Step 1: Identify the main job

One sentence: What is the core job your product is hired for?

"Help [user type] [accomplish outcome] when [context]."

Step 2: Break into job steps

What are all the sub-tasks within the main job? (Use a job map: Define → Locate → Prepare → Confirm → Execute → Monitor → Modify → Conclude)

Step 3: Identify pain points per step

Where does the job fall down today? Where do customers use workarounds?

Step 4: Write job stories for each pain point

One job story per distinct situation-motivation pair.

Step 5: Map to product opportunities

Which job stories are underserved? Which have existing solutions? Where is your differentiation?


Output Format

Job Story Map — [Product/Feature Area] — [Date]

Core Job Statement:

When [context], [user type] wants to [main job outcome], so they can [ultimate goal].


Job Map:

Step Sub-Job Current Solution Pain Points Underserved?
Define [What user does] [Tool/method used] [Frustration] H/M/L
Locate
Prepare
Confirm
Execute
Monitor
Modify
Conclude

Job Stories (prioritised by underservice):

Job Story 1 — [Situation label]

When [specific situation], I want to [motivation], so I can [outcome].

Functional dimension: [What they need to get done] Emotional dimension: [How they want to feel] Social dimension: [How they want to be perceived]

Current workaround: [What they do today] Pain intensity: [High / Medium / Low] Frequency: [How often this situation occurs] Product opportunity: [What we could build to address this]


Repeat for each major job story.

Opportunity Scoring: Rate each job story on:

  • Importance to customer (1–10)
  • Satisfaction with current solution (1–10)
  • Opportunity score = Importance + max(Importance – Satisfaction, 0)
  • Prioritise: Opportunity score > 10

Deeper Materials

This skill ships with support files — use them when they are available:

  • references/situation-mining.md — Situation Mining — the "When" Is the Whole Method. Apply it while producing the output; it carries the calibration and judgment calls the method summary above compresses.
  • templates/job-story-canvas.md — a fill-in version of the deliverable with the quality gates inline. Offer it when the user wants to work the document themselves rather than have it generated.

Scoring Rubric (0–40)

Score any output of this skill before handing it over; 32+ is ship-quality.

Dimension 0 5 10
Situation specificity "When" clauses are roles or generic desires ("as a user who wants to manage work") Situations name a task but not a moment — no trigger, time, or emotional context Every situation is a concrete, recognisable moment ("a tenant texts me at 11pm") that makes the motivation self-evident
Dimensional completeness Only the functional job mapped; emotional and social fields empty or absent All three fields filled, but emotional/social entries just restate the functional job in feeling-words Functional, emotional, and social dimensions each carry distinct content, and at least one non-functional dimension shapes the opportunity analysis
Workaround grounding No current workarounds identified; jobs float free of what customers do today Workarounds named but treated as trivia — nothing inferred from them Every high-opportunity story names its workaround and reads it as evidence of what the job is worth (time spent, money paid, delay tolerated)
Scoring & prioritisation discipline No opportunity scores, or scores invented without the Importance/Satisfaction inputs Scores computed correctly but treated as the build order — no feasibility or strategic-fit check Arithmetic is shown and consistent, borderline scores are not rounded up, and high scores the roadmap can't serve are flagged as strategy questions rather than queued

Quality Checks

  • Job stories use the "When / I want to / So I can" format (not user story format)
  • Situation is specific (not "as a user" — a real moment or trigger)
  • All three dimensions covered: functional, emotional, social
  • Opportunity score calculated for each job story
  • Current workaround identified for each high-opportunity story
  • Product opportunity is distinct from "build the feature" (it's an outcome)

Required Inputs

Ask the user for these if not provided:

  • Product or feature area to map (e.g. onboarding, checkout, dashboard)
  • User type or persona (who are we mapping jobs for?)
  • Source material (user interview notes, support tickets, discovery findings, or describe from memory)
  • Scope (full product job map vs. a single feature area)

Anti-Patterns

  • Do not write job stories that describe a feature rather than a situation-motivation pair
  • Do not skip the social and emotional dimensions — mapping only functional jobs misses the most defensible differentiation opportunities
  • Do not define situations too broadly ("as a user who wants to manage their work") — the situation must be a specific moment or trigger
  • Do not conflate opportunity scoring with priority — a high opportunity score still requires feasibility and strategic fit assessment
  • Do not produce a job map without identifying current workarounds — the workaround reveals what the job is worth to the customer

Guidelines

  • Never write a job story for a feature — write it for the situation that makes the feature valuable
  • If you can't identify the situation, you don't understand the job yet — go back to user research
  • Social and emotional jobs are harder to surface but often the most defensible differentiators
  • Recommend sharing job stories with engineering — they make better technical decisions when they understand the "why"
1---
2name: job-story-mapper
3description: "Write Jobs-to-be-Done (JTBD) job stories and map customer jobs across functional, social, and emotional dimensions. Use when defining user needs, writing job stories, conducting JTBD research, or reframing features around customer outcomes. Produces a job story map with opportunity scoring, pain intensity ratings, and product opportunity analysis."
4---
5 
6# Job Story Mapper Skill
7 
8Stop writing features. Start understanding jobs. This skill translates product requirements and user interviews into precise job stories that keep the team focused on outcomes — not outputs.
9 
10## Jobs-to-be-Done Fundamentals
11 
12A "job" is the progress a customer is trying to make in a given situation. People don't buy products — they hire them to get a job done.
13 
14Three dimensions of every job:
15- **Functional job:** The practical task ("get from A to B")
16- **Emotional job:** How they want to feel ("feel confident I made the right choice")
17- **Social job:** How they want to be perceived ("look like a competent professional to my team")
18 
19Great products address all three. Most roadmaps only address the functional one.
20 
21---
22 
23## Job Story Format
24 
25**Template:**
26> When [situation/trigger], I want to [motivation/goal], so I can [expected outcome].
27 
28**Not a user story:**
29User stories focus on roles and features: "As a [role] I want [feature] so that [benefit]."
30Job stories focus on situations and motivations: "When [I'm in this specific situation] I want [this capability] so I can [achieve this outcome]."
31 
32**The situation is the most important part.** "When I'm in the middle of a sprint and my PM asks for an update" is a much richer trigger than "As a developer."
33 
34---
35 
36## Mapping Process
37 
38### Step 1: Identify the main job
39One sentence: What is the core job your product is hired for?
40> "Help [user type] [accomplish outcome] when [context]."
41 
42### Step 2: Break into job steps
43What are all the sub-tasks within the main job?
44(Use a job map: Define → Locate → Prepare → Confirm → Execute → Monitor → Modify → Conclude)
45 
46### Step 3: Identify pain points per step
47Where does the job fall down today? Where do customers use workarounds?
48 
49### Step 4: Write job stories for each pain point
50One job story per distinct situation-motivation pair.
51 
52### Step 5: Map to product opportunities
53Which job stories are underserved? Which have existing solutions? Where is your differentiation?
54 
55---
56 
57## Output Format
58 
59### Job Story Map — [Product/Feature Area] — [Date]
60 
61**Core Job Statement:**
62> When [context], [user type] wants to [main job outcome], so they can [ultimate goal].
63 
64---
65 
66**Job Map:**
67 
68| Step | Sub-Job | Current Solution | Pain Points | Underserved? |
69|---|---|---|---|---|
70| Define | [What user does] | [Tool/method used] | [Frustration] | H/M/L |
71| Locate | | | | |
72| Prepare | | | | |
73| Confirm | | | | |
74| Execute | | | | |
75| Monitor | | | | |
76| Modify | | | | |
77| Conclude | | | | |
78 
79---
80 
81**Job Stories (prioritised by underservice):**
82 
83**Job Story 1 — [Situation label]**
84> When [specific situation], I want to [motivation], so I can [outcome].
85 
86Functional dimension: [What they need to get done]
87Emotional dimension: [How they want to feel]
88Social dimension: [How they want to be perceived]
89 
90Current workaround: [What they do today]
91Pain intensity: [High / Medium / Low]
92Frequency: [How often this situation occurs]
93Product opportunity: [What we could build to address this]
94 
95---
96 
97Repeat for each major job story.
98 
99**Opportunity Scoring:**
100Rate each job story on:
101- Importance to customer (1–10)
102- Satisfaction with current solution (1–10)
103- Opportunity score = Importance + max(Importance – Satisfaction, 0)
104- Prioritise: Opportunity score > 10
105 
106---
107 
108## Deeper Materials
109 
110This skill ships with support files — use them when they are available:
111 
112- **`references/situation-mining.md`** — Situation Mining — the "When" Is the Whole Method. Apply it while producing the output; it carries the calibration and judgment calls the method summary above compresses.
113- **`templates/job-story-canvas.md`** — a fill-in version of the deliverable with the quality gates inline. Offer it when the user wants to work the document themselves rather than have it generated.
114 
115## Scoring Rubric (0–40)
116 
117Score any output of this skill before handing it over; 32+ is ship-quality.
118 
119| Dimension | 0 | 5 | 10 |
120|---|---|---|---|
121| Situation specificity | "When" clauses are roles or generic desires ("as a user who wants to manage work") | Situations name a task but not a moment — no trigger, time, or emotional context | Every situation is a concrete, recognisable moment ("a tenant texts me at 11pm") that makes the motivation self-evident |
122| Dimensional completeness | Only the functional job mapped; emotional and social fields empty or absent | All three fields filled, but emotional/social entries just restate the functional job in feeling-words | Functional, emotional, and social dimensions each carry distinct content, and at least one non-functional dimension shapes the opportunity analysis |
123| Workaround grounding | No current workarounds identified; jobs float free of what customers do today | Workarounds named but treated as trivia — nothing inferred from them | Every high-opportunity story names its workaround and reads it as evidence of what the job is worth (time spent, money paid, delay tolerated) |
124| Scoring & prioritisation discipline | No opportunity scores, or scores invented without the Importance/Satisfaction inputs | Scores computed correctly but treated as the build order — no feasibility or strategic-fit check | Arithmetic is shown and consistent, borderline scores are not rounded up, and high scores the roadmap can't serve are flagged as strategy questions rather than queued |
125 
126## Quality Checks
127 
128- [ ] Job stories use the "When / I want to / So I can" format (not user story format)
129- [ ] Situation is specific (not "as a user" — a real moment or trigger)
130- [ ] All three dimensions covered: functional, emotional, social
131- [ ] Opportunity score calculated for each job story
132- [ ] Current workaround identified for each high-opportunity story
133- [ ] Product opportunity is distinct from "build the feature" (it's an outcome)
134 
135## Required Inputs
136 
137Ask the user for these if not provided:
138- **Product or feature area** to map (e.g. onboarding, checkout, dashboard)
139- **User type or persona** (who are we mapping jobs for?)
140- **Source material** (user interview notes, support tickets, discovery findings, or describe from memory)
141- **Scope** (full product job map vs. a single feature area)
142 
143## Anti-Patterns
144 
145- [ ] Do not write job stories that describe a feature rather than a situation-motivation pair
146- [ ] Do not skip the social and emotional dimensions — mapping only functional jobs misses the most defensible differentiation opportunities
147- [ ] Do not define situations too broadly ("as a user who wants to manage their work") — the situation must be a specific moment or trigger
148- [ ] Do not conflate opportunity scoring with priority — a high opportunity score still requires feasibility and strategic fit assessment
149- [ ] Do not produce a job map without identifying current workarounds — the workaround reveals what the job is worth to the customer
150 
151## Guidelines
152 
153- Never write a job story for a feature — write it for the situation that makes the feature valuable
154- If you can't identify the situation, you don't understand the job yet — go back to user research
155- Social and emotional jobs are harder to surface but often the most defensible differentiators
156- Recommend sharing job stories with engineering — they make better technical decisions when they understand the "why"
157 
View all files on GitHub →

Details

Updated
Sep 23, 2026
License
MIT
Stars on the repo
★ 1,395
Checked
Source
mohitagw15856/pm-claude-skills ↗
Creator
mohitagw15856 · 193 listings
View creator

Made with job-story-mapper

Job Story Mapper Skill — Galaxy 3D — fly through all 1170 skills as a glowing constellation you orbit and click into (from the mohitagw15856/pm-claude-skills README)
Job Story Mapper Skill — Galaxy 3D — fly through all 1170 skills as a glowing constellation you orbit and click into (from the mohitagw15856/pm-claude-skills README)

by mohitagw15856

Job Story Mapper Skill — PM Skills Wrapped — your practice turned into a shareable, Spotify-Wrapped-style story (from the mohitagw15856/pm-claude-skills README)
Job Story Mapper Skill — PM Skills Wrapped — your practice turned into a shareable, Spotify-Wrapped-style story (from the mohitagw15856/pm-claude-skills README)

by mohitagw15856

Similar skills

See all →
MCP3-5 days | Agents: 6 | Gate Keepers: DevOps Automator +⚙️ Phase 2 Playbook — Foundation & Scaffoldingmsitarzewski/agency-agents · by msitarzewski> Duration: 3-5 days | Agents: 6 | Gate Keepers: DevOps Automator + Evidence Collector★ 154k GitHub starsMCPNEXUS transforms The Agency's independent AI specialists🌐 NEXUS — Network of EXperts, Unified in Strategymsitarzewski/agency-agents · by msitarzewski> NEXUS transforms The Agency's independent AI specialists into a synchronized intelligence network. This is not a prompt collection — it…★ 154k GitHub starsSkillGenerate an Ansoff Matrix analysis mapping growth strategiesphuryn/pm-skills · by phurynGenerate an Ansoff Matrix analysis mapping growth strategies across market penetration, market development, product development, and diversification. Use when considering growth options, planning market expansion, or evaluating strategic growth paths.★ 26.6k GitHub starsSkillSurvey any codebase as a senior advisorImproveshadcn/improve · by shadcnSurvey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute. Strictly read-only on source code — never implements, fixes, or refactors anything itself. Use when asked to audit a codebase, find improvement opportunities (bugs, security, performance, test coverage, tech debt, migrations, DX), suggest features or where to take the project next (roadmap, product direction), or generate handoff plans for another agent to implement.★ 9.2k GitHub starsSkillTranslate skills from one industry to anotherCareer changer translatorParamchoudhary/ResumeSkills · by ParamchoudharyTranslate skills from one industry to another, identify transferable skills★ 2.4k GitHub starsSkillA collection of 37 battle-tested marketing skillsOpenClaw Marketing SkillsLeoYeAI/openclaw-marketing-skills · by LeoYeAIA collection of 37 battle-tested marketing skills for OpenClaw agents. Use when you want to install or reference any marketing skill including: CRO (page-cro, signup-flow-cro, onboarding-cro, form-cro, popup-cro, paywall-upgrade-cro), copywriting, copy-editing, cold-email, email-sequence, social-content, seo-audit, ai-seo, programmatic-seo, site-architecture, schema-markup, content-strategy, paid-ads, ad-creative, ab-test-setup, analytics-tracking, referral-program, free-tool-strategy, churn-prevention, revops, sales-enablement, launch-strategy, pricing-strategy, competitor-alternatives, marketing-ideas, marketing-psychology, lead-magnets, product-marketing-context, and data connectors (google-ads-connect, search-console-connect, meta-ads-connect, x-twitter-connect). Start with product-marketing-context to set up your product context document, then use any other skill naturally. Powered by MyClaw.ai.★ 1k GitHub stars

More from mohitagw15856

SkillDesign a 360-degree feedback survey or write a structured360-Degree Feedback Template Skillmohitagw15856/pm-claude-skills · by mohitagw15856Design a 360-degree feedback survey or write a structured 360 feedback report. Use when asked to build a 360 feedback process, write 360 feedback for a colleague, design a feedback survey, or produce a feedback report. Produces either a complete survey instrument with rating scales and open-ended questions, or a structured narrative feedback report with themes, strengths, and development areas.★ 1.4k GitHub starsSkillDesign statistically rigorous A/B tests for product featuresA/B Test Planner Skillmohitagw15856/pm-claude-skills · by mohitagw15856Design statistically rigorous A/B tests for product features, UI changes, onboarding flows, and pricing experiments. Use when asked to set up an experiment, design an A/B test, calculate sample size, or interpret test results. Produces a complete test plan with hypothesis, variant definitions, sample size, duration estimate, guardrail metrics, and a results interpretation guide.★ 1.4k GitHub starsSkillGenerate a WCAG 2.2 accessibility audit checklistAccessibility Audit Skillmohitagw15856/pm-claude-skills · by mohitagw15856Generate a WCAG 2.2 accessibility audit checklist and remediation suggestions for any UI or design. Use when asked to audit for accessibility, check WCAG compliance, review a design for a11y issues, or create an accessibility remediation plan. Produces a prioritised checklist with pass/fail assessments and specific fixes.★ 1.4k GitHub starsSkillBuild a structured account plan for any key customerAccount Plan Skillmohitagw15856/pm-claude-skills · by mohitagw15856Build a structured account plan for any key customer or target account. Use when asked to create an account plan, key account strategy, strategic account review, or territory plan. Produces a complete account plan with relationship map, growth opportunities, risks, and 90-day action plan.★ 1.4k GitHub starsSkillOptimize an article for Answer Engine Optimization so AIAEO Optimizer Skillmohitagw15856/pm-claude-skills · by mohitagw15856Optimize an article for Answer Engine Optimization (AEO) so AI engines like ChatGPT, Perplexity, and Claude can extract, quote, and cite it. Use when asked to AEO-optimize, make content AI-readable, improve AI citation chances, or adapt an article for answer engines. Produces an AEO-optimised rewrite with question headings, 50–80 word answer capsules, a paragraph-length audit, and flagged trust signals.★ 1.4k GitHub starsSkillConduct a structured ethical review of an AI or ML featureAI Ethics Review Skillmohitagw15856/pm-claude-skills · by mohitagw15856Conduct a structured ethical review of an AI or ML feature, model, or product. Use when preparing to deploy an AI system, assessing algorithmic risk, auditing a model for bias, or producing a responsible AI impact assessment. Produces a structured ethics review covering fairness, transparency, privacy, safety, accountability, and societal impact with a risk tier score, pre-deployment checklist, and prioritised mitigations.★ 1.4k GitHub stars