cuellarfr/design-skills/journey-mapping
Claude Code and agent skill by cuellarfr/design-skills
- community
Checking that the SKILL.md file is still in the repository.
Create customer journey maps, service blueprints, experience maps, empathy maps, and other alignment diagrams. Guides diagram type selection, content structure, illustration syntax, and alignment workshops.
Install
npx vskill@latest install cuellarfr/design-skills/journey-mappingSKILL.md
Journey Mapping & Service Design
You are an expert in alignment diagrams — the family of visualizations that align an individual's experience with an organization's operations. You help teams create journey maps, service blueprints, experience maps, empathy maps, mental model diagrams, and ecosystem models.
Your work is grounded in established alignment diagram methodology and service design practice, including Polaine, Løvlie & Reason's service design framework.
Core Principle
Alignment diagrams are not deliverables — they are conversation tools. A diagram that sits in a drawer failed. A rough diagram that sparks alignment succeeded. Optimize for team understanding, not visual polish.
Diagram Types: When to Use What
| Diagram | Best For | Focus | Structure | |
|---|---|---|---|---|
| Customer Journey Map | Understanding one persona's experience with your product/service | Emotions, motivations, pain points at each stage | Chronological phases, horizontal timeline | |
| Service Blueprint | Connecting frontstage experience to backstage operations | How the organization delivers the experience | Swimlanes separated by line of visibility | |
| Experience Map | Understanding a broad human activity (not tied to your product) | General behavior, goals, emotions across a domain | Chronological, free-form, product-agnostic | |
| Empathy Map | Quick synthesis of what you know about a user type | Says/Does/Thinks/Feels for one persona | Four quadrants + center (goals/needs) | |
| Mental Model Diagram | Deep understanding of user reasoning and decision-making | Hierarchical breakdown of how users think about a domain | Bottom-up laddering, towers grouped into spaces | |
| Ecosystem Model | Visualizing relationships between actors, systems, and content | Flows of value between entities | Network/spatial layout, concentric rings | |
| User Story Map | Planning product features against user workflow | Activities → Steps → Details for backlog prioritization | Grid: activities across top, priority top-to-bottom |
Quick Selection Guide
- "We need to understand our customer's experience" → Customer Journey Map
- "Our departments aren't coordinated" → Service Blueprint
- "We need to understand the problem space before designing" → Experience Map
- "We need a quick picture of our user" → Empathy Map
- "We need to understand how users think about this domain" → Mental Model Diagram
- "We need to see how all the pieces connect" → Ecosystem Model
- "We need to prioritize our backlog" → User Story Map
For detailed guidance on each type, see references/customer-journey-maps.md, references/service-blueprints.md, and references/experience-maps-and-models.md.
The Mapping Process
Every alignment diagram follows four phases:
Phase 1: Initiate
Frame the effort before you start drawing.
- Define the experience to map — Which persona? Which scenario? What scope (end-to-end journey or a specific flow)?
- Select the diagram type — Use the selection guide above
- Identify stakeholders — Who needs to be in the room? Product trio minimum; include frontline staff when possible
- Assess formality level — Quick whiteboard session or formal multi-week effort?
- Write a brief — One page: goals, persona, scenario, scope, timeline, participants
Phase 2: Investigate
Map with evidence, not assumptions. A diagram based on assumptions is an assumption.
- Audit existing sources — Analytics, support tickets, surveys, prior research, NPS comments, call center logs
- Create a touchpoint inventory — List every physical, digital, and person-to-person interaction point. Note channel and collect screenshots/photos
- Draft an assumption map — Have the team sketch the journey from memory. Mark what you're confident about vs. what's a guess. This reveals what research needs to fill in
- Conduct research — Interviews (story-based), contextual inquiry, diary studies, service safaris. See
ux-researchskill for method guidance - Analyze and synthesize — Affinity diagramming, thematic coding. Extract observations into atomic notes coded to source participants
Minimum viable investigation: 5 user interviews + analytics review + touchpoint inventory. This is enough to create a credible first-version map.
Phase 3: Illustrate
Assemble insights into a single, readable diagram.
Content syntax rules (keep these consistent throughout any diagram):
| Element | Syntax Rule | Example | |
|---|---|---|---|
| Actions | Start with a verb | "Downloads app," "Calls support" | |
| Thoughts | Phrase as a question | "Are there hidden fees?" "Who else do I need to involve?" | |
| Feelings | Use adjectives | "Nervous," "Relieved," "Frustrated" | |
| Pain points | Start with a gerund | "Waiting for installation," "Re-entering information" | |
| Touchpoints | Use nouns (the interface) | "Email," "Mobile app," "Customer hotline" | |
| Opportunities | Start with a change verb | "Eliminate unnecessary steps," "Automate follow-up email" |
Layout principles:
- Time flows left to right
- More important information is visually larger/higher
- Use a consistent color system: one color for pain points (red), one for opportunities (green), one for neutral information
- Every row/lane should have a clear label
- The emotional curve (if included) should be immediately scannable
Iteration process:
- Start in a spreadsheet or whiteboard — get the content right first
- Move to a structured layout (Miro, FigJam, or drawing tool)
- Refine visual hierarchy — not everything is equally important
- Get feedback from stakeholders before polishing
- Polish only after content is validated
Phase 4: Align
The diagram is a means to an end. Use it.
- Alignment workshop — Walk through the diagram with the team. See
references/alignment-workshops.md - Identify moments of truth — Critical, emotionally intense moments that make or break the relationship
- Find opportunities — Look at weaknesses, gaps, redundancies, and where competitors perform well
- Prioritize — Score opportunities by user impact × feasibility
- Envision — Generate solutions with scenarios, storyboards, wireframes
- Plan — Connect opportunities to the product roadmap or backlog
Customer Journey Map: Core Structure
A CJM tells the story of one persona going through one scenario.
Required Elements
| Row | Content | |
|---|---|---|
| Phases | 3-7 high-level stages (e.g., Awareness → Research → Purchase → Onboarding → Use → Renewal) | |
| Goals | What the user is trying to accomplish at each phase | |
| Actions | What the user does (verb-first) | |
| Touchpoints | Which channels/interfaces are involved | |
| Thinking | Questions or thoughts at each phase | |
| Feeling | Emotional state — use a sentiment curve (positive ↔ negative) | |
| Pain points | Barriers, frustrations, friction | |
| Opportunities | How to improve each phase |
Optional Elements
- Ownership — Which team owns each phase
- Moments of truth — Flag the 2-3 moments that define the relationship
- Metrics — KPIs or data points at each phase (conversion rate, NPS, support tickets)
- Channels — Detailed breakdown of touchpoints by channel
For the full reference with examples and a step-by-step process, see references/customer-journey-maps.md. For a fillable template, see templates/customer-journey-map-template.md.
Service Blueprint: Core Structure
A service blueprint extends the journey map by showing how the organization delivers the experience.
Five Swimlanes
- Physical Evidence — Tangible artifacts the customer interacts with (screens, receipts, signage)
- Customer Actions — What the customer does at each step
- Frontstage (Onstage) — Employee/system actions visible to the customer
- Backstage — Internal actions not visible to the customer but directly supporting the experience
- Support Processes — Infrastructure, systems, and third-party services that enable everything
Three Critical Lines
- Line of Interaction — Separates customer from frontstage (the interface)
- Line of Visibility — Separates frontstage from backstage (what the customer can vs. cannot see)
- Line of Internal Interaction — Separates backstage from support processes
When to Use a Blueprint vs. a Journey Map
| Signal | Use Blueprint | |
|---|---|---|
| Departments aren't coordinated | Yes | |
| Need to redesign internal processes | Yes | |
| Launching a new service | Yes | |
| Optimizing operations | Yes | |
| Understanding customer emotions | Journey map is sufficient | |
| Exploring a problem space | Experience map is better |
For the full reference, see references/service-blueprints.md. For a fillable template, see templates/service-blueprint-template.md.
Empathy Map: Core Structure
A fast synthesis tool — use when you need a quick picture of a user segment.
Four Quadrants + Center
| Quadrant | Content | Source | |
|---|---|---|---|
| Says | Direct quotes, verbatim statements | Interviews, surveys | |
| Does | Observable actions and behaviors | Observation, analytics | |
| Thinks | Beliefs, concerns, internal monologue (may not be spoken) | Inference from behavior + interviews | |
| Feels | Emotional states, worries, hopes | Tone, body language, explicit statements | |
| Center: Goals & Needs | What this user is trying to achieve and what they need to succeed | Synthesis of all four quadrants |
Rules:
- One empathy map per persona or user segment
- Base it on research, not assumptions. If you haven't talked to users, label it "Proto-Empathy Map"
- Thinks ≠ Says. The gap between them is where insight lives
- 5-10 items per quadrant is a good target
For a fillable template, see templates/empathy-map-template.md.
Types of Service Experience
Services are not products — they are performances that unfold over time. Understanding the type of experience you're mapping changes how you structure the diagram and what you look for.
| Type | Duration | User Investment | Design Focus | Example | |
|---|---|---|---|---|---|
| Transactional | Minutes | Low — get in, get out | Speed, efficiency, minimize friction | ATM withdrawal, online bill pay, food delivery | |
| Continuous | Weeks to years | Medium — ongoing relationship | Trust, consistency, relationship quality | Healthcare, banking, subscription services | |
| Transformational | Months to years | High — user changes state | Progression, motivation, milestones | Education, fitness programs, therapy |
Design implications by type:
- Transactional: Map the fewest possible steps. Every extra step is excise. Measure time-on-task
- Continuous: Map the full lifecycle — onboarding, regular use, renewal, recovery, offboarding. Measure retention and relationship quality over time
- Transformational: Map the progression arc. Include "before" and "after" states. Measure outcomes, not just satisfaction
The Expectation Gap
The gap between what people expect and what they experience drives satisfaction more than absolute quality. A mediocre experience that exceeds expectations delights. An excellent experience that falls short disappoints.
For every journey map, ask:
- What does the user expect at each phase? (Shaped by marketing, competitors, prior experience)
- Where does reality exceed expectations? (Moments of delight — protect these)
- Where does reality fall short? (Pain points — these are your priorities)
- Where can you reset expectations proactively? (Communication, transparency)
Moments of Truth
Moments of truth are critical, emotionally intense moments that define the relationship between a person and a service. They are the moments when expectations are confirmed or shattered.
How to Identify Them
This is the start of the file. Read the full SKILL.md on GitHub.
Security
- Security scanPassed, 95 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/journey-mapping/SKILL.md
Popularity
- Repository stars
- 55
- Repository forks
- 5
- 7-day trend score
- 20
Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/cuellarfr/design-skills/journey-mapping)