Skip to main content
skill CX Codex

behavioural-analytics — Claude Code skill: read funnels and retention

A skill that reads funnels, retention curves and event data the way a designer must: to locate a problem, not to prove one. Useful when you inherit data you did not instrument.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add Owl-Listener/designer-skills --skill behavioural-analytics -a claude-code
Open on GitHub

What behavioural-analytics does

The skill takes a funnel, a retention curve or an event stream that someone else instrumented and returns a short list of ranked hypotheses about where the design is failing. Each hypothesis has to forbid something: the segment it applies to, the observation that would kill it, and whether the answer needs data you already have, a session recording or a conversation. Ranking is by how cheaply a hypothesis can be killed, not by how likely it feels.

Before any design hypothesis forms, the skill rules out the usual false signals. An event may not mean what its name says. The denominator may have moved, which makes a conversion drop an acquisition change. A funnel step may not be a step the product enforces. A release, a holiday or a campaign may land on the same date. An aggregate can hide one platform falling while another rises. A number that survives all five checks is worth designing against.

The shape of the chart carries more than the value. A cliff at one step means something is blocking. A slope across many steps means the flow is simply too long. Retention that falls then flattens means a real core of users and a bad first run. Retention that keeps falling means no core yet, and onboarding fixes will not save it. A bimodal time-on-task means two populations in one flow, so segment before designing. The skill does not define the metric and does not run the experiment: for choosing what to measure use metrics-definition, for a controlled test use a-b-test-design.

What it helps with

  • separate a design problem from a tracking artefact
  • break a conversion drop down by segment and platform
  • write a hypothesis that can actually be killed
  • tell from a retention curve whether a core of users exists
  • decide what to look at next: data, a session recording or a conversation

Example prompts for the agent

  • Read last month's signup funnel and tell me where the design breaks
  • Here's our retention curve — is there a core of users or will onboarding not save it
  • Build hypotheses for the drop at checkout and say what would kill each one

How to install behavioural-analytics

1Skills CLI (Vercel)

npx skills add Owl-Listener/designer-skills --skill behavioural-analytics -a claude-code

2Manually: put the files in place

~/.claude/skills/behavioural-analytics/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/behavioural-analytics/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about behavioural-analytics

How do I install behavioural-analytics in Claude?

Run npx skills add Owl-Listener/designer-skills --skill behavioural-analytics -a claude-code. The skill lands in ~/.claude/skills/behavioural-analytics/SKILL.md.

What does behavioural-analytics do?

It reads funnels, retention curves and event data and returns ranked hypotheses about where the design is failing. Each one comes with the observation that would disprove it.

How is it different from metrics-definition and a-b-test-design?

behavioural-analytics works on data you already have and decides what to look at next. metrics-definition picks the metric, and a-b-test-design runs the controlled test.

Source text

SKILL.md · MIT
---
name: behavioural-analytics
description: Read funnels, retention curves, and event data as a designer — separating a design problem from a tracking artefact. Use when handed product data you did not design and asked why people drop off. For choosing what to measure, use `metrics-definition` (ux-strategy); for running a controlled test, use `a-b-test-design` (prototyping-testing).
---
# Behavioural Analytics
You are an expert in reading product data the way a designer must: to locate a problem, not to prove one.
## What You Do
You take a funnel, a retention curve, or an event stream that someone else instrumented, and produce a short list of ranked hypotheses about where the design is failing and what would confirm or kill each one. You do not define the metric — that has already happened — and you do not run the experiment. You decide what is worth looking at next.
## Before You Trust the Number
Most surprising numbers are wrong before they are interesting. Rule these out before forming a single design hypothesis:
- **The event does not mean what its name says.** `checkout_completed` may fire on render, not on payment. Read the tracking definition, not the label.
- **The denominator moved.** A conversion drop with a flat numerator is an acquisition change, not a design change.
- **The step is not a step.** Funnels imply an order the product does not enforce. If users can skip, return, or arrive mid-flow, a "drop-off" is often a path the funnel cannot see.
- **A release, a holiday, or a campaign lands on the same date.** Line up deploys and marketing before attributing anything to the interface.
- **The platform split is hiding the effect.** An aggregate that barely moves often conceals one platform falling and another rising.
A number that survives all five is worth designing against. One that does not is a data question, and answering it as a design question wastes a cycle.
## Reading the Shape
The shape carries more meaning than the value:
- **A cliff at one step** — something is blocking. A requirement, an error, a demand for information the user does not have yet.
- **A slope across many steps** — nothing is blocking; the flow is simply too long. Removing one step will move it only slightly.
- **Retention that falls then flattens** — you have a real core of users and a bad first run. The flat part is the product working.
- **Retention that keeps falling** — no core yet. Onboarding fixes will not save this; the value proposition is the problem.
- **A bimodal time-on-task** — two populations doing different things in one flow. Segment before designing, or you will design for a mean that describes nobody.
## From Shape to Hypothesis
A hypothesis is only useful when it forbids something. "Users are confused at step three" forbids nothing. "Users abandon at step three because the address form rejects valid non-UK postcodes" predicts a specific error rate in a specific segment, and dies cleanly if that rate is flat.
For each hypothesis state: the segment it applies to, the observation that would kill it, and whether the answer needs data you already have, a session recording, or a conversation. Rank by how cheaply each can be killed, not by how likely you think it is.
## Best Practices
- Look at the segment before the average; an aggregate is a claim that everyone behaves alike
- Say how confident you are and why, in the same breath as the finding
- Prefer the smallest cohort that still answers the question — big numbers hide the mechanism
- Do not read a step change from a chart without checking what shipped that week
- Do not treat a statistically significant difference as a large one; ask what it is worth before designing for it
- Not for deciding whether the numbers or the interviews are right when they conflict — that is `qual-quant-triangulation`

© Owl-Listener · MIT · Owl-Listener/designer-skills

Similar skills

Everything for Design →

From the same set111

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor