Job Story Mapper Skill

Write Jobs-to-be-Done (JTBD) job stories and map customer jobs across functional, social, and emotional dimensions.

Job Story Mapper Skill — The Skill Playground: pick the Executive Update skill, fill in a few notes, hit run, and watch a structured executive… (from the mohitagw15856/pm-claude-skills README)

From the mohitagw15856/pm-claude-skills README — shows the whole collection, not only this skill. · view on GitHub

How to use it

Claude Code
  1. Run the line below. It pulls the whole folder into ~/.claude/skills/job-story-mapper.
  2. Describe your job in plain words. Claude Code follows the skill from there.
Claude Code — installs the whole folder, not just SKILL.md
npx degit mohitagw15856/pm-claude-skills/skills/job-story-mapper#main ~/.claude/skills/job-story-mapper

For one project only, change the path to .claude/skills/job-story-mapper.

Claude (web or desktop app)
  1. On this page open ⋯ → Download .md.
  2. Save it as SKILL.md in a folder, zip the folder, then Customize → Skills → + → Create skill → Upload a skill.
  3. Pick the file and Save. Claude shows the name and description and runs a security scan.
  4. Check the skill is switched on.
  5. Start a new chat and describe your job in plain words. The AI follows the skill from there.
ChatGPT or another app
  1. ChatGPT: make a Project and paste it into Instructions.
  2. Neither? Paste it at the top of a new chat — it works for that chat.
Not working?
  • Check which app you pasted it into — the steps above name the right one.
  • Some skills need the paid tier of Claude or ChatGPT.
Step-by-step guide with screenshots · Ask in the forum

Paste into Claude, ChatGPT or Cursor.

Source of Job Story Mapper Skill

Show the full text157 lines
namedescription
job-story-mapperWrite 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")

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 

Discussion