user-journey-tracking
Track user journeys with intent context and friction signals. Use when instrumenting funnels or multi-step flows.
When & Why to Use This Skill
This Claude skill provides a robust framework for advanced user journey tracking and UX observability. It enables developers to instrument multi-step funnels with intent context and friction signals—such as rage clicks and form thrashing—to move beyond simple drop-off metrics and uncover the underlying reasons why users fail to complete tasks.
Use Cases
- Checkout Funnel Optimization: Identify specific friction points in payment flows by correlating step completion with behavioral signals like 'retry exhaustion' or 'rage clicks'.
- Onboarding Flow Instrumentation: Implement intent-aware tracking in registration sequences to detect 'back loops' or 'quick abandonment' that indicate user confusion or lack of trust.
- UX Health Analysis: Monitor 'success with friction' cases where users complete a goal but experience significant struggle, helping to prioritize UI/UX improvements before users churn.
- Drop-off Root Cause Analysis: Use 'job_name' and 'job_step' context to differentiate between intentional exits and failures caused by unresponsive elements or confusing form fields.
| name | user-journey-tracking |
|---|---|
| description | Track user journeys with intent context and friction signals. Use when instrumenting funnels or multi-step flows. |
| priority | 2 |
User Journey Tracking
Instrument flows to answer: "Why did users fail to complete their intended task?"
Core Principle
Every event should include intent context:
| Field | Example | Why |
|---|---|---|
job_name |
"checkout" | Which user goal |
job_step |
"payment" | Where in the journey |
job_progress |
"3/4 steps" | How far they got |
Friction Signals
Detect when users are struggling:
| Signal | Detection | Indicates |
|---|---|---|
| Rage clicks | 3+ clicks on same element within 1s | UI unresponsive |
| Retry exhaustion | 3+ retries of same action | Persistent failure |
| Quick abandonment | Exit within 5s of error | Lost trust |
| Form thrashing | Repeated focus/blur on same field | Confusion |
| Back loops | 3+ backs without progress | Lost/confused |
Key Events
| Event | When |
|---|---|
journey.started |
User begins multi-step flow |
journey.step_complete |
User advances to next step |
journey.friction |
Friction signal detected |
journey.success |
User completes goal |
journey.abandoned |
User exits without completing |
Anti-Patterns
- Tracking steps without job context (can't correlate)
- Missing friction signals (only see drop-off, not why)
- Not tracking "success with friction" (silent failures)
- High-cardinality step names (use patterns, not IDs)
Implementation
Use Read tool to load references/user-focused-observability.md for detailed patterns.
Related
skills/instrumentation-planning- JTBD frameworkskills/error-tracking- Enriching errors with journey contextreferences/jtbd.md- Jobs-to-be-Done methodology