Skip to content

Basinfy/Basinfy-SaaS-Studio / .agents/skills/saas-team-billing

saas-team-billing

Unverified

Orchestrate pricing, Stripe Checkout, idempotent webhooks, and Customer Portal delivery.

FileKindSize
SKILL.mdskill md3.0 KB
---
name: saas-team-billing
description: "Orchestrate pricing, Stripe Checkout, idempotent webhooks, and Customer Portal delivery."
argument-hint: "[billing feature description] [--review full|lean|solo]"
user-invocable: true
---

<!-- Generated from .claude/skills by scripts/sync-agent-skills.py. -->

## Running this workflow on this client

Run commands from the project root (use Git Bash on Windows if `bash` points to an unavailable WSL distro). Shared studio files live in `.claude/`; follow `.agents/PORTABLE-RUNTIME.md` and `.claude/docs/config-resolution.md` for client tools, delegation, and approval rules.

Run `bash .claude/hooks/yaml-helper.sh resolve_config --keys locale,review_mode,automation` and use its output below.

Resolved above — use as-is; `--review` overrides `review_mode` for this run.

# Team Billing & Subscriptions

> **Locale & User Profile**: Match `locale` (`pt-BR` → natural Brazilian Portuguese questions/options, overriding English examples; `en` → English) and `user_profile` (`founder` → plain business language with `(Recomendado)` first, zero tech jargon; `developer` → technical). Keep code/tests in English.


Orchestrate the billing engineering team to implement pricing tiers, Stripe Checkout,
webhook listeners, usage-based metering, and self-serve customer billing portals.

**Argument check:** If no description is provided, output:
> "Usage: `/saas-team-billing [billing feature description] [--review full|lean|solo]` — Describe the billing feature to build (e.g. Monthly/Annual subscription toggle, Stripe Checkout integration, Webhook synchronization, Customer Portal redirect, Usage limit gates)."

When this skill is invoked with a valid argument, orchestrate the team:

1. **Pricing Model & Tier Spec**:
   - `pricing-economist`: Define plan tiers (Starter, Pro, Enterprise), feature entitlement gates, and seat/usage thresholds
   - `backend-engineer`: Database migration for `Subscription`, `Plan`, `Customer`, and `Invoice` records

2. **Stripe Integration & Webhooks**:
   - `backend-engineer`:
     - Create Stripe Checkout sessions (`/api/billing/checkout`)
     - Implement Customer Portal session creation (`/api/billing/portal`)
     - Build idempotent webhook handler with raw signature verification (`customer.subscription.created`, `customer.subscription.updated`, `customer.subscription.deleted`, `invoice.payment_succeeded`, `invoice.payment_failed`)

3. **Frontend Billing UI**:
   - `frontend-engineer`:
     - Responsive pricing table with Monthly / Annual toggle and savings badge
     - Current plan status badge in settings, payment method display, invoice history table
     - Upgrade prompt modals when users hit plan limits

4. **Testing with Stripe Mock Webhooks**:
   - `qa-manual-tester`: Verify successful checkout redirects, subscription state updates via Stripe CLI (`stripe trigger invoice.payment_succeeded`), expired card handling, and downgrade access revocation.

5. **Verdict**:
   - Output: **COMPLETE** — billing pipeline designed, implemented, and verified with Stripe tests.
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall