SkillAgentSearch skills...

vibe-bill

Claude Code skill that estimates what your vibe-coded app will cost to run at 100 / 1k / 10k / 100k users, flags code patterns that inflate the bill, and renders a shareable receipt.

Install / Use

npx skills add globalmpc/vibe-bill

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

85/100

Supported Platforms

Claude Code

Our assessment of vibe-bill

vibe-bill scores 85/100 on our quality scale, 565th of 948 AI & Machine Learning skills we index.

Its SKILL.md is 6.9 KB long, well organised into 12 sections with 5 code examples: a thorough specification that gives an agent plenty to work with.

It has 42 GitHub stars, so there is little community track record yet; judge it on its content.

Substance
29/30
Structure
20/20
Description
15/15
Adoption
7/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated 5 days ago, so vibe-bill is actively maintained.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 97/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

vibe-bill compared with similar skills

All 4 of these similar skills score higher than vibe-bill; compare them before choosing.

SkillScoreStarsUpdatedFormat
vibe-bill (this skill)by globalmpc85425d agoSKILL.md
claude-memby thedotmack100117.9ktodayCLAUDE.md
Understand-Anythingby Egonex-AI10093.0k2d agoCLAUDE.md
rufloby ruvnet10082.0ktodayCLAUDE.md
headroomby headroomlabs-ai10079.9ktodayCLAUDE.md

Frequently asked questions

How do I install vibe-bill?
Run npx skills add globalmpc/vibe-bill. The install tabs above show the steps for each supported agent.
Which AI agents does vibe-bill work with?
It is written for Claude Code, as a SKILL.md file. Other agents that read the same format can often use it too.
Is vibe-bill safe to use?
It is MIT-licensed and scores 97/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is vibe-bill still maintained?
The repository was last updated 5 days ago, so vibe-bill is actively maintained.

Example receipt: generated from the next-openai-supabase fixture, not a real app

Example receipt generated from a fixture app in this repo (fixtures/next-openai-supabase), not a real project.

vibe-bill

You built an app with AI. What will it cost to run when people actually use it?

vibe-bill is a Claude Code skill. Type /vibe-bill in your project and it:

  • estimates your monthly bill at 100, 1,000, 10,000 and 100,000 users (or any user counts you choose, see below),
  • points out the things in your code that make the bill bigger than it needs to be,
  • gives you a receipt image you can share (it shows one user count, 10,000 by default), and a plain-language report with the bill for every user count.

Install

You need Claude Code and Node 22 or newer (check with node -v).

Easiest: run this in your project's folder.

npx skills add globalmpc/vibe-bill -a claude-code

No npx? Copy it by hand instead (Node 20 is enough to run the skill itself):

git clone https://github.com/globalmpc/vibe-bill.git /tmp/vibe-bill
mkdir -p .claude/skills && cp -r /tmp/vibe-bill/skills/vibe-bill .claude/skills/

Or just ask Claude Code: "Install the vibe-bill skill from https://github.com/globalmpc/vibe-bill into this project."

Use it

  1. Open your app's folder in Claude Code.
  2. Type /vibe-bill.
  3. Answer up to 4 quick questions, like which AI model you use in production and which plan you pay for. Not sure? Pick your best guess; anything you skip is assumed and marked as assumed.
  4. Open .vibe-bill/out/receipt.png. That's your receipt. .vibe-bill/out/report.md explains the numbers.

Want no questions at all? Type /vibe-bill --no-questions.

Share the receipt, not the report. The receipt never shows file names, secret names or secrets. The report does mention file names from your code.

Is it safe?

  • It never reads your secret values. It only looks at the names of your environment variables (like OPENAI_API_KEY), never what's inside them. It will not open your .env files.
  • It never changes your code. The only thing it writes is a .vibe-bill/ folder in your project.
  • Your code is read by Claude, the same as any other Claude Code request.
  • It uses the internet only for prices: the public OpenRouter model price list, and a web search for services it doesn't already know.

What it checks

  • AI calls (OpenAI, Anthropic, Google, OpenRouter): which model you use, how often each call runs, and about how much text goes in and out.
  • Services with a free tier (Supabase, Vercel, Clerk, Resend, Stripe): when you'd outgrow the free plan, when you'd have to upgrade, and the fees.
  • Other services (for example Replicate): the price is looked up on the web once and shown as (unverified).
  • Things that quietly burn money:
    • an AI call on every keystroke or every re-render
    • the whole chat history sent again on every message
    • an expensive top model doing a simple job
    • repeated identical AI requests with no caching
    • a public AI endpoint with no rate limit (anyone can run up your bill)
    • checking for updates constantly (polling)
    • resizing every uploaded image into many versions
    • loading whole database tables when you need a few rows
    • files stored inside database rows

Good to know

  • It's an estimate, not an invoice. Real traffic, discounts and free credits are unknown to it.
  • AI prices are list prices from OpenRouter. Discounts from caching or batch pricing are not included, so your real bill may be lower.
  • Every price shows where it came from and the date it was checked. Prices older than 30 days are marked "may be outdated".
  • Usage is guessed. If your code can't tell how many messages a user sends, it assumes a typical number (see below) and the report tells you which.
  • Some extras are not counted, for example CDN traffic, extra team seats, Stripe international and currency fees, and paid add-ons.
  • It can miss things. It finds services by looking for known package names, variable names and code patterns.
  • The AI never makes up a dollar amount. Claude only describes how your app uses things; the code does all the math.

Fresh prices

By default, vibe-bill uses a saved price list, so running it twice gives the same numbers. The date is printed on the receipt.

  • AI model prices: want today's? Ask for fresh prices. It downloads the current OpenRouter list, and the price date on the receipt changes to today. Two ways to ask:
    • Right after a run, tell Claude: "Run it again with fresh prices."
    • Or start with it: /vibe-bill . use fresh prices (the . means "this folder").
  • Supabase, Vercel, Clerk, Resend, Stripe: these only change when the skill is updated. If the receipt says "may be outdated", reinstall the skill to get the latest.

Using a proxy or gateway (9router, LiteLLM, ...)?

vibe-bill finds your AI provider from your code: the SDK package or an env name like ANTHROPIC_API_KEY. If your app talks to Claude through a proxy, none of that is there, so it can't see the provider.

When it finds AI calls but no provider, it asks you which one (OpenAI, Anthropic, Google AI or OpenRouter) and remembers the answer. With --no-questions it stops and tells you what to add. You can also set it yourself in .vibe-bill/config.json:

{ "schema": 1, "llm_providers": ["anthropic"] }

Then run /vibe-bill again. The model question that follows ("Which model does production use?") is where you pick Sonnet, Haiku and so on.

Check a different number of users

The receipt shows 10,000 users. The report has a column for each of 100, 1,000, 10,000 and 100,000. Want to see 1,000,000 (or any other number)?

  • Easiest: tell Claude "Run vibe-bill for 1,000,000 users."
  • Or edit .vibe-bill/config.json and run /vibe-bill again:
{ "schema": 1, "assumptions": { "tiers": [1000, 100000, 1000000] } }

You can list 1 to 6 whole numbers. The receipt shows the 10,000 one if it's in your list; otherwise it shows the biggest. With "tiers": [1000000] you get a receipt and a report just for 1M users.

Change the guesses

Every guess (active users per day, messages per user per day, ...) is listed in the report with the reason for it. To change one, put your own number in .vibe-bill/config.json and run /vibe-bill again:

{ "schema": 1, "assumptions": { "messages_per_active_user_per_day": 12 } }

The full list of guesses is in data/assumptions.default.json. If editing JSON feels like too much, ask Claude Code: "Set messages per user per day to 12 for vibe-bill and rerun it."

Contributing

Price corrections are the most useful help. See CONTRIBUTING.md.

License

MIT, see LICENSE. Third-party parts bundled in skills/vibe-bill/scripts/ keep their own licenses and are listed in THIRD_PARTY_NOTICES.md.

Related Skills

View on GitHub
GitHub Stars42
CategoryAI
Updated5d ago
Forks0

Languages

TypeScript

Trust signals

97/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 info