Skill d'agent pour travailler avec les flows
Le skill flow-generator permet à votre outil IA de créer et modifier vos flows. Décrivez ce que vous voulez construire ou changer, en langage naturel, et l’outil lit la configuration du builder du flow via l’Adapty CLI ou le serveur Adapty MCP, la réécrit, affiche un aperçu et enregistre un brouillon une fois que vous l’approuvez.
Un skill est un ensemble d’instructions que votre outil IA charge à la demande. Celle-ci couvre les aspects de la configuration de flow qui sont faciles à rater : quelles modifications bloquent une publication, quelles références se cassent quand vous supprimez un écran, et ce qu’un aperçu rendu peut ou ne peut pas prouver.
Le skill flow-generator est expérimentale et enregistre les modifications directement dans les flows de votre tableau de bord. Exécutez-la d’abord sur un brouillon ou une copie, et vérifiez chaque modification dans le Flow & Paywall Builder avant de publier.
Avant de commencer
- Un outil IA avec le plugin Adapty : un agent de code tel que Claude Code, Codex, Copilot CLI ou Gemini CLI, ou claude.ai. Le skill préfère l’Adapty CLI. Avec le serveur MCP uniquement, il propose de configurer le CLI ; si vous refusez, il continue via MCP et indique chaque étape de vérification locale qui n’a pas été exécutée.
- Des produits dans votre catalogue Adapty : avant de concevoir un écran de vente, le skill liste vos produits et vous demande lesquels doivent y figurer. Si aucun ne convient, il peut en créer un à partir des identifiants de produits store que vous fournissez, et vous en informe au préalable.
Ce que vous pouvez faire avec
Créer un flow de zéro
- À partir d’une description : « Une paywall pour mon application fitness, deux plans, annuel présélectionné. » Le skill choisit la composition, la construit à partir de patterns vérifiés — onglets, cartes de plan, bascules, comptes à rebours, barres de progression, bottom sheets — et utilise les produits que vous avez choisis dans votre catalogue.
- À partir d’une capture d’écran ou d’un design : Donnez-lui une référence et elle reproduit la mise en page, les couleurs, la typographie et le style des icônes, puis vous indique chaque différence qu’elle n’a pas pu combler. La référence peut être la paywall d’un concurrent, l’un de vos propres écrans, ou un frame de votre outil de design. Si votre outil IA est connecté à cet outil de design via MCP, il lit le frame directement — personne n’a besoin d’exporter une capture d’écran ni de redécrire le design en mots.
- Évalué selon ce qui convertit : Quand vous n’avez pas fourni de design, le skill passe la bibliothèque
paywall-teardownd’Adapty sur l’écran qu’elle a construit et corrige ce qui est classé le plus haut, avant même que vous ne le voyiez. Vous obtenez un écran construit sur les patterns qui vendent dans votre catégorie, pas une mise en page générique.
Modifier un flow existant
- Localiser dans de nouveaux marchés : Ajoute une langue et remplit chaque champ localisable — titres, libellés de boutons, descriptions de plans, emplacements d’images et espaces réservés de saisie. C’est le moyen le plus rapide d’adapter un paywall qui fonctionne en dix langues.
- Réécrire les textes dans toutes les langues en même temps : Modifie les formulations sans toucher à la structure, et édite autour des variables de prix plutôt qu’à travers elles, pour que les prix continuent de se résoudre correctement.
- Restructurer le flow : Ajoute, supprime et réorganise des écrans, puis répare la navigation cassée par le changement et signale tout écran devenu inaccessible.
- Ajouter des quiz et des branchements : Construit des groupes sélectionnables, des identifiants d’options et les actions conditionnelles qui dirigent chaque réponse vers son propre écran — l’étape de personnalisation qui transforme un onboarding en une visite de paywall qualifiée.
- Créer des variantes pour un test : Duplique la version live d’un flow qui fonctionne vers un nouveau flow, puis applique le changement que vous souhaitez tester. Les écrans, le thème, les polices, les langues, les produits et les Remote Configs sont conservés, de sorte que la variante ne diffère que là où vous l’aviez prévu.
- Reskinner pour une saison ou une campagne : Échantillonne les couleurs d’une image de référence et applique un nouveau thème dans tout le flow, plutôt que de restyliser chaque écran à la main.
- Revenir à une version antérieure : Trouve une version antérieure dans l’historique des versions du flow, et la restaure comme brouillon ou la copie dans un nouveau flow. Le skill continue ensuite ses modifications à partir de cette version.
Ce que ça produit
Un paywall avec une chronologie de plans
Une chronologie numérotée au-dessus de deux cartes de plan. Affichée sur un appareil, le store a résolu les prix — y compris le prix mensuel qu’Adapty calcule pour le plan annuel.
Un paywall en une phrase
La consigne était « ajouter un écran paywall » — sans référence, sans flow source. Le $0.00 est un espace réservé pour la prévisualisation, et le badge affiche Best value parce qu’aucune remise n’a été fournie.
Un flow à trois écrans
Quiz, plan, offre, avec la navigation câblée entre eux. Le compte à rebours s’affiche, mais seul un appareil réel peut confirmer qu’il se déclenche.
Installer le skill
Le skill fait partie du plugin Adapty.
Si vous avez déjà installé le plugin Adapty, vous disposez de ce skill. Si votre agent ne le répertorie pas, mettez à jour le plugin avec la commande correspondant à votre agent dans le README du plugin.
Pour installer le plugin dans un agent de codage, exécutez dans votre terminal :
npx adapty skills install
Redémarrez votre agent pour charger le plugin. Pour installer le plugin dans claude.ai ou Claude desktop, consultez Installer le plugin. Pour les autres méthodes d’installation, consultez le README du plugin.
Claude Code ne met pas à jour le plugin automatiquement. Pour obtenir les nouveaux skills dès leur publication, dans Claude Code, exécutez /plugin, ouvrez Marketplaces, sélectionnez adapty et choisissez Enable auto-update. Pour la commande de mise à jour dans d’autres agents, consultez le README du plugin.
Décrivez ensuite ce que vous voulez en langage courant. La plupart des demandes correspondent à l’un de ces cas :
- Décrivez le flow : Ce que fait l’application, ce que l’écran doit vendre, quel plan présélectionner.
- Pointez-le vers un design : Une capture d’écran, l’un de vos propres écrans, ou un cadre dans votre outil de design.
- Demandez une modification précise : Nommez le flow et le changement — une nouvelle locale, un texte différent, un écran supplémentaire, une branche sur une réponse de quiz.
- Répondez à ses questions : Il demande quels produits mettre sur un écran, et tout nombre réel qu’il refuse d’inventer.
Fonctionnement
Tout ce que le skill construit converge vers un fichier local. Rien n’atteint votre tableau de bord avant la dernière étape.
-
Configuration et authentification. Le skill installe ou met à jour l’Adapty CLI si nécessaire, puis vérifie votre connexion Adapty et lit votre ID d’application. Si vous n’êtes pas connecté, elle ouvre le navigateur pour la connexion et attend que vous ayez terminé.
-
Choisir ou créer le flow. Pour une modification, il récupère la configuration du flow et indique ce qu’il a trouvé — écrans, langues, produits et graphe de navigation — afin qu’un mauvais flow soit détecté avant tout changement. Avant de modifier, le skill conserve une copie de la configuration récupérée en guise de sauvegarde. L’historique des versions conserve toutes les versions publiées, mais pas les états antérieurs d’un brouillon ; pour un brouillon jamais publié, cette copie est le seul moyen de revenir en arrière. Pour les nouvelles créations, il crée un flow vierge plutôt que de générer par-dessus un flow qui a déjà du contenu.
-
Validez la config. La commande effectue deux validations en local et une via Adapty. Les validations locales vérifient que les références internes sont cohérentes et que les propriétés sont bien formées.
adapty flows config validateexécute ensuite le même service que celui qui contrôle la publication — un résultat positif signifie que la config est prête à être publiée. Aucune des trois étapes ne sauvegarde quoi que ce soit. -
Prévisualiser et itérer. Le skill génère une capture d’écran de chaque écran modifié et l’examine. Si vous avez fourni une image de référence, elle compare le rendu avec le fichier élément par élément — couleur, police, style d’icône, proportions — et corrige les écarts à sa portée. Tout ce qui semble incorrect renvoie le skill à l’étape 3, ce qui coûte une capture d’écran plutôt qu’une sauvegarde.
-
Approuver et enregistrer. Écraser une configuration existante nécessite votre confirmation explicite. Le skill affiche un avant-après rendu pour chaque écran modifié, liste les changements sans aperçu visuel, ouvre un écran en direct dans votre navigateur et indique le nom du fichier de sauvegarde. Ce n’est qu’ensuite qu’il écrit.
Après l’exécution
Le skill vous laisse un brouillon enregistré. Pour le mettre devant les utilisateurs :
- Ouvrez le flow dans le Flow & Paywall Builder. Si vous aviez déjà le flow ouvert dans un onglet, rechargez la page — le Flow & Paywall Builder ne prend pas en compte les modifications effectuées via la CLI.
- Vérifiez ce qui a changé. Adapty marque un flow qui était Published avant la sauvegarde comme Dirty, et toute votre équipe voit ce statut. Vos utilisateurs continuent de voir la dernière version publiée.
- Prévisualisez sur un vrai appareil. Prévisualiser les flows explique le parcours par QR code via l’application mobile Adapty. Testez tout ce que le skill a signalé comme non vérifié — branchements, bascules, et toute langue autre que celle rendue.
- Publiez. Cliquez sur Publish to Live en haut à droite du Flow & Paywall Builder, ou exécutez
adapty flows publishdepuis le terminal. Un flow qui n’est pas dans un placement ne touche personne, et un flow en Draft ne peut pas y être ajouté — publiez donc d’abord. Consultez Sauvegarder et publier des flows.
Si le résultat est incorrect, demandez au skill de l’annuler. Le skill liste les versions du flow, restaure la version que vous choisissez en tant que brouillon, et vous montre le résultat. Une restauration remplace le brouillon actuel — avant de le remplacer, le skill vous le demande et vous propose de dupliquer le brouillon dans un nouveau flow. Pour un brouillon qui n’a jamais été publié, l’historique ne contient pas d’état antérieur : demandez alors au skill de réécrire sa copie de sauvegarde. Vous pouvez aussi corriger le flow manuellement dans le Flow & Paywall Builder. Dans tous les cas, un brouillon sauvegardé ne change rien pour vos utilisateurs.
L’historique des versions permet aussi d’annuler une publication incorrecte. Demandez au skill de revenir à la version qui était en ligne avant : il restaure cette version en tant que brouillon, et vous publiez le brouillon quand vous êtes prêt.
Exemples de prompts
Le skill embarque les commandes, le format de configuration et ses propres étapes de vérification, donc un prompt n’a pas besoin de tout détailler. Indiquez quel flow, et ce qui doit être vrai une fois terminé.
Traduire un paywall
Add Brazilian Portuguese to my "Summer 2026" paywall. Translate every
localizable field, not just the headline, and tell me what you couldn't.
Construire depuis un design
Build a new paywall flow from the "Winter promo" frame in our Figma file.
Show me my products first and let me pick which ones go on it.
Ajouter un quiz avec des branches
Add a quiz screen before my paywall: "What's your main goal?" with three
options, each routing to its own benefit screen, then on to the paywall.
Réécrire le texte
Rewrite the headline and CTA on my onboarding to be shorter and more direct.
Keep the price variables working, and apply it to every locale.
Créer une variante de test
Copy my "Main paywall" into a new flow and make the monthly plan the
preselected one. Leave the original alone.
Re-skinner pour une campagne
Re-theme my paywall flow to match the colors in ./design/spring.png.
Copy and layout stay as they are.
Add a screen
Add a social proof screen between the quiz and the paywall in my activation
flow — star rating and two testimonials. Ask me for the real numbers.
Transmettez vos images et vidéos
Le skill téléverse une image ou une vidéo depuis votre ordinateur et intègre l’URL renvoyée dans le flow, pour vous éviter d’ajouter des médias à la main dans le Flow & Paywall Builder. Il lui faut un chemin de fichier, pas une image : quand vous collez ou joignez une image dans le chat, votre outil d’IA reçoit les pixels mais pas le fichier, donc il n’y a rien à téléverser.
Placez les ressources dans un dossier sur votre ordinateur, puis indiquez-le à l’outil :
The hero images are in ./design/paywall/. Use hero-calm.png on the first
screen and the three icons in ./design/paywall/icons/ for the benefit rows.
Les formats et limites de taille correspondent à un téléchargement manuel dans le Flow & Paywall Builder — voir Images, vidéos et icônes. Le SVG est la seule exception : il ne peut pas être téléchargé, donc le skill dessine les glyphes monochomes en ligne à la place.
Le skill télécharge une vidéo avec adapty flows media upload-video. La vidéo doit être un fichier MP4 ou WebM, d’une durée maximale de 30 secondes et d’une taille maximale de 50 Mo, avec une largeur et une hauteur d’au moins 640 pixels chacune. Les GIF ne sont pas pris en charge, et le skill ne convertit pas une image animée en vidéo. Lorsque le skill s’exécute uniquement via le serveur MCP, il ne peut pas encore télécharger de vidéo : il place un élément vidéo avec un espace réservé vide, et vous téléchargez la vidéo dans le Flow & Paywall Builder.
Chaque upload ajoute un asset distinct à votre médiathèque, et aucune commande CLI ne permet d’en supprimer un, donc relancer un build laisse des copies derrière.
Si vous nommez un fichier que l’outil ne trouve pas, il demande plutôt que d’en substituer un qui ressemble. Un mauvais fichier produit un écran qui s’affiche correctement mais avec la mauvaise image, ce que rien dans le workflow ne détecte.
Apportez votre propre agent
Adapty dispose également d’un AI Editor intégré au Flow & Paywall Builder. La différence ne réside pas dans le nombre de fonctionnalités de l’un ou de l’autre — c’est plutôt une question d’environnement de travail.
L’AI Editor est l’agent d’Adapty, qui opère sur l’écran que vous avez ouvert. Le skill MCP, c’est l’inverse : votre agent, votre modèle, vos outils, et Adapty comme un outil parmi d’autres qu’il sait utiliser. Tout ce que votre outil IA peut déjà atteindre vient avec lui — votre repo, vos fichiers de design, vos serveurs MCP, vos propres prompts et contexte.
| Éditeur IA | skill flow-generator | |
|---|---|---|
| Quel agent | Celui d’Adapty, dans le navigateur | Le vôtre : un agent de codage ou claude.ai |
| Ce qu’il voit | L’écran ouvert, plus les images que vous joignez | Tout ce que votre outil IA peut atteindre |
| Portée d’un prompt | Un seul écran | Le flow entier — écrans, navigation, locales |
| Localisation | Non couverte | Ajoute une locale et remplit tous les champs localisables |
| Annulation | Un clic par prompt | Une copie de sauvegarde du flow, l’historique des versions, et votre validation avant chaque enregistrement |
| Configuration | Aucune | Le plugin Adapty, plus le CLI Adapty ou le serveur MCP |
Utilisez l’éditeur IA lorsque vous êtes déjà dans le builder et souhaitez remettre en forme l’écran sous vos yeux. Utilisez le skill lorsque vous préférez ne pas quitter votre propre environnement pour travailler sur vos flows.
Ce que le skill ne fait pas
Le skill considère vos flows comme du contenu en production, car un flow publié est utilisé par de vrais utilisateurs.
- La publication reste entre vos mains : le skill s’arrête à un brouillon sauvegardé et ne publie jamais. Publiez vous-même dans le Flow & Paywall Builder, ou avec
adapty flows publish. - L’écrasement requiert votre accord : une sauvegarde remplace l’intégralité de la configuration, sans écriture partielle ni annulation possible pour un brouillon. La confirmation indique le nom du flow, son ID, son statut et le fichier de sauvegarde créé par le skill avant la modification.
- Une restauration reste un brouillon : le skill restaure une version antérieure en tant que brouillon et ne la publie jamais. Avant de remplacer un brouillon, il vous demande confirmation.
- Les modifications non sauvegardées vous appartiennent : avant d’ouvrir ou de restaurer une autre version, le skill vous demande si vous souhaitez sauvegarder les modifications en attente, les ignorer ou rester sur la version actuelle.
- Une modification simultanée fait échouer l’écriture : chaque écriture après la première renvoie le timestamp
updated_atde la configuration à Adapty. Si un membre de l’équipe a sauvegardé le flow entre-temps, Adapty rejette l’écriture plutôt que d’écraser son travail. - La suppression d’un flow reste une action du tableau de bord : le CLI ne dispose pas de commande de suppression, donc un flow créé par le skill restera jusqu’à ce que vous le supprimiez depuis le tableau de bord.
- Les données réelles et les ressources viennent de vous : les notes, le nombre d’avis, les pourcentages de réduction et les prix en store ne sont jamais inventés. Lorsqu’un modèle en requiert un que vous n’avez pas fourni, le skill vous le demande ou omet l’élément concerné, et vous indique ce qu’il a fait.
Les lectures, validations et prévisualisations ne coûtent rien et ne modifient rien. Enregistrer une configuration est la seule action qui atteint votre tableau de bord, et elle nécessite votre approbation.
Limitations
Les runs prennent du temps
Le skill valide et restitue après chaque modification, ce qui permet d’éviter qu’une configuration cassée n’atterrisse sur votre tableau de bord — et cela rend un run plus lent qu’une réponse en chat. Une petite modification se termine en quelques minutes. La création d’un flow multi-écrans avec des branchements prend 10 à 40 minutes. Lancez-le et revenez plutôt que de rester à le regarder tourner.
Les polices personnalisées restent manuelles
Le skill ne télécharge pas les fichiers de police personnalisée. Il crée les styles de texte requis par votre design et les associe à une police de substitution. Téléchargez la police dans le Flow & Paywall Builder et assignez-la à ces styles.
La prévisualisation affiche un seul écran, dans un seul état
La page de prévisualisation du skill affiche un seul écran et ne parcourt pas le flow. Elle ne peut pas vous montrer les éléments suivants. Testez chacun sur un vrai appareil — Prévisualiser les flows vous explique comment :
- Navigation et embranchement : un bouton portant une action de navigation reste à sa place dans l’aperçu, donc une route conditionnelle ne peut pas se déclencher. Chaque écran est un rendu séparé.
- Sélection par bascule et choix multiple : une ligne à bascule et une ligne à choix multiple s’affichent dans leur état désactivé, quel que soit leur état par défaut. Les lignes à choix unique et les cartes produit affichent bien leur état sélectionné.
- Toute locale autre que celle utilisée pour le rendu : l’aperçu ignore la locale par défaut du flow et l’ordre de la liste des locales — il est donc impossible de vérifier visuellement une traduction. Changez de locale dans le Flow & Paywall Builder et repérez les textes qui débordent de leur conteneur.
- Tout ce qui se résout à l’exécution : prix réels, devise du store et saisie utilisateur. Une variable de prix s’affiche sous la forme de son jeton littéral, qui est plus long que n’importe quel prix et peut pousser du texte sous un bouton ancré — un chevauchement qui disparaît dès que le prix est résolu.
- Les tailles d’écran que la page ne connaît pas : une mise en page dont la fiabilité dépend de la hauteur de la fenêtre nécessite un téléphone de petite taille pour être validée.
Et ensuite
- skill flow-audit — vérification en lecture seule pour savoir si le brouillon laissé par ce skill est prêt pour la production, avant de le publier.
- Enregistrer et publier des flows — finaliser le brouillon laissé par le skill.
- Problèmes courants — ce qui empêche un flow d’être publié.
- Ajouter une langue dans Adapty Flow & Paywall Builder — utiliser l’interface du builder pour simplifier le processus de traduction.
- Gérer Adapty avec des agents IA et des outils de développement — les autres skills Adapty et les outils IA.