revenuecat-billing — Claude Code skill: billing and setup
The revenuecat-billing skill lets an agent inspect a developer’s RevenueCat plan, MTR, invoices, and payment setup. It works with Claude Code, Codex, Cursor, and other listed platforms.
MIT 315 installs ★ 79 updated 2026-10-21
npx skills add RevenueCat/ai-toolkit --skill revenuecat-billing -a claude-codeWhat revenuecat-billing does
The skill handles questions about RevenueCat account billing rather than customer subscription invoices. It uses get-account-billing for the current plan, Monthly Tracked Revenue (MTR), and payment-method status, then uses list-account-billing-invoices to retrieve invoice amounts and statuses. The rc invoices command is for customer invoices, so it is the wrong lookup here.
It also explains the Pro calculation: when MTR goes above $2,500, RevenueCat charges 1% of all tracked revenue, including the amount below the threshold. Invoice amounts are rounded down to whole dollars. Billing periods follow the same day-to-day date range across consecutive months rather than calendar months.
There is a project-role restriction. If the user is not the owner, get-account-billing does not apply to that project, and the owner must check the plan. For an enterprise plan, detailed billing goes through the Customer Success manager.
What it helps with
- check the current RevenueCat plan
- inspect MTR and payment-method status
- list RevenueCat invoices with their amounts
- explain a Pro-plan charge
- separate account billing from customer invoices
Example prompts for the agent
- Check my RevenueCat plan, current MTR, and payment-method status.
- List my RevenueCat invoices with their amounts and statuses using
list-account-billing-invoices. - Explain why my Pro plan generated a charge this month.
How to install revenuecat-billing
1Skills CLI (Vercel)
npx skills add RevenueCat/ai-toolkit --skill revenuecat-billing -a claude-code2Manually: put the files in place
~/.claude/skills/revenuecat-billing/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/revenuecat-billing/
1Skills CLI (Vercel)
npx skills add RevenueCat/ai-toolkit --skill revenuecat-billing -a codex2Manually: put the files in place
.agents/skills/revenuecat-billing/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add RevenueCat/ai-toolkit --skill revenuecat-billing -a cursor2Manually: put the files in place
.cursor/skills/revenuecat-billing/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install RevenueCat/ai-toolkit revenuecat/skills/revenuecat-billing2Manually: put the files in place
.github/skills/revenuecat-billing/SKILL.md1Skills CLI (Vercel)
npx skills add RevenueCat/ai-toolkit --skill revenuecat-billing -a gemini-cli2Platform CLI
gemini skills install https://github.com/RevenueCat/ai-toolkit --path revenuecat/skills/revenuecat-billingManually: put the files in place
.devin/skills/revenuecat-billing/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add RevenueCat/ai-toolkit --skill revenuecat-billing -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 revenuecat-billing
How do I install revenuecat-billing in Claude Code?
Run npx skills add RevenueCat/ai-toolkit --skill revenuecat-billing -a claude-code, then check ~/.claude/skills/revenuecat-billing/SKILL.md.
What does revenuecat-billing do?
It helps an agent inspect a developer’s RevenueCat plan, MTR, payment setup, and account invoices. It also keeps developer billing separate from customer subscription invoices.
Why does revenuecat-billing avoid rc invoices?
rc invoices lists a customer’s invoices in the RevenueCat dashboard. Account billing uses get-account-billing and list-account-billing-invoices instead.
Source text
SKILL.md · MIT
--- name: revenuecat-billing description: Use when the user asks about their RevenueCat plan, billing, their RevenueCat invoices, or how much they will have to pay RevenueCat. --- # RevenueCat account billing This is the **developer's RevenueCat plan and invoices**, not customer subscription invoices (`rc invoices` / customer billing in the dashboard). Use: - `get-account-billing` — current plan, usage / Monthly Tracked Revenue (MTR), whether a payment method is set up. - `list-account-billing-invoices` — RevenueCat invoices including amount and status. There is no first-class CLI command for account billing. Do not use `rc invoices`, which lists a **customer's** invoices. ## Context - RevenueCat bills based on **Monthly Tracked Revenue (MTR)** for each plan (except `enterprise` plans, which have custom billing). MTR is not Monthly Recurring Revenue (MRR): it includes revenue from all purchases and renewals, including non-subscription products. Current MTR comes from `get-account-billing`. Billing periods are not calendar months — they run from the same date of a month until the same date of the next month (for example July 15 until August 15). - If the user's role on the current project is not `owner`, `get-account-billing` does **not** apply to that project. Only the owner can see what plan the project is under. Tell them to contact the project owner. Use `list-collaborators` (and `list-projects`) to find the owner's email when available. - For users on an `enterprise` plan, direct them to their Customer Success manager for detailed billing. - Billing settings: https://app.revenuecat.com/settings/billing ## Pro plan Most users are on the Pro plan. Pro has a free allowance of $2,500 MTR. If that threshold is crossed in a month, the user is billed 1% of all tracked revenue (invoice amounts are full dollars, rounded down), including the portion below $2,500. If MTR falls back below the threshold in later months, they are not charged. A charge is made only in months where MTR is above $2,500. When that limit is passed and the RevenueCat account is at least one month old, access to some features is restricted immediately until a payment succeeds: - View and Filter Charts - Create new Customer Lists - Export Customer Lists - View Customer History (Customer Details remain) - View individual events - Add Customer Attributes - Create new Experiments - Edit running Experiments (viewing results and stopping remain) - Create new Paywalls - Edit existing Paywalls (using existing Paywalls remains) ## Invoice details The user can update company name, address, and Tax ID/VAT on invoices in [billing settings](https://app.revenuecat.com/settings/billing) under **Invoice details**. If they have not added a payment method, they will not receive invoices and cannot change invoice details. If they need more than one Tax ID, or want invoices forwarded to a different email, they need to contact RevenueCat support. Do not offer this proactively — only when they explicitly ask.
© RevenueCat · MIT · RevenueCat/ai-toolkit