# bd-cuj

bd-cuj sets up Critical User Journey monitoring in bitdrift with path analysis, funnels, SLOs, alerts, session capture, and dashboards.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 306 installs · ★ 13 repo stars
- Author: bitdriftlabs
- License: PolyForm-Shield-1.0.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/bitdriftlabs/bd-skills/tree/HEAD/skills/bd-cuj/SKILL.md
- Updated: 2026-10-21
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/bd-cuj

## What it does

bd-cuj guides an agent through configuring Critical User Journey monitoring in bitdrift. It starts by collecting the event map, key step, scope, app IDs, and network paths, then builds workflows for route analysis, funnel tracking, and network RED metrics.

The setup covers Sankey path discovery, a funnel with key-step timing, slow-session capture, and a separate completion-rate workflow for SLOs. It also creates a key-step p95 alert and a two-tab dashboard with Journey and Network views.

The process runs in ordered phases: discovery, Sankey, funnel, network, alerts, and dashboard. Deployment waits for approval of the discovery summary, and each later phase has its own confirmation gate. Event names, field names, and matcher values must come from the user, so the skill cannot infer them from the codebase.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add bitdriftlabs/bd-skills --skill bd-cuj -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/bd-cuj/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/bd-cuj/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add bitdriftlabs/bd-skills --skill bd-cuj -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/bd-cuj/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add bitdriftlabs/bd-skills --skill bd-cuj -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/bd-cuj/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install bitdriftlabs/bd-skills skills/bd-cuj
```

2. **Manually: put the files in place**
- File: `.github/skills/bd-cuj/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add bitdriftlabs/bd-skills --skill bd-cuj -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/bitdriftlabs/bd-skills --path skills/bd-cuj
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/bd-cuj/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add bitdriftlabs/bd-skills --skill bd-cuj -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/bitdriftlabs/bd-skills/tree/HEAD/skills/bd-cuj/SKILL.md

## When to use it
- map a critical user journey from entry to completion
- locate drop-off points in a conversion flow
- measure the duration of a key journey step
- define an SLO for journey completion
- assemble Journey and Network dashboard views

## Example prompts
- Use `bd-cuj` to set up end-to-end monitoring for our checkout journey, starting with discovery.
- Build path discovery, a funnel, and a completion-rate SLO for onboarding from the event map I provide.
- Add a p95 alert for the key search step and create the two-tab Journey and Network dashboard.

## Similar
- [observability-service-reliability](https://affpapa.org/en/nevibecode/skills/observability-service-reliability.md) — skill · 1500 installs
- [monitoring-observability](https://affpapa.org/en/nevibecode/skills/monitoring-observability.md) — skill · 504 installs
- [observability-monitoring-slo-implement](https://affpapa.org/en/nevibecode/skills/observability-monitoring-slo-implement.md) — skill · ★ 50109 repo stars
- [gcp-slo-management](https://affpapa.org/en/nevibecode/skills/gcp-slo-management.md) — skill · ★ 151 repo stars
- [observability-cloud-planning](https://affpapa.org/en/nevibecode/skills/observability-cloud-planning.md) — skill · ★ 85 repo stars
- [honeycomb](https://affpapa.org/en/nevibecode/plugins/honeycomb.md) — plugin · ★ 28 repo stars

From the same set: [bitdriftlabs/bd-skills](https://affpapa.org/en/nevibecode/by/bitdriftlabs/bd-skills.md) — 5 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
