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.
npx skills add Owl-Listener/designer-skills --skill behavioural-analytics -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/behavioural-analytics/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/behavioural-analytics/
1Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill behavioural-analytics -a codex2Manually: put the files in place
.agents/skills/behavioural-analytics/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill behavioural-analytics -a cursor2Manually: put the files in place
.cursor/skills/behavioural-analytics/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Owl-Listener/designer-skills behavioural-analytics2Manually: put the files in place
.github/skills/behavioural-analytics/SKILL.md1Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill behavioural-analytics -a gemini-cli2Platform CLI
gemini skills install https://github.com/Owl-Listener/designer-skills --path design-research/skills/behavioural-analyticsManually: put the files in place
.devin/skills/behavioural-analytics/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill behavioural-analytics -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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