cuellarfr/design-skills/journey-mapping

Claude Code and agent skill by cuellarfr/design-skills

Trust tier 3
  • community
Source check pending

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-mapping

SKILL.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

DiagramBest ForFocusStructure
Customer Journey MapUnderstanding one persona's experience with your product/serviceEmotions, motivations, pain points at each stageChronological phases, horizontal timeline
Service BlueprintConnecting frontstage experience to backstage operationsHow the organization delivers the experienceSwimlanes separated by line of visibility
Experience MapUnderstanding a broad human activity (not tied to your product)General behavior, goals, emotions across a domainChronological, free-form, product-agnostic
Empathy MapQuick synthesis of what you know about a user typeSays/Does/Thinks/Feels for one personaFour quadrants + center (goals/needs)
Mental Model DiagramDeep understanding of user reasoning and decision-makingHierarchical breakdown of how users think about a domainBottom-up laddering, towers grouped into spaces
Ecosystem ModelVisualizing relationships between actors, systems, and contentFlows of value between entitiesNetwork/spatial layout, concentric rings
User Story MapPlanning product features against user workflowActivities → Steps → Details for backlog prioritizationGrid: 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.

  1. Define the experience to map — Which persona? Which scenario? What scope (end-to-end journey or a specific flow)?
  2. Select the diagram type — Use the selection guide above
  3. Identify stakeholders — Who needs to be in the room? Product trio minimum; include frontline staff when possible
  4. Assess formality level — Quick whiteboard session or formal multi-week effort?
  5. 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.

  1. Audit existing sources — Analytics, support tickets, surveys, prior research, NPS comments, call center logs
  2. Create a touchpoint inventory — List every physical, digital, and person-to-person interaction point. Note channel and collect screenshots/photos
  3. 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
  4. Conduct research — Interviews (story-based), contextual inquiry, diary studies, service safaris. See ux-research skill for method guidance
  5. 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):

ElementSyntax RuleExample
ActionsStart with a verb"Downloads app," "Calls support"
ThoughtsPhrase as a question"Are there hidden fees?" "Who else do I need to involve?"
FeelingsUse adjectives"Nervous," "Relieved," "Frustrated"
Pain pointsStart with a gerund"Waiting for installation," "Re-entering information"
TouchpointsUse nouns (the interface)"Email," "Mobile app," "Customer hotline"
OpportunitiesStart 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:

  1. Start in a spreadsheet or whiteboard — get the content right first
  2. Move to a structured layout (Miro, FigJam, or drawing tool)
  3. Refine visual hierarchy — not everything is equally important
  4. Get feedback from stakeholders before polishing
  5. Polish only after content is validated
Phase 4: Align

The diagram is a means to an end. Use it.

  1. Alignment workshop — Walk through the diagram with the team. See references/alignment-workshops.md
  2. Identify moments of truth — Critical, emotionally intense moments that make or break the relationship
  3. Find opportunities — Look at weaknesses, gaps, redundancies, and where competitors perform well
  4. Prioritize — Score opportunities by user impact × feasibility
  5. Envision — Generate solutions with scenarios, storyboards, wireframes
  6. 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
RowContent
Phases3-7 high-level stages (e.g., Awareness → Research → Purchase → Onboarding → Use → Renewal)
GoalsWhat the user is trying to accomplish at each phase
ActionsWhat the user does (verb-first)
TouchpointsWhich channels/interfaces are involved
ThinkingQuestions or thoughts at each phase
FeelingEmotional state — use a sentiment curve (positive ↔ negative)
Pain pointsBarriers, frustrations, friction
OpportunitiesHow 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
  1. Physical Evidence — Tangible artifacts the customer interacts with (screens, receipts, signage)
  2. Customer Actions — What the customer does at each step
  3. Frontstage (Onstage) — Employee/system actions visible to the customer
  4. Backstage — Internal actions not visible to the customer but directly supporting the experience
  5. 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
SignalUse Blueprint
Departments aren't coordinatedYes
Need to redesign internal processesYes
Launching a new serviceYes
Optimizing operationsYes
Understanding customer emotionsJourney map is sufficient
Exploring a problem spaceExperience 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
QuadrantContentSource
SaysDirect quotes, verbatim statementsInterviews, surveys
DoesObservable actions and behaviorsObservation, analytics
ThinksBeliefs, concerns, internal monologue (may not be spoken)Inference from behavior + interviews
FeelsEmotional states, worries, hopesTone, body language, explicit statements
Center: Goals & NeedsWhat this user is trying to achieve and what they need to succeedSynthesis 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.

TypeDurationUser InvestmentDesign FocusExample
TransactionalMinutesLow — get in, get outSpeed, efficiency, minimize frictionATM withdrawal, online bill pay, food delivery
ContinuousWeeks to yearsMedium — ongoing relationshipTrust, consistency, relationship qualityHealthcare, banking, subscription services
TransformationalMonths to yearsHigh — user changes stateProgression, motivation, milestonesEducation, 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

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
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/cuellarfr/design-skills/journey-mapping/badge)](https://verified-skill.com/skills/cuellarfr/design-skills/journey-mapping)

Something wrong with this skill or its page? Tell us.