pm-customer-journey
Skill2 starsChanged 5 months agoMITView on GitHub
Facilitate creation of a customer journey map by guiding through actor, scenario, journey phases, actions/emotions, and opportunities. Use when the user asks to "map the customer journey", "create a journey map", "visualise the customer experience", or needs to identify pain points and improvement opportunities across an end-to-end experience.
In this repository37 other files it gives its agents.
- commercial-insightSkill
- data-requestSkill
- scenario-modelSkill
- duckdbSkill
- intelligence-internal-commsSkill
- market-intelSkill
- sql-reviewSkill
- xlsxSkill
- docxSkill
- pdfSkill
- pptxSkill
- theme-factorySkill
- utility-markitdownSkill
- thinkcellSkill
- clevel-reviewSkill
- exec-commsSkill
- partner-reviewSkill
- working-constructSkill
- route-taskSkill
- pm-exec-onboardingSkill
- pm-problem-statementSkill
- pm-proto-personaSkill
- pm-storyboardSkill
- pm-user-storySkill
- kanban-curateSkill
- epic-builderSkill
- exec-summarySkill
- steerco-packSkill
- program-trackerSkill
- weekly-reviewSkill
- book-deskSkill
- draw-excalidraw-diagramSkill
- mcp-builderSkill
- notion-workboardSkill
- smartsheetSkill
- utility-transcribeSkill
- writing-humanizerSkill
The file
We split this skill into the rules it gives an agent
2 rules. About 0 are common, 2 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 39
When you already understand the journey deeply
- Distinctive: line 47
Ask the user to share any available:
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Purpose
Guide product managers through creating a customer journey map by asking adaptive questions about the actor (persona), scenario/goal, journey phases, actions/emotions, and opportunities for improvement. Use this to visualise the end-to-end customer experience, identify pain points, and create a shared mental model across teams.
This is not a feature roadmap — it's a discovery and alignment tool.
Key Concepts
Five Key Components (NNGroup Framework)
- Actor — Specific persona whose perspective anchors the map
- Scenario + Expectations — Situational context and associated goals
- Journey Phases — High-level stages (e.g., Discover → Try → Buy → Use → Support)
- Actions, Mindsets, and Emotions — Behaviours, thoughts, emotional responses per phase
- Opportunities — Insights identifying where experience can improve
Journey Map Structure
Actor: [Persona] Scenario: [Goal/Context]
Phase 1 → Phase 2 → Phase 3 → Phase 4 → Phase 5
Actions: Actions: Actions: Actions: Actions:
Thoughts: Thoughts: Thoughts: Thoughts: Thoughts:
Emotions: Emotions: Emotions: Emotions: Emotions:
Opps: Opps: Opps: Opps: Opps:When to Use
- Starting customer discovery
- Identifying pain points for retention/engagement initiatives
- Aligning cross-functional teams on customer perspective
- Prioritising which problems to solve first
When NOT to Use
- When you already understand the journey deeply
- As a substitute for user research (maps require research input)
Application
This skill is interactive — ask one question at a time.
Step 0: Gather Context First
Ask the user to share any available:
- User interviews, discovery notes, support tickets
- Churn reasons, NPS feedback, analytics
- Personas or proto-personas
- Existing journey documentation
Question 1: Identify the Actor
"Who is the actor for this journey map?"
Offer options:
- Primary persona — main target customer
- Secondary persona — different user segment
- High-churn persona — segment with highest churn
- Newly discovered persona — emerging segment from recent research
Question 2: Define Scenario + Goal
"What's the scenario and goal — what is the actor trying to accomplish?"
Common scenarios:
- First-time use — new user onboarding, discovery to activation
- Core workflow — recurring task done regularly
- Problem resolution — user encounters issue, seeks help
- Upgrade/expansion — free user considering paid, or expanding usage
Question 3: Identify Journey Phases
Generate 4-6 journey phases based on the scenario. Present to user and ask: "Do these phases capture the full journey? Add, remove, or rename?"
Example (First-time use):
1. Discover → 2. Evaluate → 3. Try → 4. Activate → 5. Use → 6. ExpandQuestion 4: Map Actions, Thoughts, Emotions
For each phase, generate 3-5 actions, thoughts, and emotions. Show full map, then ask: "Does this capture the customer experience accurately?"
Format per phase:
Phase [N]: [Name]
Actions:
- [Action 1]
- [Action 2]
Thoughts:
- "[Quote 1]"
- "[Quote 2]"
Emotions:
- [Emotion 1] 😊/😐/😞
- [Emotion 2]
Pain Points:
- [Pain point 1]Question 5: Identify Opportunities
Generate 5-7 opportunities ranked by impact (HIGH/MEDIUM/LOW). Ask: "Do these align with your priorities? Which should we focus on first?"
Format per opportunity:
## [N]. [Opportunity Name] (Phase: [X])
**Pain Point:** [Description]
**Evidence:** [Data/research]
**Opportunity:** [Proposed improvement]
**Impact:** HIGH/MEDIUM/LOW — [Rationale]Output: Full Journey Map
# Customer Journey Map: [Scenario]
**Actor:** [Persona]
**Scenario:** [Context]
**Goal:** [What actor is trying to accomplish]
## Journey Phases
[Phase 1] → [Phase 2] → [Phase 3] → [Phase 4] → [Phase 5]
## Full Journey Map
### Phase 1: [Name]
**Actions:** ...
**Thoughts:** ...
**Emotions:** ...
**Pain Points:** ...
[repeat for all phases]
## Opportunities (Prioritised)
[ranked list]
## Next Steps
1. Validate opportunities with customer interviews
2. Prioritise using impact/effort assessment
3. Frame top opportunities as problem statements (use `pm-problem-statement`)Common Pitfalls
- Mapping internal process: Journey phases should reflect customer POV, not sales stages
- No emotions or pain points: Missing the point — emotions show where experience breaks
- Too many personas in one map: One map per persona
- Opportunities not prioritised: Rank by impact so team knows where to start
- Map created in isolation: Facilitate with cross-functional team (PM, design, engineering, support)
Related Skills
pm-proto-persona— Defines the actorpm-problem-statement— Converts opportunities into problem statements
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

