user-story-mapping-workshop — Claude Code skill: how it works
Guides interactive story mapping workshops through adaptive prompts. Organizes workflows into horizontal narrative activities and vertical priority tiers.
npx skills add deanpeters/Product-Manager-Skills --skill user-story-mapping-workshop -a claude-codeWhat user-story-mapping-workshop does
The skill facilitates a two-dimensional story mapping exercise based on Jeff Patton's framework. Instead of maintaining an unorganized list of tickets, the agent arranges system capabilities along an explicit user journey. Core activities stretch horizontally, while underlying tasks cascade downward by urgency.
The interactive dialogue asks up to five targeted questions with multiple-choice prompts. Supplying product context, PRD snippets, or user personas directly in the opening prompt skips redundant steps. The workshop isolates a walking skeleton for initial launch and defines subsequent release boundaries.
Sessions generally run between 60 and 120 minutes. The workflow fails to add value for single minor tweaks or pure backend refactoring where no user-facing interactions exist.
What it helps with
- structure a flat backlog into an end-to-end user journey
- define the walking skeleton for an initial MVP release
- uncover missing product steps across the core narrative
- align team priorities without building technical Gantt charts
Example prompts for the agent
- Run a user-story-mapping-workshop for our vendor onboarding portal to slice the MVP
- Facilitate a story mapping workshop for customer checkout using our draft PRD
- Break down the tax filing user flow into activities and release boundaries
How to install user-story-mapping-workshop
1Skills CLI (Vercel)
npx skills add deanpeters/Product-Manager-Skills --skill user-story-mapping-workshop -a claude-code2Manually: put the files in place
~/.claude/skills/user-story-mapping-workshop/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/user-story-mapping-workshop/
1Skills CLI (Vercel)
npx skills add deanpeters/Product-Manager-Skills --skill user-story-mapping-workshop -a codex2Manually: put the files in place
.agents/skills/user-story-mapping-workshop/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add deanpeters/Product-Manager-Skills --skill user-story-mapping-workshop -a cursor2Manually: put the files in place
.cursor/skills/user-story-mapping-workshop/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install deanpeters/Product-Manager-Skills user-story-mapping-workshop2Manually: put the files in place
.github/skills/user-story-mapping-workshop/SKILL.md1Skills CLI (Vercel)
npx skills add deanpeters/Product-Manager-Skills --skill user-story-mapping-workshop -a gemini-cli2Platform CLI
gemini skills install https://github.com/deanpeters/Product-Manager-Skills --path skills/user-story-mapping-workshopManually: put the files in place
.devin/skills/user-story-mapping-workshop/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add deanpeters/Product-Manager-Skills --skill user-story-mapping-workshop -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about user-story-mapping-workshop
How do I install user-story-mapping-workshop in Claude Code?
Run npx skills add deanpeters/Product-Manager-Skills --skill user-story-mapping-workshop -a claude-code. The skill definition will be placed in ~/.claude/skills/user-story-mapping-workshop/SKILL.md.
What does user-story-mapping-workshop do?
It conducts an interactive discovery workshop using structured questions. The skill outputs a visual matrix dividing user workflows into backbone activities and vertical release slices.
When should you avoid using this skill?
Skip it for isolated feature adjustments and architectural refactoring projects. The process requires an active user workflow to deliver meaningful results.