# customer-journey-map

This skill builds a customer journey map across stages, touchpoints, emotions and metrics. Useful when an experience is broken and you need to find where.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 3000 installs · ★ 7673
- Author: deanpeters
- License: CC-BY-SA-4.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/deanpeters/Product-Manager-Skills/tree/HEAD/skills/customer-journey-map/SKILL.md
- Updated: 2026-10-16
- HTML: https://affpapa.org/en/nevibecode/skills/deanpeters-customer-journey-map

## What it does

The skill walks through steps: it first asks for a persona and a scenario, then lays out the journey stage by stage, from first contact with the brand to repeat purchases. Each stage records what the customer does, where they interact, how they feel, plus KPIs, business goals and the teams that own the stage. The result is a working artifact for diagnosis and prioritisation, not a user flow diagram.

A `template.md` file holds the full fill-in structure, and the work is split into steps: prepare the inputs, set objectives, pick one persona, fill in the stages. Persona and scenario come first — without a specific actor and goal the map turns into a generic funnel. If you already passed context in the invocation, the skill skips those questions.

You need personas, a list of stages and an inventory of touchpoints before you start. If any of that is missing, run discovery interviews, persona definition or a touchpoint audit first — otherwise there is nothing to fill in. For deep product-specific workflows a story map fits better.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add deanpeters/Product-Manager-Skills --skill customer-journey-map -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/customer-journey-map/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/customer-journey-map/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add deanpeters/Product-Manager-Skills --skill customer-journey-map -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/customer-journey-map/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add deanpeters/Product-Manager-Skills --skill customer-journey-map -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/customer-journey-map/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install deanpeters/Product-Manager-Skills customer-journey-map
```

2. **Manually: put the files in place**
- File: `.github/skills/customer-journey-map/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add deanpeters/Product-Manager-Skills --skill customer-journey-map -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/deanpeters/Product-Manager-Skills --path skills/customer-journey-map
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/customer-journey-map/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add deanpeters/Product-Manager-Skills --skill customer-journey-map -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/deanpeters/Product-Manager-Skills/tree/HEAD/skills/customer-journey-map/SKILL.md

## When to use it
- lay out the customer path by stage and touchpoint
- spot pain points per stage with matching KPIs
- get marketing, sales and support onto one picture
- tie customer emotions to business goals at each stage
- work out which team owns a given stage

## Example prompts
- Map the journey for a product lead at a B2B SaaS company, from first contact to repeat purchases
- Lay out the journey for the persona "Manager Mike, Director of Product": actions, touchpoints, emotions and KPIs

## Similar
- [find-skills](https://affpapa.org/en/nevibecode/skills/find-skills.md) — skill · 4000000 installs
- [grill-me](https://affpapa.org/en/nevibecode/skills/grill-me.md) — skill · 1424476 installs
- [grill-with-docs](https://affpapa.org/en/nevibecode/skills/grill-with-docs.md) — skill · 1219756 installs
- [handoff](https://affpapa.org/en/nevibecode/skills/handoff.md) — skill · 1038491 installs
- [grilling](https://affpapa.org/en/nevibecode/skills/grilling.md) — skill · 979543 installs
- [teach](https://affpapa.org/en/nevibecode/skills/teach.md) — skill · 862247 installs

## Other versions with the same name
- [customer-journey-map · phuryn](https://affpapa.org/en/nevibecode/skills/customer-journey-map.md) — 3100 installs

From the same set: [deanpeters/product-manager-skills](https://affpapa.org/en/nevibecode/by/deanpeters/product-manager-skills.md) — 69 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md