Content
# Stripe Expert Skills
AI agent skills that make your assistant a **full Stripe expert**. Covers revenue analytics, growth & forecasting, customer intelligence, finance & tax, fraud, engineering/integration, and advanced products (Connect, usage-based billing). Built for founders, finance, and engineering teams using **Cursor**, **Claude Code**, or any [Agent Skills](https://agentskills.io)-compatible assistant.
<img width="2364" height="1576" alt="image" src="https://github.com/user-attachments/assets/62ea783c-ea25-4242-8772-9284e7cb25d0" />
Powered by the [Stripe MCP server](https://docs.stripe.com/mcp) — your agent reads live subscription, invoice, and payment data directly from your Stripe account.
## Quick Start
**Stripe MCP** — add to Cursor MCP config ([docs](https://docs.stripe.com/mcp)):
```json
{
"mcpServers": {
"stripe": {
"url": "https://mcp.stripe.com"
}
}
}
```
Authenticate via OAuth when prompted.
**Install skills**
```bash
git clone https://github.com/appeeky/stripe-skills.git
cp -r stripe-skills/skills/* ~/.cursor/skills/
# or project-level: .cursor/skills/
```
Then ask your agent:
```
"What's our MRR and how many active subs?"
"Show past due subscriptions and why payments failed"
"Audit prepaid vs debit cards on active subscriptions"
"Set up Radar rules to block prepaid cards"
"Is our payment-failed email flow configured?"
"Run a full Stripe billing health check"
```
**Don't want to remember 35 skill names?**
```
/stripe-skill → routes to the right specialist automatically
```
## Skills (35)
### Router & Foundation
| Skill | What it does |
| --------------------------------------------------------- | ----------------------------------------------------------------------- |
| `[stripe-router](skills/stripe-router)` | **Single entry point** — routes any billing question to the right skill |
| `[stripe-billing-context](skills/stripe-billing-context)` | Creates `stripe-billing-context.md` — products, webhooks, KPI targets |
### Revenue & Subscriptions
| Skill | What it does |
| ----------------------------------------------------------------- | ---------------------------------------------------------- |
| `[mrr-arr-snapshot](skills/mrr-arr-snapshot)` | MRR, ARR, breakdown by plan (paginated, annual normalized) |
| `[active-subscriptions-audit](skills/active-subscriptions-audit)` | Counts by status: active, trialing, past_due, unpaid |
| `[churn-analysis](skills/churn-analysis)` | Cancellations, voluntary vs involuntary churn signals |
| `[subscription-plan-changes](skills/subscription-plan-changes)` | Upgrades, downgrades, proration, anti double-billing |
### Payments & Recovery
| Skill | What it does |
| ------------------------------------------------------- | ------------------------------------------------------------- |
| `[past-due-dunning](skills/past-due-dunning)` | Past due subs, retry attempts, MRR at risk |
| `[payment-failure-audit](skills/payment-failure-audit)` | Declined charges, failure reasons, failure rate |
| `[card-funding-risk](skills/card-funding-risk)` | Prepaid / debit / credit mix — virtual card churn patterns |
| `[email-dunning-setup](skills/email-dunning-setup)` | Stripe billing emails + custom `invoice.payment_failed` flows |
| `[customer-portal-setup](skills/customer-portal-setup)` | Portal config for payment method updates |
### Fraud & Pricing
| Skill | What it does |
| --------------------------------------------------------- | --------------------------------------------- |
| `[radar-fraud-rules](skills/radar-fraud-rules)` | Radar rules — block prepaid, 3DS, risk levels |
| `[pricing-products-audit](skills/pricing-products-audit)` | Products, prices, which plans drive revenue |
| `[coupon-promotion-audit](skills/coupon-promotion-audit)` | Coupons, promo codes, discount impact |
### Operations
| Skill | What it does |
| ----------------------------------------------------------- | ------------------------------------------------------------- |
| `[checkout-conversion](skills/checkout-conversion)` | Checkout session completion vs abandonment |
| `[invoice-revenue-audit](skills/invoice-revenue-audit)` | Paid/open/uncollectible invoices — cash collected |
| `[webhook-reliability](skills/webhook-reliability)` | Webhook events, missing handlers, sync gaps |
| `[dispute-refund-audit](skills/dispute-refund-audit)` | Chargebacks, disputes, refunds |
| `[payout-balance-report](skills/payout-balance-report)` | Balance, payouts, net cash flow |
| `[stripe-health-dashboard](skills/stripe-health-dashboard)` | **Full billing health check** — orchestrates all of the above |
### Growth & Forecasting
| Skill | What it does |
| --------------------------------------------------- | -------------------------------------------------------- |
| `[revenue-forecasting](skills/revenue-forecasting)` | Projects MRR/ARR 3/6/12 months from growth + churn |
| `[cohort-retention](skills/cohort-retention)` | Retention & revenue-retention tables by signup cohort |
| `[pricing-experiments](skills/pricing-experiments)` | Price A/B tests, increases, grandfathering, elasticity |
| `[upsell-expansion](skills/upsell-expansion)` | Expansion revenue, NRR, add-on/tier upsell opportunities |
### Customer Intelligence
| Skill | What it does |
| ------------------------------------------------------- | ------------------------------------------------------------- |
| `[customer-360](skills/customer-360)` | Full single-customer profile: LTV, payment health, churn risk |
| `[customer-segmentation](skills/customer-segmentation)` | Segment base by plan/country/funding/tenure/value |
### Finance & Accounting
| Skill | What it does |
| ------------------------------------------------------------- | ---------------------------------------------------- |
| `[revenue-recognition](skills/revenue-recognition)` | Deferred vs recognized revenue, MRR-vs-cash, accrual |
| `[tax-compliance](skills/tax-compliance)` | Stripe Tax, VAT/GST/sales tax, nexus coverage |
| `[financial-reconciliation](skills/financial-reconciliation)` | Payout ↔ bank reconciliation, fee breakdown |
### Engineering & Integration
| Skill | What it does |
| --------------------------------------------------------------- | --------------------------------------------------------- |
| `[stripe-integration-review](skills/stripe-integration-review)` | Code audit: idempotency, API version, race conditions |
| `[webhook-implementation](skills/webhook-implementation)` | Build/fix webhook handlers, signature verify, idempotency |
| `[checkout-implementation](skills/checkout-implementation)` | Build Checkout/Payment Element flows, customer reuse |
| `[stripe-security-audit](skills/stripe-security-audit)` | Key hygiene, secret leaks, PCI scope, restricted keys |
### Advanced Products
| Skill | What it does |
| --------------------------------------------------- | --------------------------------------------------------- |
| `[stripe-connect](skills/stripe-connect)` | Marketplace payouts, connected accounts, application fees |
| `[usage-based-billing](skills/usage-based-billing)` | Metered billing, meters, credits, overage tiers |
## How It Works
```
You: "What's our MRR and how many past due subs?"
Agent:
1. Reads stripe-router → routes to mrr-arr-snapshot + past-due-dunning
2. Calls Stripe MCP → GetSubscriptions (paginated, all pages)
3. Normalizes annual plans to monthly MRR
4. Returns: MRR table + past due list + recommended actions
```
## Installation
### Cursor
| Method | Command |
| ------------- | ------------------------------------------------ |
| Project-level | `cp -r stripe-skills/skills/* .cursor/skills/` |
| Global | `cp -r stripe-skills/skills/* ~/.cursor/skills/` |
### Claude Code
```bash
npx skills add appeeky/stripe-skills
```
## Validate
```bash
./validate-skills.sh
```
## Related
- [aso-skills](https://github.com/eronred/aso-skills) — App Store optimization & growth skills
- [Stripe MCP docs](https://docs.stripe.com/mcp)
Powered by [Appeeky](https://appeeky.com)
## License
MIT
