User Story Mapping

Create a user story map that lays out activities, steps, tasks, and release slices. Use when planning a workflow, backlog, or MVP around the user journey.

7,800 stars 940 forksWriting & Content

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add deanpeters/Product-Manager-Skills --skill user-story-mapping
Manual install
git clone --depth 1 https://github.com/deanpeters/Product-Manager-Skills.git /tmp/Product-Manager-Skills
mkdir -p ~/.claude/skills
cp -r /tmp/Product-Manager-Skills/skills/user-story-mapping ~/.claude/skills/user-story-mapping

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

## Purpose
Visualize the user journey by creating a hierarchical map that breaks down high-level activities into steps and tasks, organized left-to-right as a narrative flow. Use this to build shared understanding across product, design, and engineering, prioritize features based on user workflows, and identify gaps or opportunities in the user experience.

This is not a backlog—it's a strategic artifact that shows *how* users accomplish their goals, which then informs *what* to build.

## Input

**Works best with:** The product or user workflow being mapped.
**Also useful:** The primary user, the end-to-end narrative as you understand it, existing backlog items to place, and release goals.

Anything supplied with the invocation itself — text after the skill name, a pasted context dump, or an appended `ARGUMENTS:` line — counts as answers already given. Use it and skip whatever it covers; don't re-ask.

**Arriving empty-handed? That works too.** The skill asks whose journey you're mapping and what they're trying to get done, then builds backbone → tasks → slices.

**Example invocation:** `Story map for our expense-reporting flow, from receipt capture to reimbursement, with an MVP slice for the pilot.`

## Key Concepts

### The Jeff Patton Story Mapping Framework
Invented by Jeff Patton, story mapping organizes work into a 2D structure:

**Horizontal axis (left-to-right):** User journey over time
- **Backbone:** High-level activities the user performs
Read the full skill on GitHub

Details

Skill name
user-story-mapping
Path
skills/user-story-mapping/SKILL.md
Repo updated
16 October 2026

FAQ

What does the User Story Mapping skill do?

Create a user story map that lays out activities, steps, tasks, and release slices. Use when planning a workflow, backlog, or MVP around the user journey.

How do I install the User Story Mapping skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add deanpeters/Product-Manager-Skills --skill user-story-mapping. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is User Story Mapping popular?

It lives in deanpeters/Product-Manager-Skills, which has 7,800 GitHub stars and 940 forks, and is included in 3 curated skill lists.

Related skills

Acquisition Channel Advisor

7.8k

deanpeters/Product-Manager-Skills

Evaluate acquisition channels using unit economics, customer quality, and scalability. Use when deciding whether to scale, test, or kill a growth channel.

Marketing, Sales & BusinessIn 3 lists940

AI Shaped Readiness Advisor

7.8k

deanpeters/Product-Manager-Skills

Assess whether your product work is AI-first or AI-shaped. Use when evaluating AI maturity and choosing the next team capability to build.

AI, LLMs & AgentsIn 3 lists940

Altitude Horizon Framework

7.8k

deanpeters/Product-Manager-Skills

Understand the PM-to-Director transition through altitude and horizon thinking. Use when diagnosing scope, time-horizon, or leadership-level gaps.

Software DevelopmentIn 3 lists940

User Story Mapping Workshop

7.8k

deanpeters/Product-Manager-Skills

Run a user story mapping workshop with adaptive questions and a structured map output. Use when you need backbone activities, tasks, and release slices for a workflow.

Writing & ContentIn 3 lists940

User Story

7.8k

deanpeters/Product-Manager-Skills

Create user stories with Mike Cohn format and Gherkin acceptance criteria. Use when turning user needs into development-ready work with clear outcomes and testable conditions.

Writing & ContentIn 3 lists940

User Story Splitting

7.8k

deanpeters/Product-Manager-Skills

Break a large story or epic into smaller deliverable stories using proven split patterns. Use when backlog items are too big for estimation, sequencing, or independent release.

Writing & ContentIn 3 lists940

Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.