CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

journey-mapping

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.

Quality

89%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

75%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-crafted, domain-specific instruction skill: prescriptive structure, concrete deliverable templates, a clearly sequenced workflow with user validation, and a valuable failure-patterns section, supported by a real one-level-deep reference file. The main gaps are mild redundancy with the reference template, a few glosses of research methods Claude already knows, and workflow validation steps that lack explicit error-recovery branches.

Suggestions

Move the inline markdown output template (or a trimmed skeleton of it) into references/journey-map-template.md to eliminate duplication with the existing fillable template and shorten SKILL.md.

Add an explicit error-recovery branch to the workflow — e.g., after step 7 (validate with users), state what to revise and re-check when validation contradicts the draft map — to strengthen the feedback loop.

Trim glosses of methods Claude already knows (e.g., "Surveys. Quantitative signal at scale; less depth." and the diary-study definition) and the illustrative "shipping is slow" aside.

DimensionReasoningScore

Conciseness

The body is largely prescriptive rather than educational — the lane taxonomy, phase templates, failure patterns, and output template all specify what to do rather than explain background. Minor over-explanation could be trimmed: glosses of methods Claude already knows ("Surveys. Quantitative signal at scale; less depth.", "Diary studies. Users log their experience over the duration of the journey.") and the illustrative aside about "shipping is slow" tracing to a vendor handoff. This fits "Efficient; minor instances of over-explanation that could be trimmed" — not level 5 ("every token earns its place") nor level 3 ("some unnecessary explanation", which would imply more substantial padding).

4 / 5

Actionability

As an instruction-only skill, it provides a copy-paste-adaptable markdown output template covering journey map, service blueprint additions, and opportunity map, plus a 10-step workflow and concrete failure patterns — this meets "Mostly executable guidance... with minor gaps". It falls short of level 5 ("copy-paste ready code or commands; specific examples cover the common cases") because several workflow steps remain guidance-level (e.g., "Identify opportunities. Use the friction points and disconnects.") without criteria or worked examples, and no filled-in example map is provided.

4 / 5

Workflow Clarity

The 10-step workflow is clearly sequenced (scope → gather → draft → layer → blueprint → opportunities → validate → workshop → action → maintain) with a validation checkpoint at step 7 ("Validate with users. Does this match their actual experience? Refine.") and cross-validation of user/business/internal views. This matches "Clear sequence with most checkpoints present; minor validation gaps". It is not level 5 because the feedback loop lacks an explicit error-recovery branch — what to change and re-check when validation contradicts the draft — and there is no checklist for such a long process; it is well above level 3, where checkpoints would be merely implicit (the destructive/batch cap does not apply to this non-destructive research skill).

4 / 5

Progressive Disclosure

The body is well-sectioned (When to use / NOT to use, Required inputs, framework, phases, inputs, workflow, failure patterns, output format) with one clearly signaled, one-level-deep reference — [references/journey-map-template.md], verified to exist and to match its described purpose ("Fillable journey map and service blueprint template"). This fits "Good structure; most content is appropriately placed; references mostly clear; minor organization gaps". It is not level 5 because the ~40-line inline output template (lines 196–238) substantially duplicates the reference template and arguably belongs there, and the SKILL.md at ~240 lines leans toward being a full manual rather than an overview pointing to detailed materials; it is well above level 3, since structure and reference signaling are genuinely good.

4 / 5

Total

16

/

20

Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is exemplary: it names both deliverables with their component parts, provides an explicit "Use this skill whenever..." clause, and includes a comprehensive trigger list with synonyms plus a contextual trigger for teams lacking a shared experience map. Voice is third-person/imperative throughout, consistent with the rubric's good examples.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "Build customer journey maps and service blueprints that visualize the end-to-end user experience including touchpoints, emotions, friction, and underlying systems", plus "identify friction across an experience", "align teams", and "visualize touchpoints and pain points" — comprehensive coverage of the skill's deliverables with no vague filler. This matches the anchor "Lists multiple specific concrete actions; comprehensive coverage" and exceeds the level-4 anchor ("minor gaps in coverage") because both deliverables and their constituent parts are named.

5 / 5

Completeness

It explicitly answers "what" ("Build customer journey maps and service blueprints that visualize the end-to-end user experience...") and "when" ("Use this skill whenever the user wants to map a customer journey... Triggers on...") with concrete trigger phrases, exactly matching the level-5 anchor. The level-4 anchor ("when could be more explicit or specific") does not apply — the when-clause is explicit and enumerates concrete triggering scenarios, including a contextual one ("when the team has departmental views of users but no shared map").

5 / 5

Trigger Term Quality

The explicit trigger list — "customer journey, journey map, service blueprint, user journey, experience map, touchpoint analysis, friction map, journey audit, end-to-end experience, customer experience map" — comprehensively covers the natural phrases a user would say, including synonyms (journey map / user journey / experience map / customer experience map). File extensions are inapplicable to this non-file-based domain, so the level-5 anchor is satisfied by the synonym coverage; level 4 ("a few natural terms missing") understates the breadth.

5 / 5

Distinctiveness Conflict Risk

The trigger terms name distinct deliverables (journey map, service blueprint, friction map, journey audit) that clearly distinguish this skill from adjacent research/testing skills, matching "Clear niche with distinct triggers; minimal conflict risk". It is not the level-4 case ("minor overlap risk with closely related skills") because the triggers are anchored to specific artifacts rather than broad phrases like "user research" that would collide with a generative-research skill.

5 / 5

Total

20

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

rampstackco/claude-skills

Path

skills/journey-mapping/SKILL.md

Reviewed

Table of Contents

Is this your skill?

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.