Agent skill

Activation Funnel

by borghei in borghei/Claude-Skills

Design and analyze activation funnels (AARRR / AAARRR Pirate Metrics) with conversion + drop-off math, bottleneck detection, and Mermaid funnel diagrams.

MITAuto-check passedDevelopment

Install Activation Funnel

skills CLI
$ npx skills add borghei/Claude-Skills --skill activation-funnel -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install borghei/Claude-Skills activation-funnel --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/borghei/Claude-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/project-management/execution/activation-funnel .claude/skills/activation-funnel && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
activation-funnel
GitHub stars
881
Token cost
~1.9k tokens
SKILL.md length
870 words
Files
10 (incl. scripts, references, assets)
Skills in repo
349
Repo updated
First seen
Licence
MIT

At a glance

Design and analyze activation funnels (AARRR / AAARRR Pirate Metrics) with conversion + drop-off math, bottleneck detection, and Mermaid funnel diagrams.

  • Tasks that involve Product metrics
  • SKILL.md covers Overview, Core Capabilities, When to Use and Clarify First, plus 4 more sections
  • Runs Python scripts from its folder; calls python
  • Tasks that involve Diagrams

What it does

Activation Funnel is an agent skill from borghei/Claude-Skills. Design and analyze activation funnels (AARRR / AAARRR Pirate Metrics) with conversion + drop-off math, bottleneck detection, and Mermaid funnel diagrams. Includes a stdlib Python tool that emits all 6 shared PM output formats.

Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 13 other files, including scripts, reference files and assets (for example `assets/activation_metric_worksheet.md`, `assets/funnel_design_canvas.md` and `assets/sample_funnel.json`).

It sits in Development, covering Product metrics and Diagrams. It works with Mermaid and Python. The repository describes itself as: 385 AI skills, 77 expert agents, and 900 stdlib Python tools for every team: engineering, PM, marketing, C-level, compliance, business ops, research, and a LinkedIn toolkit… The licence is MIT.

When your agent uses it

  • Tasks that involve Product metrics
  • Tasks that involve Diagrams

Example prompts

  • “/activation-funnel”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit 4a698e8. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Activation Funnel loads about 1.9k tokens when it runs, and up to ~13k if it reads all its reference files. Until then it costs about 61 tokens; SKILL.md has 870 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~61
When it runs · the whole SKILL.md, loaded when a task matches
~1.9k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~13k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from borghei/Claude-Skills at commit 4a698e8, republished under its MIT licence (© borghei). 870 words, ~1,936 tokens.

Download SKILL.mdSave it as .claude/skills/activation-funnel/SKILL.md (or your agent's skills folder). This skill also uses 9 other files; get the full folder from GitHub.
name
activation-funnel
description
Design and analyze activation funnels (AARRR / AAARRR Pirate Metrics) with conversion + drop-off math, bottleneck detection, and Mermaid funnel diagrams. Includes a stdlib Python tool that emits all 6 shared PM output formats.
license
MIT + Commons Clause
metadata.version
1.0.1
metadata.author
borghei
metadata.category
project-management
metadata.domain
pm-execution
metadata.updated
2026-06-15
metadata.python-tools
funnel_analyzer.py
metadata.tech-stack
aarrr, pirate-metrics, activation, conversion-funnel, growth, north-star

Activation Funnel Expert

Overview

A funnel is the single most useful diagnostic tool a growth or onboarding PM owns. It turns a fuzzy product story ("users drop off somewhere") into a numbered, actionable picture ("76% land, 41% start setup, 9% finish setup, 4% take the activation action -- the biggest drop is between start and finish setup at 32 percentage points").

This skill specifies funnel structures using Dave McClure's AARRR (Acquisition, Activation, Retention, Revenue, Referral) and its broader cousin AAARRR (which adds Awareness on the front), and analyzes them with a stdlib Python tool (funnel_analyzer.py). The tool ingests a JSON funnel definition (stages with counts) and outputs stage-by-stage conversion and drop-off, a Mermaid flowchart, and a bottleneck call-out — in all six SHARED_OUTPUT_SCHEMA formats so the analysis travels into Jira, Linear, Confluence, Notion, or a PR.

The activation step is the centerpiece. Sean Ellis defined the "activated user" as one who has done the thing that statistically predicts retention (Slack's 2000 messages, Facebook's "7 friends in 10 days", Dropbox's "1 file in 1 folder on 1 device"). Pin the activation event before you optimize the funnel that leads to it.

Core Capabilities

  • Funnel structure — define stages as events using AARRR or AAARRR; compress to 4-7 stages.
  • Conversion + drop-off math — per-stage conversion, absolute and relative drop, cumulative conversion, bottleneck detection (largest absolute vs largest relative drop).
  • Activation event definition — Sean Ellis framework to pin the predictive "aha" event (count + window + action).
  • Counter-metric pairing — guard every stage against gaming; leading-vs-lagging indicator design.
  • Six-format output — render the analysis + Mermaid diagram for Jira, Linear, Confluence, Notion, or a PR.

When to Use

  • New onboarding design -- specify the funnel events from signup to value.
  • Drop-off diagnosis -- signups grow but completion is flat; where is the leak?
  • Activation metric definition -- pick the "aha" event that predicts long-term retention.
  • Cross-functional alignment -- get marketing, product, and growth to agree on one funnel definition.
  • QBR / A/B test design -- one canonical funnel drives the conversation and makes primary + counter-metrics obvious.

When NOT to use: pre-PMF discovery (use discovery/); top-of-funnel channel attribution (marketing tools); revenue-cohort retention (data-analytics domain); when events are not instrumented.

Clarify First

Before analyzing the funnel, confirm these inputs. If any is unknown or vague, ASK — do not assume:

  • Stages + counts — the actual events and the user count at each step (drives every conversion/drop-off number and the bottleneck call-out)
  • Activation event — the Sean Ellis "aha" event that defines an activated user (sets the funnel's centerpiece stage and the activation rate)
  • Cohort window — the time period the counts are drawn from (snapshot funnels mix cohorts and lie; this scopes every number)

Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.

Quick Start

bash
python scripts/funnel_analyzer.py --input funnel.json --format markdown   # conversion + drop-off + bottleneck
python scripts/funnel_analyzer.py --demo --format mermaid                 # worked SaaS funnel diagram
Show full SKILL.md (409 more words)Show less

References

Load the reference that matches the task — keep this file lean and pull detail on demand:

  • references/funnel-analysis-playbook.md — full AARRR/AAARRR stage tables, the aha-event definition method, conversion/drop-off math, counter-metric pairing, leading-vs-lagging indicators, the step-by-step workflow, the funnel_analyzer.py reference (flags, input JSON, Mermaid sample), troubleshooting, and success criteria. Read when building or analyzing a funnel.
  • references/pirate-metrics-deep-dive.md — McClure's AARRR + AAARRR, Andrew Chen funnel mechanics, Balfour's Four Fits, growth loops, and NSM-funnel linkage. Read when designing the overall growth model around the funnel.
  • references/activation-aha-moment-patterns.md — Ellis's framework plus 12 worked activation-event examples (Slack, FB, Dropbox, Airbnb, Notion, Spotify, Duolingo, Twitter, HubSpot, Pinterest, LinkedIn, Figma). Read when choosing or validating the activation event.
  • references/red-flags.md — concrete examples of how funnel output goes wrong, why it's bad, and how to fix it. Read when reviewing a funnel analysis or diagnosing a misleading chart.
  • assets/funnel_design_canvas.md — workshop canvas for defining the funnel. Use in a design session.
  • assets/activation_metric_worksheet.md — worksheet for picking the activation event. Use when pinning the aha event.
  • assets/sample_funnel.json — a working JSON example matching the tool input. Use as a starting template.

Scope & Limitations

In Scope: funnel definition (events, stages, transitions) via AARRR/AAARRR; conversion + drop-off math and bottleneck detection; Mermaid rendering; activation-event selection (Ellis); counter-metric pairing; cohort-vs-snapshot distinction; all 6 output formats.

Out of Scope: pulling raw event data (input is JSON — use Amplitude/Mixpanel/PostHog/Looker); statistical significance testing (discovery/brainstorm-experiments/, data-analytics); cohort-retention analysis; channel attribution (marketing tools); building the UX/A/B test; forecasting.

Caveats: a funnel implies a linear flow — real products branch and re-enter, so complement with branched analysis. Snapshot funnels mix cohorts and lie; always specify the cohort window. Top-stage gains amplify downstream and can mislead investment — look at both absolute and relative drop. Re-validate the activation event against fresh retention cohorts every 1-2 quarters.

Integration Points

IntegrationDirectionDescription
north-star-metric/Pairs withActivation rate is often the NSM or a top input metric in the NSM tree
brainstorm-okrs/Feeds intoFunnel-stage targets become KRs (e.g., "improve activation from 28% to 36%")
prioritization-frameworks/Feeds intoFix-the-funnel projects ranked by RICE / weighted-score
discovery/brainstorm-experiments/Pairs withEach funnel leak suggests testable experiments to plug it
discovery/identify-assumptions/Pairs with"Users will complete step 3 if we shorten it" is an assumption to validate
status-update-generator/Feeds intoWeekly funnel deltas appear in Highlights / Risks
outcome-roadmap/Pairs withRoadmap items justify themselves by which funnel stage they target
cycle-time-analyzer/Pairs withCycle time to fix funnel leaks is part of flow analysis
data-analytics/ (domain)Pairs withTelemetry instrumentation; cohort analysis; stat sig

© borghei, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 9 other files (scripts, references, assets) in project-management/execution/activation-funnel of borghei/Claude-Skills.

  • SKILL.md
  • assets/activation_metric_worksheet.md
  • assets/funnel_design_canvas.md
  • assets/sample_funnel.json
  • examples/freemium-saas-day-7-retention-diagnosis.md
  • references/activation-aha-moment-patterns.md
  • references/funnel-analysis-playbook.md
  • references/pirate-metrics-deep-dive.md
  • references/red-flags.md
  • scripts/funnel_analyzer.py

Open the folder on GitHubat commit 4a698e8

Compare with similar skills

Activation Funnel next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Activation Funnel compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Activation Funnel this skillborghei/Claude-Skills881—~1.9kAutomated safety check: PassMIT
Code Graph Mermaid Diagramstrailofbits/skills7.4k1 repos~1.7kAutomated safety check: PassCC-BY-SA-4.0
Code To Diagramzebbern/claude-code-guide4.7k1 repos~972Automated safety check: PassMIT
Design Doc MermaidSpillwaveSolutions/design-doc-mermaid1751 repos~5.6kAutomated safety check: PassNone
Markdown Mermaid Writingneflibata-feng/MyArxiv-Agent1265 repos~3.8kAutomated safety check: NotesApache-2.0
Generate Readmedivar-ir/ai-doc-gen766—~996Automated safety check: PassMIT

Similar skills

  • Code Graph Mermaid Diagrams

    trailofbits/skills

    Official

    Generates Mermaid diagrams from Trailmark code graphs, including call graphs, class hierarchies, module dependency maps, complexity heatmaps and attack surface data flows.

    7.4k GitHub starsUsed in 1 repo~1.7k tokens
    DevelopmentAuto-check passed
  • Code To Diagram

    zebbern/claude-code-guide

    Analyze codebases and automatically generate architecture diagrams, flowcharts, and org charts.

    4.7k GitHub starsUsed in 1 repo~972 tokens
    DevelopmentAuto-check passed
  • Design Doc Mermaid

    SpillwaveSolutions/design-doc-mermaid

    Create Mermaid diagrams (flowchart, sequence, class, ER, state, C4, architecture) from text or source code.

    175 GitHub starsUsed in 1 repo~5.6k tokens
    DevelopmentAuto-check passed
  • Markdown Mermaid Writing

    neflibata-feng/MyArxiv-Agent

    Comprehensive markdown and Mermaid diagram writing skill that establishes text-based diagrams as the DEFAULT documentation standard.

    126 GitHub starsUsed in 5 repos~3.8k tokens
    DevelopmentAuto-check: notes
  • Generate Readme

    divar-ir/ai-doc-gen

    Generate or refresh a comprehensive, professional README.md for a repository, with architecture overview, mermaid and optional C4 diagrams, repository structure, dependencies, and API documentation.

    766 GitHub stars~996 tokensUpdated 2 mo ago
    DevelopmentAuto-check passed
  • Book Writer

    aospbooks/aosp-internal-book

    Patterns for writing technical book chapters in Markdown with Mermaid diagrams, served via ProperDocs (a MkDocs fork).

    138 GitHub stars~3.1k tokensUpdated 3 days ago
    DevelopmentAuto-check passed

More from borghei/Claude-Skills

All 349 skills in this repo
  • Agents In The Team

    borghei/Claude-Skills

    Run delivery when AI coding and ops agents take tickets. An agent skill from borghei/Claude-Skills.

    881 GitHub stars~4.2k tokensUpdated yesterday
    Auto-check passed
  • AI Content Disclosure

    borghei/Claude-Skills

    Check AI-generated marketing content and reviews for required disclosures under the EU AI Act, FTC rules and platform AI-label policies.

    881 GitHub stars~3.4k tokensUpdated yesterday
    Auto-check passed
  • AI Prototyping

    borghei/Claude-Skills

    Idea to AI-generated prototype to customer validation to engineering handoff.

    881 GitHub stars~3.6k tokensUpdated yesterday
    Auto-check passed
  • Analytics Engineer

    borghei/Claude-Skills

    Analytics engineering across data modeling, dbt, transformation, and semantic layers.

    881 GitHub stars~3.4k tokensUpdated yesterday
    Auto-check passed
  • Ansoff Matrix

    borghei/Claude-Skills

    Ansoff Matrix — 4-quadrant framework for growth options: market penetration, market/product development, and diversification.

    881 GitHub stars~2.2k tokensUpdated yesterday
    Auto-check passed
  • Brainstorm Okrs

    borghei/Claude-Skills

    OKR brainstorming and validation using the Radical Focus framework — outcome objectives, measurable key results, counter-metrics.

    881 GitHub stars~1.4k tokensUpdated yesterday
    Auto-check passed

Works with

Questions about Activation Funnel

What does Activation Funnel do?

Design and analyze activation funnels (AARRR / AAARRR Pirate Metrics) with conversion + drop-off math, bottleneck detection, and Mermaid funnel diagrams. Activation Funnel is an agent skill from borghei/Claude-Skills. Design and analyze activation funnels (AARRR / AAARRR Pirate Metrics) with conversion + drop-off math, bottleneck detection, and Mermaid funnel diagrams.

When should I use Activation Funnel?

Activation Funnel fits situations like: tasks that involve Product metrics; tasks that involve Diagrams.

How do I install Activation Funnel in Claude Code?

Run `npx skills add borghei/Claude-Skills --skill activation-funnel -a claude-code`. Or copy the skill folder (project-management/execution/activation-funnel in borghei/Claude-Skills) into .claude/skills/activation-funnel in your project. Claude Code loads it when a task matches its description.

How do I install Activation Funnel in Codex?

Run `npx skills add borghei/Claude-Skills --skill activation-funnel -a codex`. Or copy the skill folder (project-management/execution/activation-funnel in borghei/Claude-Skills) into .agents/skills/activation-funnel in your project. Codex loads it when a task matches its description.

Can I use Activation Funnel in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add borghei/Claude-Skills --skill activation-funnel -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/activation-funnel, .gemini/skills/activation-funnel, .github/skills/activation-funnel and .opencode/skills/activation-funnel in your project.

What does Activation Funnel need to run?

Going by SKILL.md and its folder, Activation Funnel needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Activation Funnel access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Activation Funnel safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Activation Funnel use?

Activation Funnel is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Activation Funnel use?

About 1.9k tokens (SKILL.md is roughly 7.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 11k tokens, read only when the agent opens those files.

What are the alternatives to Activation Funnel?

Skills that share tags, products or a category with Activation Funnel: Code Graph Mermaid Diagrams (trailofbits/skills, 7.4k stars), Code To Diagram (zebbern/claude-code-guide, 4.7k stars), Design Doc Mermaid (SpillwaveSolutions/design-doc-mermaid, 175 stars) and Markdown Mermaid Writing (neflibata-feng/MyArxiv-Agent, 126 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Activation Funnel?

borghei (a GitHub user) maintains it in borghei/Claude-Skills, which has 881 GitHub stars. The repository holds 349 skills in this directory. The repository was last updated on October 7, 2026.

Source: borghei/Claude-Skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.