# Metronome

Guides Metronome usage-based billing integration decisions, event ingestion (single...

- Repository: https://github.com/stripe/ai (2027 stars)
- Category: Design
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add stripe/ai --skill metronome -g -a claude-code -y`
Codex: `npx skills add stripe/ai --skill metronome -g -a codex -y`
Cursor: `npx skills add stripe/ai --skill metronome -g -a cursor -y`
Gemini CLI: `npx skills add stripe/ai --skill metronome -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add stripe/ai`

## Description

Guides Metronome usage-based billing integration decisions, event ingestion (single and batch, idempotency, billable metrics), contract design (rate cards, overrides, dimensional pricing, products), invoicing lifecycle (grace periods, finalization, Stripe sync), credit and commit management (prepaid, postpaid, thresholds, auto-recharge), and Stripe integration (arrears invoicing, tax providers, line item limits). Use when building, modifying, or reviewing any Metronome integration, including ingesting usage events, creating customers, contracts, or rate cards, designing billable metric group keys, managing credits and commits, configuring invoicing, syncing invoices with Stripe Billing, billing AI applications for token usage, setting up self-serve (PLG) pricing, reviewing customer health, commit burn, portfolios, or renewals, or migrating from Stripe Billing Meters to Metronome.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

Metronome API base: `https://api.metronome.com`. Authenticate with a Bearer token in the `Authorization` header. Always use Contracts (not legacy Plans) for new integrations.

## Integration routing

The rest: https://github.com/stripe/ai/blob/HEAD/providers/agent-plugins/plugin/skills/metronome/SKILL.md