paywall-upgrade-cro

Aperçu

Ce que fait cette skill

La skill paywall-upgrade-cro transforme votre agent en spécialiste des paywalls in-app et des parcours de mise à niveau. Elle se concentre sur les moments à l’intérieur de votre produit où vous demandez à l’utilisateur de passer à une offre supérieure, de payer ou de changer de plan—après qu’il ait déjà perçu de la valeur.

Utilisez paywall-upgrade-cro lorsque vous voulez créer ou améliorer :

• Des paywalls et écrans de mise à niveau in-app
• Des upsell modals et feature gates
• Des écrans de fin d’essai ou de limite atteinte
• Des prompts de mise à niveau de plan et des présentations tarifaires in-app

Elle se distingue de l’optimisation des pages de pricing publiques : pour les pages de pricing sur votre site marketing, utilisez page-cro ; pour les questions de stratégie tarifaire, utilisez pricing-strategy.

Pour qui est-elle faite ?

Cette skill est particulièrement adaptée :

• Aux équipes produit et SaaS qui proposent des offres freemium ou des essais
• Aux product managers et équipes growth responsables de la conversion in-product
• Aux UX et UI designers qui conçoivent les parcours d’upgrade, modals et gates
• Aux équipes marketing en charge des messages in-app et de la copy des paywalls
• Aux développeurs Shopify ou frontend qui implémentent les prompts de mise à niveau

Si votre principal problème est « les utilisateurs gratuits ne passent pas à l’offre payante », « les utilisateurs en essai ne convertissent pas » ou « notre écran d’upgrade ne fonctionne pas », paywall-upgrade-cro est conçue pour y répondre.

Problèmes que cette skill résout

Avec la structure définie dans SKILL.md et les idées d’expérimentation dans references/experiments.md, la skill aide l’agent à :

• Diagnostiquer pourquoi votre paywall actuel ou votre écran de mise à niveau sous-performe
• Aligner le timing du paywall avec le moment aha de l’utilisateur, la limite atteinte ou le statut d’essai
• Concevoir des écrans qui mettent l’accent sur la valeur plutôt que la friction, et pas seulement sur le message « vous avez atteint une limite »
• Structurer les parcours d’upgrade avec des titres clairs, des démonstrations de valeur, des comparaisons de plans, de la preuve sociale et des CTA forts
• Éviter les dark patterns et anti-patterns qui nuisent à la confiance et à la rétention long terme
• Générer des idées de tests A/B pour la copy, le layout, l’affichage des prix et la logique de déclenchement

Quand cette skill est (ou n’est pas) la bonne solution

Utilisez paywall-upgrade-cro lorsque :

• Vous travaillez sur un paywall ou un moment de mise à niveau à l’intérieur d’un produit ou d’une app
• Vous devez améliorer la conversion essai → payant, freemium → payant ou les upgrades de plan
• Vous voulez des recommandations structurées (pas seulement quelques suggestions de texte)
• Vous planifiez des expérimentations CRO sur vos écrans in-app

Ce n’est peut-être pas le meilleur choix lorsque :

• Vous voulez uniquement refondre une page marketing ou de pricing publique (utilisez page-cro)
• Vous définissez les niveaux de prix ou la stratégie de packaging globale (utilisez pricing-strategy)
• Vous avez besoin d’aide sur la logique de facturation backend ou l’implémentation d’un payment gateway (cette skill se concentre sur l’UX, la copy et la conversion, pas sur les intégrations de billing)

Guide d’utilisation

Installation

Pour ajouter la skill paywall-upgrade-cro à la configuration de votre agent, installez-la depuis le repository marketingskills :

npx skills add https://github.com/coreyhaines31/marketingskills --skill paywall-upgrade-cro

Après l’installation, localisez le répertoire de la skill :

• Repository : coreyhaines31/marketingskills
• Chemin de la skill : skills/paywall-upgrade-cro/
• Fichiers clés :
  • SKILL.md
  • evals/evals.json
  • references/experiments.md

Workflow principal

SKILL.md définit la façon dont l’agent doit réfléchir et travailler lorsqu’il utilise paywall-upgrade-cro. Le workflow type est :

1. Charger d’abord le contexte produit
   Si votre repo contient .agents/product-marketing-context.md (ou .claude/product-marketing-context.md dans les configurations plus anciennes), l’agent est invité à lire ce fichier avant de poser des questions. Cela garantit que les recommandations sont alignées avec :

   • Votre modèle économique (freemium, essai, paliers payants)
   • Vos propositions de valeur clés
   • Vos segments cibles et cas d’usage

2. Clarifier le scénario d’upgrade
   La skill pousse l’agent à comprendre :

   • Le contexte d’upgrade : freemium → payant, essai → payant, upgrade de plan ou upsell de fonctionnalité
   • Le modèle produit : ce qui est gratuit, ce qui est derrière le paywall et ce qui déclenche le prompt
   • Le parcours utilisateur : où se trouve l’utilisateur, ce qu’il essayait de faire et dans quel état émotionnel il est susceptible d’être (par exemple, frustration après avoir atteint une limite)

3. Appliquer un framework structuré de paywall
   En s’appuyant sur les directives encodées dans SKILL.md et les exemples de evals/evals.json, l’agent structure les paywalls et écrans d’upgrade avec des composants tels que :

   • Un headline qui communique la valeur de l’upgrade—pas seulement le fait que l’accès est bloqué
   • Une value demonstration claire : ce que l’utilisateur débloque (fonctionnalités, résultats, gain de temps)
   • Une plan comparison entre offre gratuite et payante lorsque c’est pertinent
   • De la social proof (témoignages, stats d’usage, logos) pour réduire la perception de risque
   • Un CTA clair, spécifique et orienté action
   • Un escape hatch pour permettre à l’utilisateur de reprendre ce qu’il faisait sans se sentir piégé

4. Générer des recommandations ciblées de copy et de layout
   En fonction du déclencheur spécifique (limite d’usage, fin d’essai, feature gate, etc.), l’agent propose des options de copy détaillées, des idées de layout et des patterns UX. Les évaluations dans evals/evals.json montrent comment il doit :

   • Adapter la copy à l’état émotionnel de l’utilisateur (par ex. frustration à l’atteinte d’une limite de projet)
   • Mettre en garde contre les anti-patterns (par ex. blocages surprises sans contexte, options de plan confuses)
   • Suggérer des exemples concrets de headlines, textes de corps et CTA plutôt que des conseils génériques

5. Planifier les expérimentations et itérations
   Le fichier references/experiments.md liste de nombreuses idées de tests A/B autour :

   • Des triggers & timing (moment aha vs. limite atteinte, prompts basés sur le temps vs. l’usage)
   • Du paywall design (plein écran vs. modal, layouts minimalistes vs. riches en fonctionnalités)
   • De la pricing presentation (offre unique vs. comparaison, remises, cadrage)
   • De la copy & messaging (headlines, CTA, traitement des objections)
   • Des trial & conversion flows (rappels, écrans de fin d’essai, parcours d’upgrade)
   • De la personalization et du frequency capping

   L’agent peut s’en servir pour construire une roadmap de tests priorisée plutôt que des changements ponctuels.

Exemples de cas d’usage

1. Paywall de limite d’usage dans un outil SaaS

Vous gérez une app de gestion de projet où les utilisateurs gratuits peuvent créer 3 projets. Lorsqu’ils essaient d’en créer un 4e, vous voulez un paywall perçu comme juste et convaincant, pas punitif.

Avec paywall-upgrade-cro, l’agent va :

• Identifier ce cas comme un usage limit trigger
• Recommander un écran qui :
  • Met en avant ce que l’utilisateur a déjà accompli
  • Explique clairement ce que l’upgrade débloque (par ex. projets illimités, support prioritaire)
  • Affiche une comparaison simple entre offre gratuite et payante
  • Inclut de la preuve sociale et un CTA direct « Upgrade to continue »
  • Propose un escape hatch (par ex. « Cancel and keep your 3 projects ») pour éviter une impasse

2. Écran d’upgrade à la fin d’un essai

Votre essai de 14 jours se termine et les utilisateurs voient un message générique « Your trial has expired », avec un faible taux de mise à niveau.

Avec paywall-upgrade-cro, l’agent va :

• Identifier ce cas comme un trial expiration trigger
• Recommander de mettre l’accent sur :
  • La valeur déjà expérimentée par l’utilisateur pendant l’essai
  • Ce qu’il va perdre ou continuer à utiliser s’il passe à l’offre payante maintenant
  • Des détails clairs de plan et de pricing
  • Des incentives éventuels (remises limitées dans le temps, prolongation d’essai, si pertinent)
• Suggérer des écrans alternatifs pour les rappels avant la fin de l’essai et les parcours post-expiration

3. Feature gate pour une fonctionnalité premium

Vous souhaitez verrouiller une fonctionnalité premium (par ex. advanced reporting) derrière un prompt d’upgrade.

La skill aide l’agent à :

• Décider s’il faut utiliser un hard gate (blocage complet) ou un soft gate (aperçu avec prompt)
• Structurer un message qui présente la fonctionnalité comme la solution à un problème précis
• Suggérer des visuels ou aperçus qui montrent ce que l’utilisateur manque
• S’assurer que le gate apparaît après que l’utilisateur ait déjà vu suffisamment de valeur pour envisager de payer

FAQ

À quoi sert précisément paywall-upgrade-cro ?

paywall-upgrade-cro est conçue pour aider les agents à concevoir et optimiser les paywalls in-product, écrans de mise à niveau, upsell modals et feature gates. Elle met l’accent sur l’optimisation du taux de conversion pour des utilisateurs qui ont déjà interagi avec votre produit, plutôt que sur le trafic de votre site marketing.

Comment installer paywall-upgrade-cro ?

Installez la skill dans votre environnement compatible skills avec :

npx skills add https://github.com/coreyhaines31/marketingskills --skill paywall-upgrade-cro

Puis explorez le répertoire de la skill skills/paywall-upgrade-cro/, en vous concentrant sur SKILL.md, evals/evals.json et references/experiments.md.

Quels fichiers dois-je consulter en premier ?

Commencez par :

• SKILL.md – définit le rôle, le périmètre et le raisonnement pas-à-pas pour l’optimisation des paywalls et écrans d’upgrade.
• evals/evals.json – présente des exemples de prompts et des outputs attendus détaillés, utiles pour comprendre comment la skill doit se comporter dans des scénarios réels.
• references/experiments.md – une liste structurée d’idées de tests A/B et de catégories d’expérimentations pour un travail CRO continu.

Ces trois fichiers donnent un bon modèle mental de la façon dont paywall-upgrade-cro aborde les problèmes de conversion in-app.

Cette skill aide-t-elle à définir la stratégie de pricing ?

paywall-upgrade-cro se concentre sur la présentation et la conversion de vos plans existants à l’intérieur du produit : quand afficher des paywalls, quoi dire et comment les concevoir. Si vous devez définir vos niveaux de prix, votre packaging ou votre stratégie de remise, associez-la à pricing-strategy, plus adaptée aux décisions de pricing de fond.

Est-ce uniquement pour le SaaS ou puis-je l’utiliser avec Shopify et d’autres plateformes ?

La skill est conçue de façon agnostique par rapport à la plateforme et peut être utilisée pour :

• Des web apps SaaS
• Des apps mobiles
• Des thèmes Shopify et prompts d’upgrade sur vos storefronts
• Tout environnement frontend où vous contrôlez les écrans et modals in-app

Elle se concentre sur l’UX, l’UI, la copy et les idées d’expérimentation. Vous pouvez implémenter les patterns recommandés dans le framework frontend ou la plateforme e-commerce de votre choix.

Comment paywall-upgrade-cro gère-t-elle les anti-patterns et la confiance utilisateur ?

Les évaluations dans evals/evals.json indiquent explicitement à l’agent de :

• Tenir compte de l’état émotionnel de l’utilisateur (par ex. frustration après une limite atteinte)
• Mettre en garde contre les pratiques trompeuses (blocages surprises, pricing confus, données qui disparaissent)
• Intégrer des escape hatches et une communication claire

Cela rend vos parcours d’upgrade persuasifs mais respectueux, soutenant la rétention long terme et la confiance dans la marque.

Puis-je adapter les recommandations à ma marque et à mes segments ?

Oui. La skill s’attend à ce que l’agent :

• Consulte .agents/product-marketing-context.md (ou .claude/product-marketing-context.md dans les anciennes configurations) lorsqu’il est disponible
• Utilise votre positionnement actuel, vos définitions d’ICP et vos récits fonctionnels

Vous pouvez affiner encore davantage les outputs en fournissant des guidelines de marque, des notes de ton de voix ou des descriptions de segments supplémentaires dans votre prompt ou vos fichiers de contexte.

Comment tirer le maximum de valeur de cette skill dans la durée ?

Pour maximiser la valeur de paywall-upgrade-cro :

• Utilisez-la à chaque fois que vous concevez ou mettez à jour des moments d’upgrade in-app
• Combinez ses recommandations avec vos analytics et résultats d’expérimentation
• Piochez régulièrement de nouvelles idées de tests dans references/experiments.md au fur et à mesure que vous voyez ce qui fonctionne
• Documentez les paywalls et écrans gagnants afin que l’agent puisse s’en inspirer comme patterns éprouvés

De cette façon, la skill devient un playbook vivant pour la conversion in-app, et pas seulement un outil ponctuel.