Build customer journey maps and service blueprints that visualize the end-to-end user experience including touchpoints, emotions, friction, and underlying systems. Use this skill whenever the user wants to map a customer journey, build a service blueprint, identify friction across an experience, align teams on the user experience, or visualize touchpoints and pain points. Triggers on customer journey, journey map, service blueprint, user journey, experience map, touchpoint analysis, friction map, journey audit, end-to-end experience, customer experience map. Also triggers when the team has departmental views of users but no shared map of what the experience actually feels like.
63
75%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/journey-mapping/SKILL.mdQuality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong skill description that clearly articulates what it does (builds journey maps and service blueprints with specific components), when to use it (comprehensive trigger list plus contextual scenario), and uses appropriate third-person voice throughout. The inclusion of both explicit trigger terms and a situational trigger ('when the team has departmental views...') adds practical depth. The description is thorough without being padded with fluff.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Build customer journey maps and service blueprints', 'visualize the end-to-end user experience including touchpoints, emotions, friction, and underlying systems'. These are concrete deliverables with specific components named. | 3 / 3 |
Completeness | Clearly answers both 'what' (build customer journey maps and service blueprints visualizing touchpoints, emotions, friction, and systems) and 'when' (explicit 'Use this skill whenever...' clause plus a comprehensive list of trigger scenarios including the contextual trigger about departmental views). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'customer journey', 'journey map', 'service blueprint', 'user journey', 'experience map', 'touchpoint analysis', 'friction map', 'journey audit', 'end-to-end experience', 'customer experience map'. These are terms users would naturally use when requesting this type of work. | 3 / 3 |
Distinctiveness Conflict Risk | Occupies a clear niche around customer journey mapping and service blueprints with highly specific trigger terms. Unlikely to conflict with general UX, design, or data visualization skills due to the specificity of terms like 'service blueprint', 'journey map', and 'touchpoint analysis'. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
50%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured instructional skill that provides a comprehensive framework for journey mapping with clear deliverables, phases, and failure patterns. Its main weaknesses are verbosity (explaining concepts Claude likely knows), lack of concrete worked examples showing a completed journey map, and a workflow that lacks explicit validation checkpoints and feedback loops between steps. The content would benefit from being more concise and including at least one filled-in example.
Suggestions
Add a concrete, filled-in example of at least one phase of a journey map (e.g., an ecommerce 'Purchase' phase with realistic data) so Claude can see what good output looks like rather than just a skeleton template.
Trim explanatory content Claude already knows—remove definitions of common terms (touchpoints, diary studies, NPS) and reduce the failure patterns section to a compact checklist rather than explained paragraphs.
Move the 'Common phases by product type' section and the full output format template into separate reference files to reduce the main skill's token footprint and improve progressive disclosure.
Add explicit decision points and feedback loops in the workflow—e.g., 'If cross-validation in step 3 reveals major disagreements between user accounts and business data, investigate before proceeding to step 4.'
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is well-organized but includes some content Claude already knows (e.g., explaining what touchpoints are, what diary studies are, what NPS is). The 'Common phases by product type' section is useful but could be more compact. The failure patterns section, while valuable, is somewhat verbose with explanations of obvious anti-patterns. | 2 / 3 |
Actionability | The skill provides a clear framework and a concrete markdown template for output, which is good. However, it's primarily descriptive rather than executable—there are no concrete examples of a completed journey map, no sample data showing what a filled-in template looks like, and the guidance is more conceptual ('gather inputs,' 'add the layers') than step-by-step actionable. The markdown template is a strong point but is a skeleton, not a worked example. | 2 / 3 |
Workflow Clarity | The 10-step workflow is clearly sequenced and includes a validation step (step 7: 'Validate with users'). However, there are no explicit checkpoints or feedback loops between steps—for instance, no guidance on what to do if the draft journey map doesn't align with data, or how to handle stakeholder disagreements in step 8. The workflow reads more like a project plan outline than an operational procedure with decision points. | 2 / 3 |
Progressive Disclosure | The skill references one external file (references/journey-map-template.md) which is appropriate, but no bundle files were provided to verify it exists. The SKILL.md itself is quite long (~200+ lines) and some content (like the full output format template and common phases by product type) could be split into reference files. The structure within the file is well-organized with clear headers, but the single document carries a lot of weight. | 2 / 3 |
Total | 8 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
8e70d03
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.