paywall-upgrade-cro

Descripción general

Qué hace esta skill

La skill paywall-upgrade-cro convierte tu agente en un especialista en paywalls in-app y flujos de upgrade. Se centra en los momentos dentro de tu producto en los que pides a los usuarios que hagan upgrade, paguen o pasen a un plan superior, una vez que ya han experimentado valor.

Usa paywall-upgrade-cro cuando quieras crear o mejorar:

• Paywalls in-app y pantallas de upgrade
• Modales de upsell y feature gates
• Pantallas de fin de prueba o de límite alcanzado
• Mensajes de upgrade de plan y presentaciones de precios dentro del producto

Es distinta de la optimización de páginas públicas de precios: para páginas de precios en el sitio de marketing, usa page-cro; para cuestiones de estrategia de precios, usa pricing-strategy.

A quién va dirigida

Esta skill encaja bien con:

• Equipos de producto y SaaS que trabajen con modelos freemium o de prueba
• Product managers y equipos de growth responsables de la conversión dentro del producto
• Diseñadores UX y UI que trabajen en flujos de upgrade, modales y gates
• Equipos de marketing responsables de los mensajes in-app y del copy de paywalls
• Desarrolladores de Shopify o frontend que implementen mensajes de upgrade

Si tu principal reto es “los usuarios free no hacen upgrade”, “los usuarios de prueba no convierten” o “nuestra pantalla de upgrade no funciona”, paywall-upgrade-cro está diseñada para ese problema.

Problemas que resuelve

Con la estructura definida en SKILL.md y las ideas de experimentos en references/experiments.md, la skill ayuda al agente a:

• Diagnosticar por qué tu paywall o pantalla de upgrade actual rinde por debajo de lo esperado
• Alinear el momento del paywall con el aha moment del usuario, el límite alcanzado o el estado de la prueba
• Diseñar pantallas que destaquen el valor por encima de la fricción, no solo “has alcanzado un límite”
• Estructurar flujos de upgrade con titulares claros, demostraciones de valor, comparación de planes, prueba social y CTAs potentes
• Evitar dark patterns y anti-patterns que dañan la confianza y la retención a largo plazo
• Generar ideas de tests A/B para copy, layout, presentación de precios y lógica de disparo

Cuándo es y cuándo no es la mejor opción

Usa paywall-upgrade-cro cuando:

• Estás trabajando en un paywall o momento de upgrade dentro de un producto o app
• Necesitas mejorar la conversión de trial a pago, freemium a pago o upgrades de plan
• Quieres recomendaciones estructuradas (no solo ideas de copy sueltas)
• Estás planificando experimentos de CRO para pantallas in-app

Puede no ser la mejor opción cuando:

• Solo quieres rediseñar una página pública de marketing o de precios (usa page-cro)
• Estás definiendo niveles de precio generales o la estrategia de packaging (usa pricing-strategy)
• Necesitas ayuda profunda con lógica de billing backend o integración de pasarelas de pago (esta skill se centra en UX, copy y conversión, no en integraciones de cobro)

Cómo usarla

Instalación

Para añadir la skill paywall-upgrade-cro a la configuración de tu agente, instálala desde el repositorio marketingskills:

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

Después de la instalación, localiza el directorio de la skill:

• Repositorio: coreyhaines31/marketingskills
• Ruta de la skill: skills/paywall-upgrade-cro/
• Archivos clave:
  • SKILL.md
  • evals/evals.json
  • references/experiments.md

Flujo de trabajo principal

SKILL.md define cómo debe pensar y trabajar el agente al usar paywall-upgrade-cro. El flujo típico es:

1. Cargar primero el contexto de producto
   Si tu repo incluye .agents/product-marketing-context.md (o .claude/product-marketing-context.md en setups antiguos), se indica al agente que lea ese archivo antes de hacer preguntas. Así se asegura de que las recomendaciones se ajusten a tu:

   • Modelo de producto (freemium, trial, tiers de pago)
   • Propuestas de valor clave
   • Segmentos objetivo y casos de uso

2. Aclarar el escenario de upgrade
   La skill empuja al agente a entender:

   • Contexto de upgrade: freemium → pago, trial → pago, upgrade de plan o upsell de funcionalidades
   • Modelo de producto: qué es free, qué está detrás del paywall y qué dispara el mensaje
   • Customer journey: dónde está el usuario, qué intentaba hacer y en qué estado emocional es probable que se encuentre (por ejemplo, frustración al alcanzar un límite)

3. Aplicar un framework estructurado de paywall
   Siguiendo las indicaciones codificadas en SKILL.md y los ejemplos de evals/evals.json, el agente estructura los paywalls y pantallas de upgrade con componentes como:

   • Headline que comunique el valor del upgrade, no solo que el acceso está bloqueado
   • Demostración de valor: qué desbloquea el usuario (funcionalidades, resultados, ahorro de tiempo)
   • Comparación de planes entre free y pago cuando tenga sentido
   • Prueba social (testimonios, métricas de uso, logos) para reducir la percepción de riesgo
   • CTA claro, específico y orientado a la acción
   • Escape hatch para que los usuarios puedan volver a lo que estaban haciendo sin sentirse atrapados

4. Generar recomendaciones específicas de copy y layout
   Según el disparador concreto (límite de uso, final de prueba, feature gate, etc.), el agente propone opciones de copy detalladas, ideas de layout y patrones de UX. Las evaluaciones en evals/evals.json muestran cómo debe:

   • Adaptar el copy al estado emocional del usuario (por ejemplo, frustración al alcanzar un límite de proyectos)
   • Advertir sobre anti-patterns (por ejemplo, bloqueos bruscos sin contexto, opciones de plan confusas)
   • Sugerir ejemplos concretos de titulares, cuerpo de texto y CTAs en lugar de consejos genéricos

5. Planificar experimentos e iteraciones
   El archivo references/experiments.md recopila numerosas ideas de tests A/B en torno a:

   • Triggers y timing (aha moment vs. límite alcanzado, mensajes basados en tiempo vs. en uso)
   • Diseño de paywall (pantalla completa vs. modal, layouts minimalistas vs. ricos en funcionalidades)
   • Presentación de precios (un solo plan vs. comparación, descuentos, framing)
   • Copy y mensajes (headlines, CTAs, manejo de objeciones)
   • Flujos de prueba y conversión (recordatorios, pantallas de expiración, caminos de upgrade)
   • Personalización y frecuencia de los mensajes

   El agente puede usar esto para definir un roadmap de tests priorizado, en lugar de cambios aislados.

Ejemplos de uso

1. Paywall por límite de uso en una herramienta SaaS

Gestionas una app de gestión de proyectos donde los usuarios free pueden crear 3 proyectos. Cuando intentan crear el cuarto, quieres un paywall que se sienta justo y convincente, no punitivo.

Con paywall-upgrade-cro, el agente:

• Reconocerá esto como un trigger de límite de uso
• Recomendará una pantalla que:
  • Reconozca lo que el usuario ha conseguido hasta ahora
  • Explique de forma clara qué desbloquea con el upgrade (por ejemplo, proyectos ilimitados, soporte prioritario)
  • Muestre una comparación simple entre free y pago
  • Incluya prueba social y un CTA directo tipo “Upgrade para continuar”
  • Ofrezca un escape hatch (por ejemplo, “Cancelar y mantener tus 3 proyectos”) para evitar un callejón sin salida

2. Pantalla de upgrade al expirar la prueba

Tu prueba de 14 días termina y los usuarios ven un mensaje genérico de “Tu prueba ha expirado”, con una tasa de upgrade baja.

Usando paywall-upgrade-cro, el agente:

• Identificará esto como un trigger de expiración de prueba
• Recomendará enfatizar:
  • El valor que el usuario ya ha experimentado durante la prueba
  • Qué perderá o mantendrá si hace upgrade ahora
  • Detalles claros de planes y precios
  • Incentivos opcionales (como descuentos por tiempo limitado o extensión de la prueba, si encaja)
• Sugerirá pantallas alternativas para recordatorios antes de la expiración y flujos posteriores a la expiración

3. Feature gate para funcionalidades premium

Quieres bloquear una funcionalidad premium (por ejemplo, informes avanzados) detrás de un mensaje de upgrade.

La skill ayuda al agente a:

• Decidir si usar un hard gate (bloqueo total) o un soft gate (preview con mensaje)
• Estructurar un mensaje que presente la funcionalidad como solución a un problema concreto
• Sugerir visuales o previews que muestren lo que el usuario se está perdiendo
• Asegurarse de que el gate aparece cuando el usuario ya ha visto suficiente valor como para considerar pagar

Preguntas frecuentes

¿Para qué está diseñada específicamente paywall-upgrade-cro?

paywall-upgrade-cro está diseñada para ayudar a los agentes a crear y optimizar paywalls dentro del producto, pantallas de upgrade, modales de upsell y feature gates. Se centra en la optimización de la tasa de conversión de usuarios que ya han interactuado con tu producto, más que en el tráfico general del sitio de marketing.

¿Cómo instalo paywall-upgrade-cro?

Instala la skill en tu entorno con soporte de skills con:

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

Luego explora el directorio de la skill en skills/paywall-upgrade-cro/, poniendo el foco en SKILL.md, evals/evals.json y references/experiments.md.

¿Qué archivos debería revisar primero?

Empieza por:

• SKILL.md – define el rol, el alcance y el razonamiento paso a paso para optimizar paywalls y pantallas de upgrade.
• evals/evals.json – muestra prompts de ejemplo y outputs esperados detallados, útil para entender cómo debe comportarse la skill en escenarios reales.
• references/experiments.md – una lista estructurada de ideas de tests A/B y categorías de experimentos para trabajo continuo de CRO.

Estos tres archivos te dan un buen modelo mental de cómo paywall-upgrade-cro aborda los problemas de conversión in-app.

¿Esta skill ayuda con la estrategia de precios?

paywall-upgrade-cro se centra en la presentación y conversión de planes ya existentes dentro del producto: cuándo mostrar paywalls, qué decir y cómo diseñarlos. Si necesitas decidir puntos de precio, packaging o estrategia de descuentos, deberías combinarla con pricing-strategy, que está más orientada a decisiones de pricing de fondo.

¿Es solo para SaaS o también puedo usarla con Shopify y otras plataformas?

La skill está escrita de forma agnóstica a la plataforma y se puede aplicar a:

• Apps web SaaS
• Apps móviles
• Temas de Shopify y mensajes de upgrade en el storefront
• Cualquier entorno frontend donde controles pantallas y modales in-app

Se centra en UX, UI, copy e ideas de experimentación. Puedes implementar los patrones recomendados en tu framework frontend o plataforma de e‑commerce preferidos.

¿Cómo gestiona paywall-upgrade-cro los anti-patterns y la confianza del usuario?

Las evaluaciones en evals/evals.json indican explícitamente al agente que:

• Tenga en cuenta el estado emocional del usuario (por ejemplo, frustración al alcanzar un límite)
• Alerte contra patrones engañosos (como bloqueos sorpresa, precios confusos o datos que desaparecen)
• Incluya escape hatches y mensajes claros

Esto mantiene tus flujos de upgrade persuasivos pero respetuosos, favoreciendo la retención a largo plazo y la confianza en la marca.

¿Puedo personalizar las recomendaciones a mi marca y segmentos?

Sí. La skill espera que el agente:

• Lea .agents/product-marketing-context.md (o .claude/product-marketing-context.md en setups antiguos) cuando esté disponible
• Use tu posicionamiento actual, definición de ICP y narrativas de funcionalidades

Puedes personalizar aún más los outputs proporcionando guías de marca adicionales, indicaciones de tono de voz o descripciones de segmentos en tu prompt o en archivos de contexto.

¿Cómo obtengo el máximo valor de esta skill a largo plazo?

Para sacarle partido a paywall-upgrade-cro de forma continuada:

• Úsala siempre que diseñes o actualices momentos de upgrade in-app
• Combina sus recomendaciones con tus datos de analítica y resultados de experimentos
• Extrae nuevas ideas de test de references/experiments.md a medida que veas qué funciona
• Documenta paywalls y pantallas ganadoras para que el agente pueda usarlas como patrones probados

Así conviertes la skill en un playbook vivo de conversión in‑app, no solo en una ayuda puntual.