Skip to main content
ClaudeWave
EN, English
Skill1.5k repo starsupdated 5d ago

job-story-mapper

Job Story Mapper translates product requirements and user research into Jobs-to-be-Done job stories that map customer needs across functional, emotional, and social dimensions. Use this skill when defining user requirements, conducting JTBD research, or reframing features around customer outcomes rather than feature specifications. It produces structured job story maps with opportunity scoring and pain intensity analysis to identify underserved customer needs and differentiation points.

Install in Claude Code
Copy
git clone --depth 1 https://github.com/mohitagw15856/pm-claude-skills /tmp/job-story-mapper && cp -r /tmp/job-story-mapper/plugins/pm-discovery/skills/job-story-mapper ~/.claude/skills/job-story-mapper
Then start a new Claude Code session; the skill loads automatically.

SKILL.md

# 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

---

## 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"
360-feedback-templateSkill

Design 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.

401k-plan-decoderSkill

Decode a 401k or workplace retirement plan — the real cost of its funds, the match's fine print, vesting math, and the plan features worth using or avoiding. Use when someone asks 'is my 401k any good', 'decode my 401k plan', 'which funds should I look at', or 'what fees am I paying'. Produces a fee decode in dollars-over-time, match and vesting math, a fund-lineup triage by cost, and the questions for HR or the plan administrator.

ab-test-plannerSkill

Design 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.

ab-test-readoutSkill

Analyse a finished A/B test and write the readout — the result, whether it's statistically and practically significant, what it means, and the ship/no-ship call. Use when asked to analyse experiment results, write an A/B test readout, interpret test data, or decide whether to ship a variant. Produces a clear verdict with the lift and confidence, segment cuts, the risks (peeking, novelty, sample), and a recommendation. Distinct from planning a test — this reads results.

accessibility-auditSkill

Generate 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.

accessible-travel-plannerSkill

Plan a trip that actually works with a disability or access need — confirm real accessibility (not just 'accessible' labels), book the assistance in advance, plan for equipment and medication, and build in the contingencies for when access breaks down. Use when someone says 'plan an accessible trip', 'travelling with a wheelchair/disability', 'book assistance for my flight', or 'will this hotel actually work for me'. Produces an access-verified itinerary, an assistance-booking checklist, an equipment/medication plan, and contingency scripts. Verify specifics with providers.

accommodation-requestSkill

Request a reasonable accommodation at work or in education — frame it around the barrier and the adjustment (not your diagnosis), cite the right process, and navigate the back-and-forth constructively. Use when someone says 'I need a workplace accommodation', 'request reasonable adjustments', 'ADA/Equality Act accommodation', or 'how do I ask for accommodations for my disability/condition'. Produces the request letter, a barriers-and-adjustments map, disclosure guidance, and a plan for the interactive process. Not legal advice — routes to the formal process and to advocacy where needed.

account-planSkill

Build 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.