Agent skill
user-journey-mapping
Create comprehensive user journey maps that identify pain points, opportunities, and emotional states across touchpoints. Use when mapping user experiences or analyzing conversion flows.
Install this agent skill to your Project
npx add-skill https://github.com/NickCrew/Claude-Cortex/tree/main/skills/user-journey-mapping
SKILL.md
User Journey Mapping
Comprehensive guide to creating user journey maps that reveal pain points, opportunities, and emotional states across the entire user experience.
When to Use This Skill
- Mapping end-to-end user experiences
- Identifying conversion funnel drop-off points
- Understanding emotional states during key interactions
- Discovering optimization opportunities
- Aligning teams around user perspective
Quick Reference
| Task | Load reference |
|---|---|
| Research Methods | skills/user-journey-mapping/references/research-methods.md |
Journey Map Components
1. Stages
Define the major phases users go through:
Awareness → Consideration → Decision → Onboarding → Usage → Advocacy
2. User Actions
What the user does at each stage:
- Searches, browses, compares
- Signs up, configures, learns
- Uses features, seeks help
- Shares, recommends, upgrades
3. Touchpoints
Where interaction happens:
- Website, mobile app, email
- Support chat, documentation
- Social media, reviews
- In-person, phone
4. Emotions
How users feel (use emoticons or scale):
😊 Delighted → 😐 Neutral → 😤 Frustrated → 😡 Angry
5. Pain Points
Where friction occurs:
- Confusion, delays, errors
- Missing information
- Poor feedback
- Technical issues
6. Opportunities
Where we can improve:
- Quick wins
- Major improvements
- Innovation opportunities
Journey Map Template
## User Journey: [Persona Name] - [Goal]
### Stage 1: [Stage Name]
**User Goal**: [What they're trying to achieve]
**Actions**:
- [Action 1]
- [Action 2]
**Touchpoints**: [Where interaction happens]
**Emotions**: [😊/😐/😤/😡] - [Why they feel this way]
**Pain Points**:
- [Pain point with impact]
**Opportunities**:
- [Opportunity with potential impact]
**Metrics**: [How we measure this stage]
---
[Repeat for each stage]
Example Journey Map
E-commerce Checkout Journey
| Stage | Awareness | Cart | Checkout | Payment | Confirmation |
|---|---|---|---|---|---|
| Actions | Browse, compare | Add items, review | Enter details | Pay | Receive |
| Emotions | 😊 Excited | 😐 Considering | 😤 Tedious | 😰 Anxious | 😊 Relieved |
| Pain Points | Too many options | Price unclear | Too many fields | Security fears | No ETA |
| Opportunities | Recommendations | Clear pricing | Autofill | Trust signals | Tracking |
Best Practices
Do's
- Base on real user research, not assumptions
- Include both digital and non-digital touchpoints
- Map emotional highs and lows
- Quantify with metrics where possible
- Involve cross-functional stakeholders
Don'ts
- Don't map the ideal journey - map reality
- Don't focus only on your touchpoints
- Don't ignore competitor alternatives
- Don't skip the "boring" stages
- Don't create and forget - iterate
Integration with Design
- Identify critical moments: Where do emotions shift?
- Prioritize pain points: Impact × Frequency matrix
- Design interventions: Targeted improvements
- Measure success: Before/after metrics
- Iterate: Journey maps are living documents
Resources
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
claude-consult
Consult Claude specialist agents during implementation for codebase understanding, pattern checking, security review, debugging help, and more. Use this skill whenever you're unsure about conventions, stuck on a failure, or need expert input before writing code. Does not replace the formal review gates in agent-loops — this is for mid-implementation consultation.
doc-quality-review
Assess documentation quality across readability, consistency, audience fit, and prose clarity. Produces a scored review with actionable findings. This skill should be used before releases, during doc reviews, or when documentation feels unclear or inconsistent.
event-driven-architecture
Event-driven architecture patterns with event sourcing, CQRS, and message-driven communication. Use when designing distributed systems, microservices communication, or systems requiring eventual consistency and scalability.
prompt-engineering
Optimize prompts for LLMs and AI systems with structured techniques, evaluation patterns, and synthetic test data generation. Use when building AI features, improving agent performance, or crafting system prompts.
compliance-audit
Regulatory compliance auditing across GDPR, HIPAA, PCI DSS, SOC 2, and ISO frameworks with automated evidence collection and gap analysis. Use when conducting compliance assessments, preparing for certifications, or implementing regulatory controls.
react-performance-optimization
React performance optimization patterns using memoization, code splitting, and efficient rendering strategies. Use when optimizing slow React applications, reducing bundle size, or improving user experience with large datasets.
Didn't find tool you were looking for?