skills/stripe-best-practices/SKILL.md
Guides Stripe integration decisions — API selection (Checkout Sessions vs PaymentIntents), Connect platform setup (Accounts v2, controller properties), billing/subscriptions, Treasury financial accounts, integration surfaces (Checkout, Payment Element), webhook handling, and migrating from deprecated Stripe APIs. Use when building, modifying, or reviewing any Stripe integration — including accepting payments, building marketplaces, integrating Stripe, processing payments, setting up subscriptions, handling webhooks, or creating connected accounts. Do NOT use for general payment processing concepts unrelated to Stripe, non-Stripe payment providers (PayPal, Square, Braintree), Stripe CLI setup and configuration, or Stripe Dashboard navigation.
npx skillsauth add sharkitect-solutions/sharkitect-claude-toolkit stripe-best-practicesInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
| File | Load When | Do NOT Load | |------|-----------|-------------| | SKILL.md | Always (routing hub) | -- | | references/payments.md | Accepting payments, checkout, payment elements, PCI | Billing subscriptions, Connect marketplaces | | references/billing.md | Subscriptions, recurring payments, usage billing | One-time payments, Connect | | references/connect.md | Marketplaces, platforms, multi-party payments, connected accounts | Simple payments, billing | | references/treasury.md | Banking-as-a-service, financial accounts, money movement | Payments, billing, Connect | | references/webhooks.md | Event handling, webhook verification, idempotency | Initial integration setup |
| Domain | In/Out | Use Instead | |--------|--------|-------------| | Stripe API integration | IN | -- | | Stripe webhook handling | IN | -- | | Stripe billing and subscriptions | IN | -- | | Stripe Connect platforms | IN | -- | | Stripe Treasury financial accounts | IN | -- | | General payment concepts | OUT | smb-cfo | | Non-Stripe providers (PayPal, Square, Braintree) | OUT | -- | | Frontend UI components | OUT | frontend-design | | Database schema for payments | OUT | database | | Stripe CLI setup and configuration | OUT | -- | | Stripe Dashboard navigation | OUT | -- |
Latest Stripe API version: 2026-02-25.clover. Always use the latest API version and SDK unless the user specifies otherwise.
| Building... | Recommended API | Details |
|---|---|---|
| One-time payments | Checkout Sessions | references/payments.md |
| Custom payment form with embedded UI | Checkout Sessions + Payment Element | references/payments.md |
| Saving a payment method for later | Setup Intents | references/payments.md |
| Connect platform or marketplace | Accounts v2 (/v2/core/accounts) | references/connect.md |
| Subscriptions or recurring billing | Billing APIs + Checkout Sessions | references/billing.md |
| Embedded financial accounts / banking | v2 Financial Accounts | references/treasury.md |
Read the relevant reference file before answering any integration question or writing code.
When the user's request does not clearly fit a single domain above, consult:
development
When the user wants help with paid advertising campaigns on Google Ads, Meta (Facebook/Instagram), LinkedIn, Twitter/X, or other ad platforms. Also use when the user mentions 'PPC,' 'paid media,' 'ad copy,' 'ad creative,' 'ROAS,' 'CPA,' 'ad campaign,' 'retargeting,' or 'audience targeting.' This skill covers campaign strategy, ad creation, audience targeting, and optimization.
testing
--- name: using-sharkitect-methodology description: Use when starting any conversation in a Sharkitect workspace OR before any task involving NEW pricing, positioning, proposal, strategy, plan-execution, or schema-design work — mandates invocation of Sharkitect-specific methodology skills (pricing-strategy, marketing-strategy-pmm, smb-cfo, hq-revenue-ops, executing-plans, brainstorming) under the same anti-rationalization discipline as using-superpowers. Documentation has failed 4 times across H
testing
Use when user says 'end session', 'wrap up', 'stop for the day', 'done for today', 'close out', 'save session', 'wrapping up', or invokes /end-session. Runs the full 9-step end-of-session protocol: resource audit, MEMORY.md update, lessons capture, plan status, pending items, workspace checklist, .tmp/ audit, git commit+push, Supabase brain sync, session brief, summary. Final step schedules a detached self-kill of the current session ONLY (3s delay) so the window closes cleanly. Other claude.exe processes (active workspaces) are NOT touched -- orphan cleanup is handled separately by Claude-Orphan-Cleanup-Hourly with proper age safeguards. Do NOT use for: mid-session quick saves (use session-checkpoint), skill syncing (use sync-skills.py), brain memory queries (use supabase-sync.py pull), document freshness reviews (use document-lifecycle), resource gap detection (use resource-auditor).
testing
Remove signs of AI-generated writing from text. Use when editing or reviewing text to make it sound more natural and human-written. Based on Wikipedia's comprehensive "Signs of AI writing" guide. Detects and fixes patterns including: inflated symbolism, promotional language, superficial -ing analyses, vague attributions, em dash overuse, rule of three, AI vocabulary words, passive voice, negative parallelisms, and filler phrases.