Stripe Apps — Skill Cursor
Ce skill fait partie du repository officiel stripe/ai, le hub central de Stripe pour les intégrations IA et agent. Il est distribué via le plugin Cursor officiel de Stripe (/add-plugin stripe) et s'installe automatiquement dans l'environnement de l'agent.
Rôle du skill
Ce skill transforme l'agent en un constructeur de projet guidé spécialisé dans les Stripe Apps. Il couvre l'intégralité du cycle de développement : scaffold via stripe generate app, configuration du manifest stripe-app.yaml, développement des UI extensions dans le sandbox iframe de Stripe, mise en place du backend (server.js), gestion de l'authentification (platform keys, OAuth, restricted API keys), configuration des webhooks, utilisation du Secret Store API, et publication sur le marketplace Stripe.
Le skill suit un protocole en plusieurs étapes : d'abord une phase de découverte (4 questions obligatoires à poser à l'utilisateur), puis le scaffold, la construction des fichiers sur disque via l'outil Write, et enfin la livraison avec le workflow de développement complet. Il inclut également des fichiers de référence internes (references/discovery.md, references/canonical-docs.md, etc.) que l'agent doit lire avant d'agir.
Ce que l'agent fait concrètement
Avant d'écrire le moindre code, l'agent est instruit de consulter la documentation officielle Stripe via WebFetch pour s'assurer que les patterns SDK utilisés sont à jour. Il crée ensuite les fichiers réels sur la machine de l'utilisateur (et non uniquement dans le chat), vérifie leur présence sur disque, et présente un workflow de développement clair incluant pnpm build, pnpm test, stripe apps start et stripe apps upload.
Le skill embarque également des règles strictes (tableau HARD RULES et BLOCKED) pour éviter les erreurs courantes : usage de raw HTML dans les UI extensions, import de frameworks CSS incompatibles, ou recours à des APIs React 18+ non supportées par l'environnement sandboxé de Stripe Apps.
Contexte d'utilisation
Ce skill est déclenché dès que l'utilisateur mentionne des Stripe Apps, des UI extensions, @stripe/ui-extension-sdk, stripe-app.yaml, ou toute intention de personnaliser le Dashboard Stripe. Il constitue un point d'entrée complet et autonome pour démarrer un projet Stripe App depuis zéro ou modifier une app existante.