# understanding-billing-usage

understanding-billing-usage is a Claude Code skill that investigates PostHog usage and spend through Billing MCP tools. It handles questions about spikes, changes, and the products or projects behind usage.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 150 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/understanding-billing-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/understanding-billing-usage

## What it does

The skill breaks down PostHog usage by type and team to show what changed and which project drove it. For questions about money, it adds spend data; for a deeper cause analysis, it moves to MCP tools for the affected product. The workflow starts with Billing MCP read tools. It cannot run this investigation when those tools are unavailable.

It covers high usage, metric changes, and alerts about spikes or drops. To investigate a cause, it first identifies the usage type, project, and time period. General questions about invoices, plans, refunds, and contracts fall outside its scope.

## Install

### Claude Code (native platform)

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

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill understanding-billing-usage -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill understanding-billing-usage -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install PostHog/ai-plugin skills/understanding-billing-usage
```

2. **Manually: put the files in place**
- File: `.github/skills/understanding-billing-usage/SKILL.md`

### Gemini CLI

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

2. **Platform CLI**
```bash
gemini skills install https://github.com/PostHog/ai-plugin --path skills/understanding-billing-usage
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill understanding-billing-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/understanding-billing-usage/SKILL.md

## When to use it
- identify the product or project driving higher spend
- compare usage across time periods
- investigate an alert about a metric spike or drop
- trace high usage and find product-specific ways to reduce it

## Example prompts
- Why did event usage increase in PostHog?
- Which team drove the higher recording spend over the last month?
- Check whether the usage spike in this alert was real.

## Similar
- [qianwen-usage](https://affpapa.org/en/nevibecode/skills/qianwen-usage.md) — skill · 6100 installs
- [usage-based-billing](https://affpapa.org/en/nevibecode/skills/usage-based-billing.md) — skill · 803 installs
- [qwencloud-usage](https://affpapa.org/en/nevibecode/skills/qwencloud-usage.md) — skill · 1700 installs
- [convex-billing](https://affpapa.org/en/nevibecode/skills/convex-billing.md) — skill · 43800 installs
- [huawei-cloud-billing-scout](https://affpapa.org/en/nevibecode/skills/huawei-cloud-billing-scout.md) — skill · 18500 installs
- [clerk-billing](https://affpapa.org/en/nevibecode/skills/clerk-billing.md) — skill · 17800 installs

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
