Facilitate a structured workshop to map customer journeys, identify pain points, and align teams on experience improvements.
Works with
Guides you through five adaptive questions covering persona selection, scenario definition, journey phases, actions/emotions/thoughts per phase, and opportunity prioritization
Generates a complete journey map artifact with 4–6 phases, customer emotions and pain points per phase, and 5–7 ranked improvement opportunities tied to specific phases
Designed for disco
AI-first code editor with Composer
Before installing skills in Cursor, ensure your development environment meets these requirements:
node --versioncustomer-journey-mapping-workshopExecute the skills CLI command in your project's root directory to begin installation:
Fetches customer-journey-mapping-workshop from deanpeters/product-manager-skills and configures it for Cursor.
The CLI shows a list of agents. Use arrow keys and space to select Cursor:
Confirm successful installation by checking the skill directory location:
Restart Cursor to activate customer-journey-mapping-workshop. Access via /customer-journey-mapping-workshop in your agent's command palette.
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 environment. Always review source, verify the publisher, and test in isolation before production.
Submit your Claude Code skill and start earning
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
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
Evaluate features using frameworks (RICE, ICE, Kano) and create prioritized backlogs
Example
Score 20 feature ideas using RICE framework, generate prioritized roadmap with rationale
0
total installs
0
this week
3.1K
GitHub stars
0
upvotes
Run in your terminal
0
installs
0
this week
3.1K
stars
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 visualize the end-to-end customer experience, identify pain points, and create a shared mental model across teams—avoiding surface-level feature lists and ensuring discovery work focuses on real customer problems, not assumed solutions.
This is not a feature roadmap—it's a discovery and alignment tool that uncovers where the experience breaks down and where improvements will have the greatest impact.
A journey map (NNGroup) visualizes "the process that a person goes through in order to accomplish a goal." It compiles user actions into a timeline, enriched with thoughts and emotions to create a narrative, then condenses and polishes into a visual artifact.
Actor: [Persona Name]
Scenario: [Goal/Context]
Phase 1: Discover → Phase 2: Try → Phase 3: Buy → Phase 4: Use → Phase 5: Support
↓ ↓ ↓ ↓ ↓
Actions: Actions: Actions: Actions: Actions:
Thoughts: Thoughts: Thoughts: Thoughts: Thoughts:
Emotions: 😊😐😞 Emotions: Emotions: Emotions: Emotions:
↓ ↓ ↓ ↓ ↓
Opportunities: Opportunities: Opportunities: Opportunities: Opportunities:
Use workshop-facilitation as the default interaction protocol for this skill.
It defines:
Other (specify) when useful)This file defines the domain-specific assessment content. If there is a conflict, follow this file's domain logic.
This interactive skill asks up to 5 adaptive questions, offering 3-4 enumerated options at each step.
Interaction pattern: Pair with skills/workshop-facilitation/SKILL.md when you want a one-step-at-a-time flow with numbered recommendations at decision points and quick-select options for regular questions. If the user asks for a single-shot output, skip the multi-turn facilitation.
Agent suggests:
Before we create your journey map, let's gather context:
Customer Research:
Product Context:
You can paste this content directly, or describe the customer experience briefly.
Agent asks: "Who is the actor for this journey map? (Which persona or user segment?)"
Offer 4 enumerated options:
Or describe your specific persona.
Adaptation: Use personas from context (proto-personas, JTBD research, etc.)
User response: [Selection or custom]
Agent asks: "What's the scenario and goal for this journey? (What is the actor trying to accomplish?)"
Offer 4 enumerated options:
Or describe your specific scenario.
User response: [Selection or custom]
Agent extracts:
Agent says: "Let's break the journey into high-level phases (typically 4-6 phases from start to end)."
Agent generates 4-6 journey phases based on scenario (Q2).
Example (if Scenario = "First-time use"):
Journey Phases (left to right):
1. Discover — User learns about product
2. Evaluate — User researches, compares alternatives
3. Try — User signs up, starts onboarding
4. Activate — User reaches "aha moment," experiences value
5. Use — User integrates product into workflow
6. Expand — User considers upgrading or inviting team
Agent asks: "Do these phases capture the full journey? Should we add, remove, or rename phases?"
User response: [Approve or modify]
Agent says: "Now let's map what the actor does, thinks, and feels in each phase."
Agent generates 3-5 actions, thoughts, and emotions per phase based on context (Step 0) and scenario (Q2).
Example (for Phase 3: "Try — User signs up, starts onboarding"):
Phase 3: Try (Onboarding)
Actions:
- Signs up with email
- Receives welcome email
- Logs in for the first time
- Sees empty dashboard
- Searches for "getting started" guide
Thoughts:
- "This looks promising, but I'm not sure where to start"
- "Do I need to watch a tutorial video?"
- "What's the first step?"
Emotions:
- Curious but uncertain 🤔
- Slightly frustrated (no clear next step) 😕
- Hopeful it will get easier 🙂
Pain Points:
- No onboarding checklist or guided tour
- Empty state doesn't suggest next action
- Too many options in navigation (overwhelming)
Agent repeats for all journey phases, showing full map.
Agent asks: "Does this capture the customer experience accurately? Should we adjust actions, thoughts, or emotions?"
User response: [Approve or modify]
Agent says: "Based on the journey map, let's identify opportunities for improvement—ranked by impact."
Agent generates 5-7 opportunities (pain points with highest emotional intensity or drop-off rates).
Example:
# Opportunities (Ranked by Impact)
## 1. Onboarding lacks guided first steps (Phase 3: Try)
**Pain Point:** Users see empty dashboard, don't know what to do first
**Evidence:** 60% of signups don't complete first action within 24 hours
**Opportunity:** Add interactive onboarding checklist ("Create your first project," "Invite a teammate")
**Impact:** HIGH — Directly affects activation rate
---
## 2. Pricing page is confusing (Phase 2: Evaluate)
**Pain Point:** Users don't understand which plan fits their needs
**Evidence:** High bounce rate on pricing page (70% leave without signing up)
**Opportunity:** Add plan comparison tool or "Which plan is right for me?" quiz
**Impact:** HIGH — Directly affects trial conversion
---
## 3. Support is hard to find (Phase 5: Use)
**Pain Point:** Users encounter issues, struggle to find help
**Evidence:** Support tickets often say "I couldn't find an answer in docs"
**Opportunity:** Add in-app help widget, contextual tooltips
**Impact:** MEDIUM — Affects retention, but fewer users hit this phase
---
## 4. Email confirmations lack context (Phase 1: Discover)
**Pain Point:** Marketing emails don't explain value clearly
**Evidence:** Low click-through rate on email campaigns (5% vs. industry avg 15%)
**Opportunity:** Rewrite emails with customer language, clear CTAs
**Impact:** MEDIUM — Affects top-of-funnel awareness
---
## 5. Upgrade prompts feel pushy (Phase 6: Expand)
**Pain Point:** Users perceive upgrade prompts as sales-y, not helpful
**Evidence:** Negative sentiment in NPS comments ("too many upgrade popups")
**Opportunity:** Show upgrade value contextually (when user hits free plan limit)
**Impact:** LOW — Affects smaller user subset
Agent asks: "Do these opportunities align with your priorities? Which should we focus on first?"
User response: [Selection or custom]
After completing the flow, the agent outputs:
# Customer Journey Map: [Scenario from Q2]
**Actor:** [Persona from Q1]
**Scenario:** [Context from Q2]
**Goal:** [What actor is trying to accomplish]
**Date:** [Today's date]
---
## Journey Phases
[Phase 1] → [Phase 2] → [Phase 3] → [Phase 4] → [Phase 5] → [Phase 6]
---
## Full Journey Map
### Phase 1: [Name]
**Actions:**
- [Action 1]
- [Action 2]
- [Action 3]
**Thoughts:**
- "[Quote 1]"
- "[Quote 2]"
**Emotions:**
- [Emotion 1] 😊
- [Emotion 2] 😐
**Pain Points:**
- [Pain point 1]
- [Pain point 2]
---
### Phase 2: [Name]
[...repeat structure for all phases...]
---
## Opportunities (Prioritized)
### Opportunity 1: [Name] (HIGH IMPACT)
**Phase:** [Journey phase]
**Pain Point:** [Description]
**Evidence:** [Data/research]
**Proposed Solution:** [How to address]
**Impact:** HIGH — [Rationale]
---
### Opportunity 2: [Name] (HIGH IMPACT)
**Phase:** [Journey phase]
**Pain Point:** [Description]
**Evidence:** [Data/research]
**Proposed Solution:** [How to address]
**Impact:** HIGH — [Rationale]
---
[...continue for all opportunities...]
---
## Next Steps
1. **Validate opportunities:** Use `discovery-interview-prep.md` to test hypotheses with customers
2. **Prioritize fixes:** Use `prioritization-advisor.md` to choose which opportunities to tackle first
3. **Create problem statements:** Use `problem-statement.md` to frame top opportunities
4. **Build experiments:✓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
Steps
- 1Install product management skill
- 2Start with user story generation for known feature
- 3Progress to competitive analysis: research 2-3 competitors
- 4Use for roadmap prioritization: apply RICE/ICE scoring
- 5Draft stakeholder communications and refine based on feedback
- 6Build template library for recurring PM tasks
- 7Share 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
- 1Basic: user stories, feature specs, status updates
- 2Intermediate: competitive analysis, prioritization frameworks, PRDs
- 3Advanced: product strategy, go-to-market planning, OKR setting
- 4Expert: product vision, market positioning, business model innovation
Related Skills
grill-me
648mattpocock/skills
Productivitysame categorypremortem
214parcadei/continuous-claude-v3
Productivitysame categorydeslop
159cursor/plugins
Productivitysame categorytravel-planner
136ailabs-393/ai-labs-claude-skills
Productivitysame categoryframer-motion
131pproenca/dot-skills
Productivitysame categorywrite-a-prd
128mattpocock/skills
Productivitysame categoryReviews
4.7★★★★★54 reviews- JJames Dixit★★★★★Dec 28, 2024
customer-journey-mapping-workshop fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.
- PPratham Ware★★★★★Dec 20, 2024
customer-journey-mapping-workshop has been reliable in day-to-day use. Documentation quality is above average for community skills.
- SSofia Ramirez★★★★★Dec 16, 2024
Keeps context tight: customer-journey-mapping-workshop is the kind of skill you can hand to a new teammate without a long onboarding doc.
- NNaina Khan★★★★★Dec 12, 2024
customer-journey-mapping-workshop is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.
- NNikhil Perez★★★★★Nov 19, 2024
We added customer-journey-mapping-workshop from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.
- SSakshi Patil★★★★★Nov 11, 2024
Keeps context tight: customer-journey-mapping-workshop is the kind of skill you can hand to a new teammate without a long onboarding doc.
- JJames Desai★★★★★Nov 7, 2024
customer-journey-mapping-workshop has been reliable in day-to-day use. Documentation quality is above average for community skills.
- HHassan Robinson★★★★★Nov 3, 2024
Useful defaults in customer-journey-mapping-workshop — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.
- NNikhil Ndlovu★★★★★Oct 26, 2024
customer-journey-mapping-workshop fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.
- AAmelia Johnson★★★★★Oct 22, 2024
Registry listing for customer-journey-mapping-workshop matched our evaluation — installs cleanly and behaves as described in the markdown.
showing 1-10 of 54
1 / 6Discussion
Comments — not star reviews- No comments yet — start the thread.