customer-journey-map

deanpeters/product-manager-skills · updated Apr 8, 2026

MDX-style export adds YAML metadata + attribution linking explainx.ai and this canonical listing URL.

$npx skills add https://github.com/deanpeters/product-manager-skills --skill customer-journey-map
0 commentsdiscussion
summary

Visualize customer interactions across all stages—from awareness to loyalty—with documented actions, touchpoints, emotions, KPIs, and team ownership.

  • Maps five core stages (Awareness, Consideration, Decision, Service, Loyalty) with customer actions, emotions, touchpoints, business goals, and responsible teams for each
  • Combines customer empathy with measurable KPIs to identify pain points and align cross-functional teams on the end-to-end experience
  • Requires upfront persona definition
skill.md

Purpose

Create a comprehensive customer journey map that visualizes how customers interact with your brand across all stages—from awareness to loyalty—documenting their actions, touchpoints, emotions, KPIs, business goals, and teams involved at each stage. Use this to identify pain points, align cross-functional teams, and systematically improve the customer experience to achieve business objectives.

This is not a user flow diagram—it's a strategic artifact that combines customer empathy with business metrics to drive actionable improvements.

Key Concepts

The Customer Journey Mapping Framework

Adapted from NNGroup's framework and Carnegie Mellon's PM curriculum, a customer journey map documents:

Horizontal structure (stages):

  • Awareness: Customer first learns about your brand
  • Consideration: Customer evaluates your offering
  • Decision: Customer makes a purchase
  • Service: Customer uses the product/service post-purchase
  • Loyalty: Customer becomes a repeat buyer and advocate

Vertical structure (for each stage):

  • Customer Actions: What customers do
  • Touchpoints: Where/how they interact with your brand
  • Customer Experience: Emotions and thoughts
  • KPIs: Metrics to measure success
  • Business Goals: What you're trying to achieve
  • Teams Involved: Who owns this stage

Why This Works

  • Empathy-driven: Centers on customer emotions, not just actions
  • Cross-functional alignment: Shows which teams affect which stages
  • Metric-focused: Ties customer experience to measurable outcomes
  • Gap identification: Makes pain points and opportunities visible
  • Actionable: Clear KPIs and goals enable prioritization

Anti-Patterns (What This Is NOT)

  • Not a user story map: Journey maps are broader (all touchpoints, not just product use)
  • Not a service blueprint: Less detailed on internal processes, more focused on customer experience
  • Not static: Journey maps evolve as customer behavior changes

When to Use This

  • Understanding customer experience across all touchpoints (not just product)
  • Aligning cross-functional teams (marketing, sales, product, support)
  • Identifying pain points and prioritizing improvements
  • Onboarding new team members to customer perspective
  • Auditing the end-to-end customer experience

When NOT to Use This

  • For deep product-specific workflows (use story mapping instead)
  • Before defining personas (need to know who you're mapping)
  • As a one-time exercise (journey maps require ongoing updates)

Application

Use template.md for the full fill-in structure.

Step 1: Prepare Prerequisites

Before mapping, ensure you have:

  1. Key stakeholders: Marketing, sales, product, customer service representatives
  2. Buyer personas: Detailed personas with demographics, psychographics, goals, challenges (reference skills/proto-persona/SKILL.md)
  3. Defined stages: Main stages of your buying process (typically: Awareness, Consideration, Decision, Service, Loyalty)
  4. Touchpoint inventory: All places customers interact with your brand (website, social, email, store, support, etc.)

If missing: Run discovery interviews, persona definition work, or touchpoint audits first.


Step 2: Set Clear Objectives

Define what you want to achieve:

## Objectives
- [Goal 1: e.g., "Identify top 3 pain points causing drop-off between Awareness and Consideration"]
- [Goal 2: e.g., "Align marketing and sales on customer motivations at each stage"]
- [Goal 3: e.g., "Understand emotional journey to inform messaging strategy"]

Quality checks:

  • Specific: Not "understand customers" but "identify drop-off causes in Consideration stage"
  • Actionable: Results should inform decisions, not just document observations

Step 3: Choose a Buyer Persona

Select one persona to focus on (create separate maps for each persona):

## Persona
- [Persona name and brief description]
- [Example: "Manager Mike: 35-42, Director of Product at mid-sized B2B SaaS, struggles with data-driven prioritization, values time savings over feature depth"]

Why one persona per map: Different personas have different journeys. Mixing them creates confusion.


Step 4: Map Each Stage

For each stage (Awareness, Consideration, Decision, Service, Loyalty), document:

Customer Actions

What customers do at this stage:

### Stage: [Stage Name, e.g., Awareness]

**Customer Actions:**
- [Action 1: e.g., "See LinkedIn ad about product management tools"]
- [Action 2: e.g., "Hear about tool from PM peer at conference"]
- [Action 3: e.g., "Google 'best product roadmap software'"]

Quality checks:

  • Observable: You can see or measure this action
  • Specific: Not "research products" but "Google 'best roadmap software' and read comparison articles"

Touchpoints

Where/how customers interact with your brand:

**Touchpoints:**
- [Touchpoint 1: e.g., "LinkedIn Ads"]
- [Touchpoint 2: e.g., "Word-of-mouth at PM conferences"]
- [Touchpoint 3: e.g., "Google organic search results"]
- [Touchpoint 4: e.g., "Review sites (G2, Capterra)"]

Quality checks:

  • Comprehensive: Include both digital and physical touchpoints
  • Specific: Not "social media" but "LinkedIn Ads," "Twitter mentions," etc.

Customer Experience

Emotions and thoughts customers have:

**Customer Experience:**
- [Emotion 1: e.g., "Curious but skeptical—'Is this actually better than spreadsheets?'"]
- [Emotion 2: e.g., "Overwhelmed by options—'Too many tools, how do I choose?'"]
- [Emotion 3: e.g., "Hopeful but cautious—'Could this save me time?'"]

Quality checks:

  • Authentic: Use customer quotes from research when possible
  • Emotional: Capture feelings, not just thoughts
  • Specific: Not "interested" but "curious but skeptical—worried about setup time"

KPIs

Key performance indicators for this stage:

**KPIs:**
- [KPI 1: e.g., "Brand awareness (measured via surveys)"]
- [KPI 2: e.g., "LinkedIn ad impressions: 100k/month"]
- [KPI 3: e.g., "Organic search traffic: 5k visitors/month"]
- [KPI 4: e.g., "G2 review views: 2k/month"]

Quality checks:

  • Measurable: Can you track this?
  • Stage-appropriate: Awareness KPIs differ from Decision KPIs

Business Goals

What you're trying to achieve at this stage:

**Business Goals:**
- [Goal 1: e.g., "Increase brand awareness among PMs at B2B SaaS companies"]
- [Goal 2: e.g., "Generate 500 qualified leads/month"]
- [Goal 3: e.g., "Position as top 3 roadmap tool in G2 rankings"]

Quality checks:

  • Outcome-focused: Not "run ads" but "increase brand awareness"
  • Aligned with stage: Don't expect conversions at Awareness stage

Teams Involved

Who owns this stage:

**Teams Involved:**
- [Team 1: e.g., "Marketing (ad campaigns, SEO)"]
- [Team 2: e.g., "Content (blog posts, comparison guides)"]
- [Team 3: e.g., "Customer Success (case studies, testimonials)"]

Quality checks:

  • Cross-functional: Multiple teams usually touch each stage
  • Specific roles: Not just "marketing" but "marketing (ad campaigns, SEO)"

Step 5: Visualize the Map

Create a table or visual diagram:

Stage Awareness Consideration Decision Service Loyalty
Customer Actions See ad, hear from peers, Google search Compare features, read reviews, request demo Free trial signup, test with real data, evaluate ROI Onboard team, build first roadmap, integrate with Jira Use daily, recommend to peers, share wins on LinkedIn
Touchpoints LinkedIn Ads, conferences, Google, review sites Website, demo calls, sales emails Product (free trial), onboarding emails Product, support chat, knowledge base Product, community forums, customer success check-ins
Customer Experience Curious but skeptical Excited but overwhelmed by options Anxious about setup time, hopeful about time savings Relieved if easy, frustrated if complex Satisfied and confident, proud of wins
KPIs Impressions: 100k/month, traffic: 5k/month Demo requests: 100/month, trial signups: 50/month Conversion rate: 20%, time-to-value: <2 hours Activation rate: 70%, support ticket volume Retention rate: 85%, NPS: 50, referral rate: 15%
Business Goals Increase brand awareness, generate 500 leads/month Improve lead quality, reduce sales cycle to 30 days Increase trial-to-paid conversion, optimize onboarding Reduce churn, improve activation, minimize support costs Increase LTV, generate referrals, upsell premium features
Teams Involved Marketing, Content Marketing, Sales, Product Sales, Product, Onboarding Product, Support, Customer Success Product, Customer Success, Marketing

Step 6: Analyze and Prioritize

Review the map and ask:

  1. Where are the biggest pain points? (Look for negative emotions + high drop-off rates)
  2. Which stages have the weakest KPIs? (Prioritize low-performing stages)
  3. Are teams aligned? (Do teams understand their role in each stage?)
  4. What opportunities exist? (Where can small improvements create big impact?)

Prioritization criteria:

  • Impact: How much would fixing this improve the customer experience?
  • Feasibility: How easy is this to fix?
  • Alignment: Does this support business goals?

Step 7: Test and Refine

  • Update regularly: Customer behavior changes—revisit the map quarterly
  • Validate with data: Use analytics, surveys, and customer interviews to confirm assumptions
  • Track improvements: After making changes, measure impact on KPIs

Examples

See examples/sample.md for a full customer journey map example. See examples/meta-product-manager-skills.md for a meta dogfooding example mapping this repository's own customer journey.

Mini example excerpt:

| **Stage** | **Awareness** | **Consideration** | **Decision** |
| **Customer Actions** | Sees LinkedIn ad | Compares on G2 | Starts free trial |
| **Customer Experience** | Curious but skeptical | Overwhelmed | Anxious about setup |

Common Pitfalls

Pitfall 1: Generic Emotions

Symptom: "Customer feels happy" or "Customer is satisfied"

Consequence: No insight into why they feel that way or what to improve.

Fix: Be specific: "Relieved that setup took 30 minutes, not 3 hours as feared."


Pitfall 2: Missing Touchpoints

Symptom: Only documenting digital touchpoints (website, app)

Consequence: Miss offline interactions (conferences, word-of-mouth, support calls).

Fix: Include all touchpoints: physical, digital, human, and automated.


Pitfall 3: Internal Perspective

Symptom: Mapping what you want customers to do, not what they actually do

Consequence: Journey map reflects wishful thinking, not reality.

Fix: Validate with customer research, analytics, and support tickets.


Pitfall 4: No KPIs or Goals

Symptom: Journey map has actions and emotions but no metrics or business objectives

Consequence: No way to measure success or prioritize improvements.

Fix: Add KPIs and business goals for each stage. Make them measurable.


Pitfall 5: One-and-Done Exercise

Symptom: Journey map created once, never updated

Consequence: Map becomes outdated as customer behavior evolves.

Fix: Review quarterly. Update based on new data, product changes, or market shifts.


References

Related Skills

  • skills/proto-persona/SKILL.md — Defines the persona for the journey map
  • skills/jobs-to-be-done/SKILL.md — Informs customer actions and goals
  • skills/problem-statement/SKILL.md — Identifies pain points at each stage
  • skills/user-story-mapping/SKILL.md — Complementary (story mapping focuses on product usage, journey mapping covers all touchpoints)

External Frameworks

  • NNGroup, Customer Journey Mapping (2016) — Foundational framework
  • Carnegie Mellon University, Product Management Curriculum — Academic approach
  • Chris Risdon & Patrick Quattlebaum, Orchestrating Experiences (2018) — Journey mapping for service design

Dean's Work

  • Customer Journey Mapping Prompt Template (adapted from NNGroup and CMU frameworks)

Provenance

  • Adapted from prompts/customer-journey-mapping-prompt-template.md in the https://github.com/deanpeters/product-manager-prompts repo.

Skill type: Component Suggested filename: customer-journey-map.md Suggested placement: /skills/components/ Dependencies: References skills/proto-persona/SKILL.md, skills/jobs-to-be-done/SKILL.md, skills/problem-statement/SKILL.md

how to use customer-journey-map

How to use customer-journey-map on Cursor

AI-first code editor with Composer

1

Prerequisites

Before installing skills in Cursor, ensure your development environment meets these requirements:

  • Cursor installed and configured on your development machine
  • Node.js version 16.0+ with npm package manager (verify with node --version)
  • Active project directory or workspace where you want to add customer-journey-map
2

Execute installation command

Execute the skills CLI command in your project's root directory to begin installation:

$npx skills add https://github.com/deanpeters/product-manager-skills --skill customer-journey-map

The skills CLI fetches customer-journey-map from GitHub repository deanpeters/product-manager-skills and configures it for Cursor.

3

Select Cursor when prompted

The CLI will show a list of available agents. Use arrow keys to navigate and space to select Cursor:

◆ Which agents do you want to install to?
│ ── Universal (.agents/skills) ── always included ────
│ • Amp
│ • Antigravity
│ • Cline
│ • Codex
│ ●Cursor(selected)
│ • Cursor
│ • Windsurf
4

Verify installation

Confirm successful installation by checking the skill directory location:

.cursor/skills/customer-journey-map

Reload or restart Cursor to activate customer-journey-map. Access the skill through slash commands (e.g., /customer-journey-map) or your agent's skill management interface.

Security & Verification Notice

We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.

Skills execute code in your development environment. Always verify the publisher's identity, review recent commits, and test in isolated environments before production deployment.

List & Monetize Your Skill

Submit your Claude Code skill and start earning

GET_STARTED →

Use Cases

User Story & Requirements Generation

Create detailed user stories, acceptance criteria, and feature specs

Example

Generate user stories for 'password reset feature' with acceptance criteria, edge cases, and test scenarios

Reduce spec writing time by 50%, ensure comprehensive coverage

Competitive Analysis

Research competitors, compare features, identify gaps

Example

Analyze 5 competitor products, create feature comparison matrix, suggest differentiation opportunities

Complete competitive research in 2 hours instead of 2 days

Roadmap Prioritization

Evaluate features using frameworks (RICE, ICE, Kano) and create prioritized backlogs

Example

Score 20 feature ideas using RICE framework, generate prioritized roadmap with rationale

Make data-driven prioritization decisions faster

Stakeholder Communication

Draft PRDs, status updates, and stakeholder presentations

Example

Create executive summary of Q3 roadmap, monthly progress report, feature launch announcement

Save 3-5 hours/week on communication overhead

Implementation Guide

Prerequisites

  • Claude Desktop or compatible AI client
  • Access to product documentation and roadmap tools (Jira, Notion, etc.)
  • Understanding of product management frameworks (RICE, Jobs-to-be-Done, etc.)
  • Stakeholder contact information and communication channels

Time Estimate

30-60 minutes to see productivity improvements

Installation Steps

  1. 1.Install product management skill
  2. 2.Start with user story generation for known feature
  3. 3.Progress to competitive analysis: research 2-3 competitors
  4. 4.Use for roadmap prioritization: apply RICE/ICE scoring
  5. 5.Draft stakeholder communications and refine based on feedback
  6. 6.Build template library for recurring PM tasks
  7. 7.Share effective prompts with product team

Common Pitfalls

  • Not validating competitive research—verify facts before sharing
  • Accepting user stories without involving engineering team
  • Over-relying on frameworks without qualitative judgment
  • Not customizing outputs to company culture and communication style
  • Skipping stakeholder validation of generated requirements

Best Practices

✓ Do

  • +Validate research and competitive analysis with real data
  • +Collaborate with engineering when generating technical requirements
  • +Customize frameworks and templates to your company context
  • +Use skill for first drafts, refine with stakeholder input
  • +Document successful prompt patterns for PM tasks
  • +Combine AI efficiency with human judgment and intuition

✗ Don't

  • Don't publish competitive analysis without fact-checking
  • Don't finalize user stories without engineering review
  • Don't make prioritization decisions solely on AI scoring
  • Don't skip customer validation of generated requirements
  • Don't ignore company-specific context and culture

💡 Pro Tips

  • Provide context: company goals, constraints, customer feedback
  • Ask for alternatives: 'Show 3 ways to prioritize this roadmap'
  • Request stakeholder-specific formatting: 'Executive summary vs. engineering spec'
  • Use skill for 70% generation + 30% customization to company needs

When to Use This

✓ Use When

Use for user story writing, competitive research, roadmap prioritization, stakeholder communication, and PRD drafting. Best for reducing repetitive documentation and research work.

✗ Avoid When

Avoid for strategic product vision (requires deep customer empathy), pricing decisions (needs market and financial expertise), or when face-to-face customer discovery is more valuable than speed.

Learning Path

  1. 1Basic: user stories, feature specs, status updates
  2. 2Intermediate: competitive analysis, prioritization frameworks, PRDs
  3. 3Advanced: product strategy, go-to-market planning, OKR setting
  4. 4Expert: product vision, market positioning, business model innovation

Discussion

Product Hunt–style comments (not star reviews)
  • No comments yet — start the thread.
general reviews

Ratings

4.652 reviews
  • Valentina Jackson· Dec 24, 2024

    customer-journey-map has been reliable in day-to-day use. Documentation quality is above average for community skills.

  • Ama Park· Dec 4, 2024

    Registry listing for customer-journey-map matched our evaluation — installs cleanly and behaves as described in the markdown.

  • Chen Okafor· Dec 4, 2024

    Solid pick for teams standardizing on skills: customer-journey-map is focused, and the summary matches what you get after install.

  • Rahul Santra· Nov 27, 2024

    Registry listing for customer-journey-map matched our evaluation — installs cleanly and behaves as described in the markdown.

  • Zaid Ndlovu· Nov 23, 2024

    I recommend customer-journey-map for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.

  • Fatima Brown· Nov 15, 2024

    Useful defaults in customer-journey-map — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.

  • Pratham Ware· Oct 18, 2024

    customer-journey-map reduced setup friction for our internal harness; good balance of opinion and flexibility.

  • Liam Malhotra· Oct 14, 2024

    Useful defaults in customer-journey-map — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.

  • Fatima Okafor· Oct 6, 2024

    I recommend customer-journey-map for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.

  • Olivia Ghosh· Sep 25, 2024

    Keeps context tight: customer-journey-map is the kind of skill you can hand to a new teammate without a long onboarding doc.

showing 1-10 of 52

1 / 6