BILLING / Stripe
Metronome
Stripe's Metronome skill for usage ingestion, contracts, and invoice sync, with confirmation required before writes because sandbox and production share one API host.
“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.”
01 / THE REASONING
Why this made the selection.
- The catalogue has stripe-pay and withholds two other Stripe skills; it has no Metronome skill.
- The file separates read-only CSM review from workflows that create contracts and end Stripe subscriptions.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- skills/metronome/SKILL.md
- README.md
- LICENSE
Our findings
- The skill says to use Contracts rather than legacy Plans for new customers, and Edits rather than Amendments for mid-term changes.
- It requires a unique transaction_id that stays fixed across retries, batch POST /v1/ingest of 1 to 100 events, and USD amounts in cents.
- It says sandbox and production share https://api.metronome.com, so the token selects the environment, and it requires a separate confirmation before Stripe writes.
Not established by this review
- The skill was not executed.
- No Metronome or Stripe API call was made.
- Linked docs.metronome.com skills were not opened.
- Not executed: it was not installed or run.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Add a skill to your workflow.
DOCUMENTED COMMAND
npx skills add https://docs.stripe.comRun in your terminal to choose your AI tools, project or global scope, and installation method. This short command follows the current upstream version; the review covers the revision shown above.
- The README presents that command as the manual skill install.
- It tracks https://docs.stripe.com rather than the pinned commit reviewed here.
- Other README lines install the Stripe plugin for Claude, Codex, Cursor, or Grok and were not treated as this file's command.
Before you start
- A skills-compatible client
- A Metronome bearer token only when an API call is made
- Explicit confirmation before any write
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
- metronome SKILL.md ↗Checked
https://github.com/stripe/ai/blob/789ef5e0a55ee1d0787a5974660b15bf76dc29b5/skills/metronome/SKILL.md
Supports: contracts, idempotency, and confirmation rules
- MIT LICENSE ↗Checked
https://github.com/stripe/ai/blob/789ef5e0a55ee1d0787a5974660b15bf76dc29b5/LICENSE
Supports: MIT grant
- README manual install ↗Checked
https://github.com/stripe/ai/blob/789ef5e0a55ee1d0787a5974660b15bf76dc29b5/README.md
Supports: the docs.stripe.com install command
https://raw.githubusercontent.com/stripe/ai/789ef5e0a55ee1d0787a5974660b15bf76dc29b5/skills/metronome/SKILL.md
Supports: upstreamDescription, limitations, review.notTested, review.reviewedAt