understanding-billing-usage — Claude Code skill for spend analysis
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.
no license 150 installs ★ 101 updated 2026-10-24
npx skills add PostHog/ai-plugin --skill understanding-billing-usage -a claude-codeWhat understanding-billing-usage 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.
What it helps with
- 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 for the agent
- 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.
How to install understanding-billing-usage
1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill understanding-billing-usage -a claude-code2Manually: put the files in place
~/.claude/skills/understanding-billing-usage/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/understanding-billing-usage/
1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill understanding-billing-usage -a codex2Manually: put the files in place
.agents/skills/understanding-billing-usage/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill understanding-billing-usage -a cursor2Manually: put the files in place
.cursor/skills/understanding-billing-usage/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install PostHog/ai-plugin skills/understanding-billing-usage2Manually: put the files in place
.github/skills/understanding-billing-usage/SKILL.md1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill understanding-billing-usage -a gemini-cli2Platform CLI
gemini skills install https://github.com/PostHog/ai-plugin --path skills/understanding-billing-usageManually: put the files in place
.devin/skills/understanding-billing-usage/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill understanding-billing-usage -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 understanding-billing-usage
How do I install understanding-billing-usage in Claude Code?
Run npx skills add PostHog/ai-plugin --skill understanding-billing-usage -a claude-code. The skill file is at ~/.claude/skills/understanding-billing-usage/SKILL.md.
What does understanding-billing-usage do?
It analyzes PostHog usage and spend by type and team, then routes deeper investigation to MCP tools for the affected product.
What does understanding-billing-usage need to work?
Billing MCP read tools must be available. Deeper cause analysis uses MCP tools for the affected product.