Basinfy/Basinfy-SaaS-Studio / .agents/skills/saas-team-billing
saas-team-billing
UnverifiedOrchestrate pricing, Stripe Checkout, idempotent webhooks, and Customer Portal delivery.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.0 KB |
SKILL.md
View on GitHub---
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.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |