Agent skill

Job Story Mapper

by mohitagw15856 in mohitagw15856/pm-claude-skills

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

MITAuto-check passedProduct & Project Management

Install Job Story Mapper

skills CLI
$ npx skills add mohitagw15856/pm-claude-skills --skill job-story-mapper -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install mohitagw15856/pm-claude-skills job-story-mapper --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/mohitagw15856/pm-claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/job-story-mapper .claude/skills/job-story-mapper && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
job-story-mapper
GitHub stars
1.4k
Token cost
~2k tokens
SKILL.md length
1,049 words
Files
4 (incl. references)
Skills in repo
1,348
Repo updated
First seen
Licence
MIT

At a glance

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

  • Works in 5 steps: Identify the main job → Break into job steps → Identify pain points per step → …
  • Defining user needs
  • SKILL.md covers Jobs-to-be-Done Fundamentals, Job Story Format, Mapping Process and Output Format, plus 7 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Job Story Mapper is an agent skill from mohitagw15856/pm-claude-skills. 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.

Its SKILL.md is about 2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `references/situation-mining.md`, `references/worked-example.md` and `templates/job-story-canvas.md`).

It sits in Product & Project Management, covering User stories and Prioritization frameworks. The repository describes itself as: 1255 professional Agent Skills for Claude, ChatGPT, Gemini, Cursor & Codex — PRDs, postmortems, leases, medical bills, layoffs, go-bags, new countries. Plain markdown, MIT, in… The licence is MIT.

When your agent uses it

  • Defining user needs
  • Writing job stories
  • Conducting JTBD research
  • Reframing features around customer outcomes

Example prompts

  • “/job-story-mapper”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Identify the main job
  2. Break into job steps
  3. Identify pain points per step
  4. Write job stories for each pain point
  5. Map to product opportunities

What it can do on your machine

Read from SKILL.md and the folder at commit 1cbf1f0. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Job Story Mapper loads about 2k tokens when it runs, and up to ~5k if it reads all its reference files. Until then it costs about 92 tokens; SKILL.md has 1,049 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~92
When it runs · the whole SKILL.md, loaded when a task matches
~2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from mohitagw15856/pm-claude-skills at commit 1cbf1f0, republished under its MIT licence (© mohitagw15856). 1,049 words, ~1,956 tokens.

Download SKILL.mdSave it as .claude/skills/job-story-mapper/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
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")

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:

StepSub-JobCurrent SolutionPain PointsUnderserved?
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.
Show full SKILL.md (515 more words)Show less

Scoring Rubric (0–40)

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

Dimension0510
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 contextEvery situation is a concrete, recognisable moment ("a tenant texts me at 11pm") that makes the motivation self-evident
Dimensional completenessOnly the functional job mapped; emotional and social fields empty or absentAll three fields filled, but emotional/social entries just restate the functional job in feeling-wordsFunctional, emotional, and social dimensions each carry distinct content, and at least one non-functional dimension shapes the opportunity analysis
Workaround groundingNo current workarounds identified; jobs float free of what customers do todayWorkarounds named but treated as trivia — nothing inferred from themEvery 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 disciplineNo opportunity scores, or scores invented without the Importance/Satisfaction inputsScores computed correctly but treated as the build order — no feasibility or strategic-fit checkArithmetic 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"

Example Trigger Phrases

  • "Define user needs."
  • "Write job stories."
  • "Map the customer jobs for this feature."
  • "Reframe these features around customer outcomes."

© mohitagw15856, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references) in skills/job-story-mapper of mohitagw15856/pm-claude-skills.

  • SKILL.md
  • references/situation-mining.md
  • references/worked-example.md
  • templates/job-story-canvas.md

Open the folder on GitHubat commit 1cbf1f0

Compare with similar skills

Job Story Mapper next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Job Story Mapper compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Job Story Mapper this skillmohitagw15856/pm-claude-skills1.4k—~2kAutomated safety check: PassMIT
Agile Product Owneralirezarezvani/claude-skills28k3 repos~3.2kAutomated safety check: PassMIT
Super Product Ownersyahiidkamil/Software-Engineer-AI-Agent-Atlas401—~7.9kAutomated safety check: PassNone
Product Managernagisanzenin/production-grade181—~3.7kAutomated safety check: PassNone
Bmad Prdaj-geddes/claude-code-bmad-skills488—~1.8kAutomated safety check: NotesCustom licence
Oma Pmfirst-fluke/oh-my-agent1.3k—~1.9kAutomated safety check: PassMIT

Similar skills

  • Agile Product Owner

    alirezarezvani/claude-skills

    Writes INVEST-checked user stories with acceptance criteria, splits epics, plans sprints from velocity and ranks the backlog with a weighted score.

    28k GitHub starsUsed in 3 repos~3.2k tokens
    Product & Project ManagementAuto-check passed
  • Super Product Owner

    syahiidkamil/Software-Engineer-AI-Agent-Atlas

    Complete Product Owner / Product Manager capability — a wiki-style knowledge map of product practice in active software development: the role and its boundaries, strategy cascade (vision → OKRs →…

    401 GitHub stars~7.9k tokensUpdated 3 mo ago
    Product & Project ManagementAuto-check passed
  • Product Manager

    nagisanzenin/production-grade

    [production-grade internal] Turns product ideas and business goals into formal requirements — BRD, user stories, acceptance criteria, prioritization.

    181 GitHub stars~3.7k tokensUpdated 1 mo ago
    Product & Project ManagementAuto-check passed
  • Bmad Prd

    aj-geddes/claude-code-bmad-skills

    PRD facilitator (John the PM). An agent skill from aj-geddes/claude-code-bmad-skills.

    488 GitHub stars~1.8k tokensUpdated 3 mo ago
    Product & Project ManagementAuto-check: notes
  • Oma Pm

    first-fluke/oh-my-agent

    Turn product requirements into scoped tasks with dependencies and acceptance criteria.

    1.3k GitHub stars~1.9k tokensUpdated yesterday
    Product & Project ManagementAuto-check passed
  • Extract Features

    nurettincoban/ai-prd-workflow

    Turn PRD.md into FEATURES.md: permanent feature IDs, MoSCoW priorities, acceptance criteria and the PRD requirement each feature comes from.

    298 GitHub stars~1k tokensUpdated 3 days ago
    Product & Project ManagementAuto-check passed

More from mohitagw15856/pm-claude-skills

All 1,348 skills in this repo
  • Car Tco

    mohitagw15856/pm-claude-skills

    Compare the total cost of car ownership across buy-new, buy-used, lease, and keep-your-current-car — depreciation, insurance, maintenance ramp, and fuel over a real horizon, not just the monthly…

    1.4k GitHub stars~1.1k tokensUpdated 2 days ago
    Auto-check passed
  • Cs Health Scorecard

    mohitagw15856/pm-claude-skills

    Build a customer health scorecard for a specific account. An agent skill from mohitagw15856/pm-claude-skills.

    1.4k GitHub stars~2.4k tokensUpdated 2 days ago
    Auto-check passed
  • Exit Waterfall

    mohitagw15856/pm-claude-skills

    Compute who gets what at each exit price from a cap table — liquidation preferences, conversion points, and where the founders' share collapses.

    1.4k GitHub stars~1.1k tokensUpdated 2 days ago
    Auto-check passed
  • Feature Prioritisation

    mohitagw15856/pm-claude-skills

    Apply prioritisation frameworks (RICE, MoSCoW, Kano, ICE, Opportunity Scoring) to rank features and backlog items.

    1.4k GitHub stars~2k tokensUpdated 2 days ago
    Auto-check passed
  • Fire Number

    mohitagw15856/pm-claude-skills

    Compute a financial-independence (FIRE) target and years-to-reach with every assumption labeled as an assumption — plus a sensitivity table instead of a single false-precision answer.

    1.4k GitHub stars~1.1k tokensUpdated 2 days ago
    Auto-check passed
  • Freelance Rate

    mohitagw15856/pm-claude-skills

    Derive a freelance day/hourly rate backwards from target income, honest billable utilization, overhead, and the self-employment tax premium — the arithmetic that proves a rate is not salary÷2000.

    1.4k GitHub stars~1.2k tokensUpdated 2 days ago
    Auto-check passed

Questions about Job Story Mapper

What does Job Story Mapper do?

Write Jobs-to-be-Done (JTBD) job stories and map customer jobs across functional, social, and emotional dimensions. Job Story Mapper is an agent skill from mohitagw15856/pm-claude-skills. Write Jobs-to-be-Done (JTBD) job stories and map customer jobs across functional, social, and emotional dimensions.

When should I use Job Story Mapper?

Job Story Mapper fits situations like: defining user needs; writing job stories; conducting JTBD research; reframing features around customer outcomes.

How do I install Job Story Mapper in Claude Code?

Run `npx skills add mohitagw15856/pm-claude-skills --skill job-story-mapper -a claude-code`. Or copy the skill folder (skills/job-story-mapper in mohitagw15856/pm-claude-skills) into .claude/skills/job-story-mapper in your project. Claude Code loads it when a task matches its description.

How do I install Job Story Mapper in Codex?

Run `npx skills add mohitagw15856/pm-claude-skills --skill job-story-mapper -a codex`. Or copy the skill folder (skills/job-story-mapper in mohitagw15856/pm-claude-skills) into .agents/skills/job-story-mapper in your project. Codex loads it when a task matches its description.

Can I use Job Story Mapper in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add mohitagw15856/pm-claude-skills --skill job-story-mapper -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/job-story-mapper, .gemini/skills/job-story-mapper, .github/skills/job-story-mapper and .opencode/skills/job-story-mapper in your project.

What does Job Story Mapper need to run?

SKILL.md names no scripts, command-line tools or credentials: Job Story Mapper is instructions for the agent only.

Does Job Story Mapper access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Job Story Mapper safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Job Story Mapper use?

Job Story Mapper is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Job Story Mapper use?

About 2k tokens (SKILL.md is roughly 7.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3k tokens, read only when the agent opens those files.

What are the alternatives to Job Story Mapper?

Skills that share tags, products or a category with Job Story Mapper: Agile Product Owner (alirezarezvani/claude-skills, 28k stars), Super Product Owner (syahiidkamil/Software-Engineer-AI-Agent-Atlas, 401 stars), Product Manager (nagisanzenin/production-grade, 181 stars) and Bmad Prd (aj-geddes/claude-code-bmad-skills, 488 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Job Story Mapper?

mohitagw15856 (a GitHub user) maintains it in mohitagw15856/pm-claude-skills, which has 1,434 GitHub stars. The repository holds 1,348 skills in this directory. The repository was last updated on October 9, 2026.

Source: mohitagw15856/pm-claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.