Funnel analysis
Skill event4u-app/agent-config/dist/agent-src/skills/funnel-analysis
Universal AI Agent OS — audited skills, governance rules, replayable state. One contract, every host agent.
npx -y skills add event4u-app/agent-config --skill funnel-analysisAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 7 stars7 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Use when diagnosing where a SaaS or product funnel leaks — visitor → signup → activation → paid → retained — channel-agnostic, conversion-rate-driven.
SKILL.md
7.0 KB, as published. Nobody here has run it
funnel-analysis
When to use
- Conversion to paid dropped and nobody knows which step broke.
- A new signup channel went live and you need to compare its funnel shape to the baseline.
- A board ask: "where does the money leak between landing page and paying customer?"
Do NOT use for ranking features, valuation, or OKR decomposition (see Related Skills). Funnel analysis is a diagnostic, not a roadmap.
Cognition cluster
- Mental model 16 — Leading vs. lagging indicators. Paid is
lagging; activation is leading; signup is upstream of both. A
funnel decision built on the lagging stage can only confirm the
miss; the leading stage names the binding fix. See
docs/contracts/mental-models.md§ 16. - Mental model 13 — Occam's razor. When a stage drops, the
simpler explanation usually wins: "acquisition mix shifted"
beats "users no longer understand the product." Pick the simpler
cause; it changes the move. See
mental-models.md§ 13. - Mental model 3 — Pareto (80/20). Drops are almost never
uniform across segments; ~20 % of the segment × stage cells carry
~80 % of the loss. Segment before treating the average as
actionable. See
mental-models.md§ 3. - Context-spine — product + customer-segment + funnel-stage.
Read the product slot for what activation can actually mean
in-product (the activation event must be shippable), the
customer-segment slot for which segments' switch-events the
funnel is built for, and the funnel-stage slot for the
position of each stage relative to the buying journey. See
context-spine.
Procedure
Step 0: Inspect
- Confirm the cognition cluster: this is conversion diagnosis, channel-agnostic. Paid social, organic, partner, and self-serve all share the same shape; only the inputs differ.
- Confirm event tracking exists for all 5 stages. If even one stage is inferred, the analysis is unreliable — flag and proceed under that caveat.
Step 1: Lock the 5 stages
- The canonical SaaS funnel: Visitor → Signup → Activation → Paid → Retained-D30.
- Activation is the load-bearing definition. Pick the single event that historically correlates with paid conversion — not "logged in", not "viewed dashboard". For most SaaS this is "completed first meaningful action" (sent first invoice, ran first query, invited first teammate).
- Retained-D30 = still active 30 days after first paid charge. Earlier than D30 is noise; later requires more data.
Step 2: Pull stage-to-stage conversion
- Compute conversion rate at each step:
stage_n / stage_n-1. Always use cohorts (signup-week or signup-month), never aggregate snapshots — aggregates lie when traffic mix changes. - For each rate, attach a 95% confidence interval. Tiny denominators give big bands; the band is half the story.
- Plot a 12-week trend per rate. A single point is gossip; a trend is evidence.
Step 3: Benchmark vs internal baseline
- The right benchmark is your own funnel one quarter ago, not industry averages. Industry averages mix verticals so coarsely they're useless for action.
- For each stage: is current rate within ±2 percentage points of trailing-quarter median? If not, that stage is the primary suspect.
- If multiple stages move off-band simultaneously, the cause is upstream (acquisition mix change, broken instrumentation), not the stage itself.
Step 4: Segment the broken stage
- Take the suspect stage and segment by: channel · device · plan · geo · cohort week.
- The drop is almost always concentrated in one segment, not uniform. Uniform drops point to instrumentation.
- Anti-pattern: averaging across segments and treating the average as actionable. The average user does not exist.
Step 5: Hypothesise causes
- For the broken segment-stage, write 3 candidate causes. Rank by testability, not plausibility.
- The cheapest experiment to falsify the top candidate is the next step — usually a UX change, a copy test, or an onboarding tweak.
- If no cause is testable in under 2 weeks, the analysis is not yet sharp enough.
Step 6: Validate
- Recompute the broken rate after the experiment ships. Same cohort definition. Same window.
- If the rate moves but the downstream rates don't follow, you fixed a vanity step. Keep going.
Gotcha
- "Activation" defined as a low-friction event (signup confirmation, first login) gives you a flatter funnel that is useless for prediction. Activation must correlate with paid.
- Aggregate funnel rates that look stable can hide a 30-point drop in one channel masked by a 30-point lift in another. Always segment.
- D7 retention looks great compared to D30. Pick the metric that matches the contract length, not the one that flatters.
- Holiday weeks, deploys, marketing pushes, and refund days distort cohorts. Annotate the timeline; don't pretend a 5pp drop is real on a known holiday.
Do NOT
- Do NOT use industry-average benchmarks as a target. They mix B2B with B2C, freemium with high-touch — the average is meaningless.
- Do NOT compare a 1-week cohort to a 12-week trailing median; sample size is too small to draw conclusions.
- Do NOT diagnose retention on a funnel without separating new-user retention from re-engaged-user retention.
Related Skills
WHEN to use this
- Where in the funnel did conversion drop?
- Compare the funnel shape between two channels.
WHEN NOT to use this
- Pricing tier or unit-economics question — route to
unit-economics-modeling. - Roadmap ranking from funnel findings — route to
rice-prioritization. - Setting team OKRs around the diagnosed metric — route to
okr-tree-modeling. - Valuing the business that owns the funnel — route to
dcf-modeling.
When the agent should load this
- "Where is our funnel leaking?"
- "Why did paid conversion drop last month?"
- "Compare the funnel for paid social vs organic."
- "Diagnose this dropoff between signup and activation."
- "Is this drop real or instrumentation?"
Output
funnel-table.md— 5-stage funnel with cohort rates, 95% CI, and 12-week trend (sparkline or compact ASCII). One row per cohort week or month.segment-breakdown.md— table of the broken stage segmented by channel · device · plan · geo. Rates with CIs. Suspect segments highlighted.hypothesis-list.md— top 3 causes for the broken segment-stage with cheapest-falsification experiment per cause and an explicit prediction for the next measurement.