User Story Mapping

Use when a user wants to create, facilitate, or generate a user story map for a product or feature — either guided step-by-step (coaching mode) or from a raw requirement (generation mode).

5 stars 1 forksWriting & Content

Install

skills CLI (Claude Code, Cursor, Codex and more)

npx skills add tomershahar/user-story-mapping-skill --skill user-story-mapping

Manual install

git clone --depth 1 https://github.com/tomershahar/user-story-mapping-skill.git /tmp/user-story-mapping-skill
mkdir -p ~/.claude/skills
cp -r /tmp/user-story-mapping-skill/. ~/.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

# User Story Mapping Skill

## Overview
A Claude skill for collaborative user story mapping based on Jeff Patton's methodology. Helps product teams break down requirements into structured, visual story maps with release planning — usable both as a team facilitation tool and as structured AI context.

---

## Two Modes

### Mode 1: Coaching Mode (Guided Workshop)
Walk the user step-by-step through story mapping, like a facilitator running a workshop.

**Flow:**
1. **Identify the user persona(s)** — Who is the primary user? Any secondary personas?
2. **Define the backbone (happy path)** — Ask the user to describe the high-level steps end to end. Aim for 3-7 steps.
3. **Go vertical on each step** — For each backbone step, ask deeper questions about requirements, tasks, and acceptance criteria.
4. **Go horizontal** — Expand to edge cases, error states, alternative flows.
5. **Add metadata** — Capture comments, tasks, risks per story.
6. **Define releases** — Group stories into MVP / R1 / R2 / Future.
7. **Generate output** — Produce the ASCII visual map and structured markdown.

**Coaching behavior for Claude:**
- Ask one question at a time. Don't overwhelm.
- Confirm each level before going deeper.
- Summarize back what you heard before moving on.
- Challenge assumptions: "What happens if the user does X instead?"
- Always think from the user's perspective, not the system's.
- Periodically show the evolving ASCII map so the user can see progress.

---

Read the full skill on GitHub

Details

Skill name: user-story-mapping
Repository: tomershahar/user-story-mapping-skill
License: MIT
Repo updated: 16 May 2026

FAQ

What does the User Story Mapping skill do?

Use when a user wants to create, facilitate, or generate a user story map for a product or feature — either guided step-by-step (coaching mode) or from a raw requirement (generation mode).

How do I install the User Story Mapping skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add tomershahar/user-story-mapping-skill --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 tomershahar/user-story-mapping-skill, which has 5 GitHub stars and 1 forks.

Related skills

AI Article Factory

weitzu-com/ai-article-factory

Use when the user wants to turn any material, topic, or product into publish-ready, illustrated articles — automated end-to-end (auto file → topic → schedule → draft → visuals → fact-check → multi-platform copy → export MD+Word), with a human only reviewing, confirming, and publishing. 文章自动化生产/自动写文章/图文并茂/SEO GEO优化/一稿多投/任意素材变文章

Writing & Content

Speedread Report

jordan-gibbs/speedread-skill

Turn a markdown summary/report into a pop-up RSVP speed-reader the user can consume at 500+ WPM. Use when the user asks for a report, summary, digest, or research writeup they want to "speedread", or says things like "make me a report and load it into the reader". Writes the report as markdown, injects it into a self-contained HTML reader, and opens it in the browser.

Writing & Content

Creating Squadjs Plugins

Hans-Vader/squadjs-plugin-creator-skill

Use when creating, writing, or scaffolding a new SquadJS plugin, adding a server-side feature to a Squad server via SquadJS, or deciding whether SquadJS can support a desired behaviour ("can SquadJS detect X / do Y on a Squad server?"). Covers the plugin lifecycle, the full event/RCON capability surface, and the hard limits that make some requests impossible.

Writing & Content

Seedance Storyboard

ouxxyy/storyboard-scavenger

将任何想法转换成 AI 视频分镜提示词（Kling 可灵 / Seedance 即梦 / Sora 等）。当用户想要生成视频、制作短视频、创作分镜、使用可灵/Kling、Seedance/即梦、Sora、Runway 等 AI 视频工具时调用。

Writing & Content

Dd Sdd

anatolii-iumashev/dd-sdd

Discovery–Delivery Spec-Driven Development — AI SDLC через спецификации. При запуске проверяет готовность проекта (AGENTS.md, docs/rfc/, docs/specs/, симлинки треков) и спрашивает, с какого трека начинать. Два скилла: dd-discovery (читает контекст проекта и docs/specs/, декомпозирует решение по MECE и пирамиде Минто, ставит задачу в RFC в docs/rfc/), dd-delivery (реализует по RFC с тестами, дописывает в RFC тест-инструкции, обновляет docs/specs/, уносит RFC в архив).

Writing & Content

Doc Builder

naggarwal1/doc-builder

Turn rough content into a clean, branded, responsive interactive HTML document. Trigger on "interactive doc", "HTML doc", "turn this into a doc", "make this look good", "style this", or when the user wants a document output instead of a PDF. Covers pitch decks, investor updates, sales proposals, one-pagers, articles, memos, strategy docs. Output is a single self-contained HTML file with TOC, collapsibles, slide nav for decks, and paged layouts for proposals. Works on mobile and prints cleanly.

Writing & Content

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