Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add PostHog/ai-plugin --skill understanding-billing-usage -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/understanding-billing-usage/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/understanding-billing-usage/

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.

Similar skills

All skills for Finance and business →

From the same set82

The whole set →
modeling-warehouse-foundations modeling-warehouse-foundations sets core guidelines for building PostHog data models via native HogQL views or an external dbt setup. CX Codex +1 172installs instrument-metrics The instrument-metrics Claude Code skill adds PostHog metric capture to a codebase. It runs after feature work or PR review, and when a request calls for counters or other metrics. CX Codex +1 154installs debugging-experiments debugging-experiments — a Claude Code skill for investigating PostHog experiment results. It checks uneven or missing exposures against the experiment’s data and known causes. CX Codex +1 150installs context-layer-health-check The context-layer-health-check Claude Code skill checks a context wiki after changes are consolidated. It triages missed entries, conflicting claims, and outdated priorities. CX Codex +1 150installs building-html-canvases The building-html-canvases Claude Code skill builds PostHog canvases with semantic HTML, CSS, and browser APIs. It runs when a canvas request is routed to a plain HTML implementation. CX Codex +1 149installs composing-grid-canvases The composing-grid-canvases Claude Code skill arranges PostHog grids from reusable widgets. It activates for requests to add, resize, move, or remove a placement, or assemble a whole canvas. CX Codex +1 149installs working-with-task-comments The working-with-task-comments Claude Code skill retrieves comments on PostHog tasks, their artifacts, and canvases. It activates when an agent needs to inspect feedback or follow a discussion thread. CX Codex +1 149installs 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. CX Codex +1 149installs

Project sponsors

Companies that keep this analytics open