user-journey-mapping

Translate PRDs into structured user journey maps with states and KPIs.

4|Updated Mar 3, 2026
One-click install
npx skills add https://github.com/AI-Foundry-Core/ril-agents --skill user-journey-mapping
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: user-journey-mapping
Source: https://github.com/AI-Foundry-Core/ril-agents/tree/main/plugins/product-planning/skills/user-journey-mapping
Command: npx skills add https://github.com/AI-Foundry-Core/ril-agents --skill user-journey-mapping

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

A journey map translates a PRD from "what we're building" into "how a user actually experiences it." It exposes assumptions about user behavior, surfaces edge cases before they become bugs, and defines measurable checkpoints. The Feature Spec and QA agents consume journey maps directly — weak maps produce weak specs.

Core Features & Use Cases

  • Happy Path vs. Non-Happy Golden Path vs Edge Cases
  • Steps Have States
  • Measurement Points
  • Journey Map Format
  • Edge Case Discovery Process

Quick Start

Create a journey map for the current PRD that captures steps, states, edge cases, and per-step KPIs.

Frequently Asked Questions about user-journey-mapping

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I map user journeys from a PRD to define measurable KPIs?

To map user journeys from a PRD, translate product requirements into structured user flows with distinct states, measurement points, and edge-case processes to validate UX and define per-step KPIs. This structured journey map format captures steps, states, and edge cases.

What is the best way to discover edge cases in product design before development?

The best way to discover edge cases is by mapping the non-happy golden path alongside the happy path in a user journey map. This edge case discovery process exposes assumptions about user behavior and surfaces potential bugs before development begins.

How do I validate UX flows and track states for each user journey step?

You validate UX flows by enforcing a journey map format where individual steps have explicit states. This translates PRD requirements into how a user actually experiences the product, establishing clear measurement points for UX validation at each step.

When do I need to create a user journey map for product management?

You need a user journey map when translating a PRD from what you are building into how users experience it. It is required for product design, UX validation, edge-case discovery, and defining measurable KPIs per journey step to prevent weak feature specs.

Does user journey mapping work without a completed PRD?

User journey mapping relies on a PRD as input to translate product requirements into detailed user flows. Without a PRD defining what is being built, the journey map cannot effectively establish states, measurement points, or edge-case processes for validation.