# signals-scout-customer-analytics-billing-and-usage

signals-scout-customer-analytics-billing-and-usage — a skill for Claude Code that tracks product usage and forecast MRR changes within individual accounts. It spots product-level shifts hidden by a steady account total.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 149 installs · ★ 101 repo stars
- Author: PostHog
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/PostHog/ai-plugin/tree/HEAD/skills/signals-scout-customer-analytics-billing-and-usage/SKILL.md
- Updated: 2026-10-24
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/signals-scout-customer-analytics-billing-and-usage

## What it does

The skill flags accounts where usage or forecast MRR for one product moves against its seasonal baseline while the account total stays steady. It weighs each change by that product’s share of the bill and checks both drops and spikes. An account must have a manager relationship or a CRM link.

Scoring requires accessible billing views and a join between `system.accounts.external_id` and `organization_id` in the billing data. The setup uses PostHog MCP with read-only analytics access and write scopes for `signal_scout_internal` and `signal_scout_report`. It also relies on the Signals Scout tool family, `execute-sql`, customer analytics tools, `read-data-schema`, and inbox tools. If billing data is unreachable or the account join fails, the run closes without a report.

The skill files reports for confirmed shifts and edits an existing report when the same movement continues. It does not cover account-wide engagement, aggregate MRR changes, or product regressions affecting the whole fleet.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill signals-scout-customer-analytics-billing-and-usage -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/signals-scout-customer-analytics-billing-and-usage/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/signals-scout-customer-analytics-billing-and-usage/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill signals-scout-customer-analytics-billing-and-usage -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/signals-scout-customer-analytics-billing-and-usage/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill signals-scout-customer-analytics-billing-and-usage -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/signals-scout-customer-analytics-billing-and-usage/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install PostHog/ai-plugin skills/signals-scout-customer-analytics-billing-and-usage
```

2. **Manually: put the files in place**
- File: `.github/skills/signals-scout-customer-analytics-billing-and-usage/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill signals-scout-customer-analytics-billing-and-usage -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/PostHog/ai-plugin --path skills/signals-scout-customer-analytics-billing-and-usage
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/signals-scout-customer-analytics-billing-and-usage/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill signals-scout-customer-analytics-billing-and-usage -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/PostHog/ai-plugin/tree/HEAD/skills/signals-scout-customer-analytics-billing-and-usage/SKILL.md

## When to use it
- spot a product usage drop while the account total stays flat
- catch a product spike that raises an account’s bill
- weigh a product-level change by its share of account MRR
- update an existing report when a flagged shift continues

## Example prompts
- Find accounts where one product’s usage is falling while the total stays steady.
- Check for product-level forecast MRR spikes and report confirmed cases.
- Update any report for a product-mix shift that is still underway.

## Similar
- [signals-scout-web-analytics](https://affpapa.org/en/nevibecode/skills/signals-scout-web-analytics.md) — skill · 317 installs
- [signals-scout-revenue-analytics](https://affpapa.org/en/nevibecode/skills/signals-scout-revenue-analytics.md) — skill · 313 installs
- [usage-based-billing](https://affpapa.org/en/nevibecode/skills/usage-based-billing.md) — skill · 803 installs
- [huawei-cloud-billing-scout](https://affpapa.org/en/nevibecode/skills/huawei-cloud-billing-scout.md) — skill · 18500 installs
- [customer-churn-signals](https://affpapa.org/en/nevibecode/skills/customer-churn-signals.md) — skill · 26700 installs
- [klingai-usage-analytics](https://affpapa.org/en/nevibecode/skills/klingai-usage-analytics.md) — skill · 1 install

From the same set: [posthog/ai-plugin](https://affpapa.org/en/nevibecode/by/posthog/ai-plugin.md) — 82 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
