Skip to main content
skill CX Codex

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.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add deanpeters/Product-Manager-Skills --skill user-story-mapping-workshop -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/user-story-mapping-workshop/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/user-story-mapping-workshop/

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.

Similar skills

All skills for Notes, tasks and projects →

From the same set73

tam-sam-som-calculator Takes a product idea through TAM, SAM and SOM with adaptive questions, assumptions written down, and a bottom-up estimate you can source. Built for business cases. CX Codex +1 2,300installs saas-economics-efficiency-metrics Evaluates SaaS unit economics and capital efficiency metrics like CAC, LTV, and runway. Helpful for product teams deciding whether to scale or optimize. CX Codex +1 2,300installs proto-persona Build a working profile of a target user from research, market signals, and team knowledge. Use it to align early product decisions before deeper validation. CX Codex +1 2,300installs workshop-facilitation A protocol for running interactive sessions: one question per turn, progress labels, and a choice of entry mode. Useful when a workshop keeps drifting. CX Codex +1 2,300installs skill-authoring-workflow Walks a skill from rough notes to a SKILL.md that passes the repo's checks. Useful when you add or update skills in Product-Manager-Skills. CX Codex +1 2,100installs recommendation-canvas Evaluates AI product proposals across business goals, PESTEL threats, and solution hypotheses. Built for product managers defending new AI initiatives before leadership. CX Codex +1 2,100installs vp-cpo-readiness-advisor Coaching for the jump from Director to VP or CPO: getting ready, interviewing, the first months in the seat, and fixing what stopped working. CX Codex +1 2,000installs product-sense-interview-answer Guides practice for spoken product-sense interview answers, from framing assumptions to selecting an MVP. Use it for product design, improvement, or build-next prompts. CX Codex +1 1,700installs

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor