discover-journey-map SKILL.md skillA

discover-journey-map from product-on-purpose/pm-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add product-on-purpose/pm-skills/discover-journey-map@v1.3.0

Pins v1.3.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
product-on-purpose/pm-skills
Path
skills/discover-journey-map/SKILL.md
Versions recorded
5
Latest version
v1.3.0, committed Aug 26, 2026
First version recorded
May 30, 2026
Size
11,980 bytes
Repository stars
790
License
Apache-2.0

Maps a customer journey across stages, touchpoints, emotional curve, pain points, and moments of truth into a markdown artifact with an optional mermaid timeline or flowchart. Use when synthesizing existing research into the shape of a customer's experience, end-to-end or for one phase. Without research signal yet, run discover-interview-synthesis or measure-survey-analysis first; refuses to fabricate emotional or behavioral data.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

<!-- PM-Skills | https://github.com/product-on-purpose/pm-skills | Apache 2.0 -->
# Customer Journey Map

You produce a customer journey map that captures stages, touchpoints, emotional curve, pain points, and opportunities. Your job is to surface the structure of the customer experience and identify where the product can intervene productively.

## Identity

- Phase skill (discover); Triple Diamond integration
- Single-turn lifetime; produces one journey map per invocation
- Read-only tools (Read, Grep); produces markdown output (with optional mermaid block)
- Composes with `utility-mermaid-diagrams` for visual output

## Core principle

**A journey map is a synthesis artifact, not a brainstorm.** Every stage, touchpoint, emotion, and pain point should trace to research input (interview, survey, analytics, observation). Hand-wavy "I imagine the user feels frustrated here" entries are a P0 anti-pattern that misleads the team.

If the user provides research signal (interview transcripts, survey results, analytics data, customer support tickets), you ground the map in that signal. If they provide hypotheses, you label entries as hypothetical and recommend validation research.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add product-on-purpose/pm-skills/discover-journey-map@sha256:9795a404438f6fc9

The line at the top of this page pins the label v1.3.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_7u2vykvfiw5262wt.svg)](https://markdownregistry.com/a/art_7u2vykvfiw5262wt)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between May 30, 2026 and Aug 26, 2026, about one every 22 days.

versioncommittedcommitsizeaudit
v1.3.0 latest2026-08-26 e27476a 11,980 BA view · diff
v1.3.02026-08-16 9528875 11,980 BA view · diff
v1.2.02026-07-06 fa0111e 11,724 BA view · diff
v1.1.02026-07-05 87e423c 11,462 BA view · diff
v1.0.02026-05-30 59968e0 10,766 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (11980 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

product-on-purpose/pm-skills · 790 stars · license Apache-2.0 · pushed 2026-11-03 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_7u2vykvfiw5262wt
GET https://markdownregistry.com/api/v1/resolve?ref=product-on-purpose/pm-skills/discover-journey-map
GET https://markdownregistry.com/api/v1/blob/9795a404438f6fc93975a2528b4c4f4bde9a66a60911d05fa9b673c3510b778d

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from product-on-purpose/pm-skills

AGENTS.md AGENTS.md file
product-on-purpose/pm-skills · AGENTS.md
git:20260705.87e423c · audit A · 790 stars
CLAUDE.md CLAUDE.md file
product-on-purpose/pm-skills · CLAUDE.md
git:20260801.7c39d66 · audit A · 790 stars
utility-update-pm-skills SKILL.md skill
product-on-purpose/pm-skills · docs/internal/efforts/F-24-update-pm-skills/_discovery/2026-04-09_claude-web-session/skills/utility-update-pm-skills/SKILL.md · Validates internet access, compares the locally installed pm-skills version against the latest public release, and…
v1.0.0 · audit A · 790 stars
utility-update-pm-skills SKILL.md skill
product-on-purpose/pm-skills · docs/internal/efforts/F-24-update-pm-skills/drafts/skills/utility-update-pm-skills/SKILL.md · Checks for newer pm-skills releases, compares local vs. latest version, previews what would change, and updates local…
v1.0.0 · audit A · 790 stars
<phase-or-classification-skill-name> SKILL.md skill
product-on-purpose/pm-skills · docs/templates/skill-template/SKILL.md · <single-line 20-100 word description; include trigger keywords and do not use folded YAML>
v1.0.0 · audit A · 790 stars
define-x SKILL.md skill
product-on-purpose/pm-skills · hooks/fixtures/skills/define-x/SKILL.md
git:20260603.23e65da · audit C · 790 stars
deliver-y SKILL.md skill
product-on-purpose/pm-skills · hooks/fixtures/skills/deliver-y/SKILL.md
git:20260603.23e65da · audit C · 790 stars
demo-noref SKILL.md skill
product-on-purpose/pm-skills · scripts/fixtures/family-registration/repo/skills/demo-noref/SKILL.md
git:20260706.fa0111e · audit C · 790 stars
demo-present SKILL.md skill
product-on-purpose/pm-skills · scripts/fixtures/family-registration/repo/skills/demo-present/SKILL.md
git:20260706.fa0111e · audit C · 790 stars
s-one SKILL.md skill
product-on-purpose/pm-skills · scripts/fixtures/shell-parity/repo/skills/s-one/SKILL.md
git:20260705.87e423c · audit C · 790 stars
s-three SKILL.md skill
product-on-purpose/pm-skills · scripts/fixtures/shell-parity/repo/skills/s-three/SKILL.md
git:20260705.87e423c · audit C · 790 stars
s-two SKILL.md skill
product-on-purpose/pm-skills · scripts/fixtures/shell-parity/repo/skills/s-two/SKILL.md
git:20260705.87e423c · audit C · 790 stars

Every file in product-on-purpose/pm-skills

Browse by kind, by grade A, or by owner.