paywall-upgrade-cro

Visão geral

O que esta skill faz

A skill paywall-upgrade-cro transforma seu agente em um especialista em paywalls in-app e fluxos de upgrade. Ela foca nos momentos dentro do seu produto em que você pede para o usuário fazer upgrade, pagar ou migrar para um plano superior — depois que ele já experimentou valor.

Use paywall-upgrade-cro quando quiser criar ou melhorar:

• Paywalls in-app e telas de upgrade
• Modais de upsell e feature gates
• Telas de fim de teste e de limite atingido
• Prompts de upgrade de plano e apresentações de preços dentro do produto

Ela é diferente da otimização de página pública de preços: para páginas de pricing em site de marketing, use page-cro; para dúvidas sobre estratégia de precificação, use pricing-strategy.

Para quem é

Esta skill é ideal para:

• Times de SaaS e produto que operam com modelos freemium ou de teste
• Product managers e times de growth responsáveis pela conversão dentro do produto
• Designers de UX e UI que trabalham em fluxos de upgrade, modais e gates
• Times de marketing responsáveis por mensagens in-app e textos de paywall
• Desenvolvedores Shopify ou frontend que implementam prompts de upgrade

Se seu principal desafio é “usuários free não fazem upgrade”, “usuários em teste não convertem” ou “nossa tela de upgrade não funciona”, paywall-upgrade-cro foi feita para esse tipo de problema.

Problemas que ela resolve

Com a estrutura definida em SKILL.md e as ideias de experimentos em references/experiments.md, a skill ajuda o agente a:

• Diagnosticar por que seu paywall ou tela de upgrade atual tem baixa performance
• Alinhar o timing do paywall com o aha moment do usuário, limite atingido ou status do teste
• Desenhar telas que enfatizam valor acima da fricção, não apenas “você atingiu um limite”
• Estruturar fluxos de upgrade com títulos claros, demonstração de valor, comparação de planos, prova social e CTAs fortes
• Evitar dark patterns e anti-patterns que prejudicam a confiança e a retenção de longo prazo
• Gerar ideias de testes A/B para texto, layout, exibição de preços e lógica de disparo

Quando é ou não é uma boa opção

Use paywall-upgrade-cro quando:

• Você está trabalhando em um paywall ou momento de upgrade dentro de um produto ou app
• Precisa melhorar trial-to-paid, conversão de freemium ou upgrades de plano
• Quer recomendações estruturadas (não apenas sugestões aleatórias de texto)
• Está planejando experimentos de CRO para telas in-app

Talvez não seja a melhor opção quando:

• Você só quer redesenhar uma página pública de marketing ou de preços (use page-cro)
• Está definindo níveis de preço ou estratégia de packaging (use pricing-strategy)
• Precisa de ajuda profunda com lógica de billing backend ou implementação de gateway de pagamento (esta skill foca em UX, texto e conversão, não em integrações de cobrança)

Como usar

Instalação

Para adicionar a skill paywall-upgrade-cro à configuração do seu agente, instale a partir do repositório marketingskills:

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

Após a instalação, localize o diretório da skill:

• Repositório: coreyhaines31/marketingskills
• Caminho da skill: skills/paywall-upgrade-cro/
• Arquivos principais:
  • SKILL.md
  • evals/evals.json
  • references/experiments.md

Fluxo de trabalho principal

SKILL.md define como o agente deve pensar e atuar ao usar paywall-upgrade-cro. O fluxo típico é:

1. Carregar primeiro o contexto de produto
   Se seu repositório inclui .agents/product-marketing-context.md (ou .claude/product-marketing-context.md em setups mais antigos), o agente é instruído a ler esse arquivo antes de fazer perguntas. Isso garante que as recomendações estejam alinhadas ao seu:

   • Modelo de produto (freemium, teste, tiers pagos)
   • Principais propostas de valor
   • Segmentos-alvo e casos de uso

2. Esclarecer o cenário de upgrade
   A skill orienta o agente a entender:

   • Contexto de upgrade: freemium → paid, trial → paid, upgrade de plano ou upsell de feature
   • Modelo de produto: o que é grátis, o que fica atrás do paywall e o que dispara o prompt
   • Jornada do usuário: onde ele está, o que estava tentando fazer e em que estado emocional provavelmente se encontra (por exemplo, frustração ao bater em um limite)

3. Aplicar um framework estruturado de paywall
   Usando as orientações em SKILL.md e os exemplos em evals/evals.json, o agente estrutura paywalls e telas de upgrade com componentes como:

   • Headline que comunica o valor do upgrade — não apenas que o acesso foi bloqueado
   • Demonstração de valor: o que o usuário desbloqueia (features, resultados, ganho de tempo)
   • Comparação de planos entre free e paid, quando fizer sentido
   • Prova social (depoimentos, estatísticas de uso, logos) para reduzir risco
   • CTA claro, específico e orientado à ação
   • Escape hatch para o usuário voltar ao que estava fazendo sem se sentir preso

4. Gerar recomendações específicas de texto e layout
   Com base no gatilho específico (limite de uso, fim de teste, feature gate etc.), o agente propõe opções detalhadas de copy, ideias de layout e padrões de UX. As avaliações em evals/evals.json mostram como ele deve:

   • Adaptar o texto ao estado emocional do usuário (por exemplo, frustração por atingir o limite de projetos)
   • Alertar contra anti-patterns (como bloqueios-surpresa sem contexto, opções de plano confusas)
   • Sugerir exemplos concretos de headlines, corpo de texto e CTAs, em vez de conselhos genéricos

5. Planejar experimentos e iterações
   O arquivo references/experiments.md lista uma ampla variedade de ideias de testes A/B em:

   • Triggers & timing (aha moment vs. limite atingido, prompts baseados em tempo vs. uso)
   • Design de paywall (full-screen vs. modal, layouts minimalistas vs. ricos em features)
   • Apresentação de preços (plano único vs. comparação, descontos, framing)
   • Copy & messaging (headlines, CTAs, tratamento de objeções)
   • Fluxos de teste e conversão (lembretes, telas de expiração, caminhos de upgrade)
   • Personalização e frequency capping

   O agente pode usar isso para montar um roadmap de testes priorizado, em vez de mudanças pontuais.

Exemplos de uso

1. Paywall por limite de uso em uma ferramenta SaaS

Você tem um app de gestão de projetos em que usuários free podem criar 3 projetos. Ao tentar criar o 4º, você quer um paywall que pareça justo e persuasivo, não punitivo.

Com paywall-upgrade-cro, o agente vai:

• Reconhecer isso como um usage limit trigger
• Recomendar uma tela que:
  • Reconhece o que o usuário já conquistou até agora
  • Explica de forma sucinta o que o upgrade libera (por exemplo, projetos ilimitados, suporte prioritário)
  • Mostra uma comparação simples entre free e paid
  • Inclui prova social e um CTA direto “Upgrade to continue”
  • Oferece um escape hatch (por exemplo, “Cancel and keep your 3 projects”) para evitar um beco sem saída

2. Tela de upgrade ao fim do período de teste

Seu teste de 14 dias termina e os usuários veem uma mensagem genérica “Your trial has expired”, com baixa taxa de upgrade.

Usando paywall-upgrade-cro, o agente vai:

• Identificar isso como um trial expiration trigger
• Recomendar dar ênfase a:
  • O valor que o usuário já experimentou durante o teste
  • O que ele perde ou mantém acesso se fizer upgrade agora
  • Detalhes claros de planos e preços
  • Incentivos opcionais (como descontos por tempo limitado ou extensão de teste, se fizer sentido)
• Sugerir telas alternativas para lembretes antes da expiração e fluxos após a expiração

3. Feature gate para funcionalidade premium

Você quer bloquear uma funcionalidade premium (por exemplo, relatórios avançados) atrás de um prompt de upgrade.

A skill ajuda o agente a:

• Decidir entre usar um hard gate (bloqueio total) ou soft gate (preview com prompt)
• Estruturar a mensagem posicionando a feature como solução para um problema específico
• Sugerir visuais ou previews que mostrem o que o usuário está perdendo
• Garantir que o gate apareça depois que o usuário já viu valor suficiente para considerar pagar

FAQ

Para que exatamente paywall-upgrade-cro foi projetada?

paywall-upgrade-cro foi projetada para ajudar agentes a criar e otimizar paywalls dentro do produto, telas de upgrade, modais de upsell e feature gates. Ela enfatiza otimização de taxa de conversão para usuários que já interagiram com seu produto, e não para tráfego amplo de site de marketing.

Como instalo paywall-upgrade-cro?

Instale a skill em seu ambiente com suporte a skills usando:

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

Depois, explore o diretório da skill em skills/paywall-upgrade-cro/, com foco em SKILL.md, evals/evals.json e references/experiments.md.

Quais arquivos devo ver primeiro?

Comece por:

• SKILL.md – define o papel, o escopo e o raciocínio passo a passo para otimização de paywalls e telas de upgrade.
• evals/evals.json – mostra prompts de exemplo e outputs esperados em detalhes, útil para entender como a skill deve se comportar em cenários reais.
• references/experiments.md – uma lista estruturada de ideias de testes A/B e categorias de experimentos para trabalho contínuo de CRO.

Esses três arquivos fornecem uma boa base mental de como paywall-upgrade-cro aborda problemas de conversão in-app.

Esta skill ajuda com estratégia de preços?

paywall-upgrade-cro foca na apresentação e conversão de planos existentes dentro do produto: quando mostrar paywalls, o que dizer e como desenhá-los. Se você precisa definir price points, packaging ou estratégia de descontos, deve combiná-la com pricing-strategy, que é mais adequada para decisões estruturais de pricing.

Isso é só para SaaS ou posso usar com Shopify e outras plataformas?

A skill foi escrita de forma agnóstica em relação à plataforma e pode ser aplicada a:

• Web apps SaaS
• Apps mobile
• Temas Shopify e prompts de upgrade em storefront
• Qualquer ambiente de frontend em que você controla telas e modais in-app

Ela se concentra em UX, UI, copy e ideias de experimentos. Você pode implementar os padrões recomendados no framework de frontend ou plataforma de e-commerce que preferir.

Como paywall-upgrade-cro lida com anti-patterns e confiança do usuário?

As avaliações em evals/evals.json instruem explicitamente o agente a:

• Considerar o estado emocional do usuário (por exemplo, frustração ao atingir um limite)
• Alertar contra padrões enganosos (como bloqueios surpresa, preços confusos ou dados que somem)
• Incluir escape hatches e mensagens claras

Isso mantém seus fluxos de upgrade persuasivos, mas respeitosos, apoiando retenção de longo prazo e confiança na marca.

Posso customizar as recomendações para minha marca e segmentos?

Sim. A skill espera que o agente:

• Leia .agents/product-marketing-context.md (ou .claude/product-marketing-context.md em setups mais antigos), quando disponível
• Use seu posicionamento atual, definições de ICP e narrativas de features

Você pode refinar ainda mais as respostas fornecendo guidelines de marca, orientações de tom de voz ou descrições de segmentos adicionais no seu prompt ou em arquivos de contexto.

Como obter o máximo valor desta skill ao longo do tempo?

Para extrair valor contínuo de paywall-upgrade-cro:

• Use-a sempre que desenhar ou atualizar momentos de upgrade in-app
• Combine as recomendações com dados de analytics e resultados de experimentos
• Puxe novas ideias de teste de references/experiments.md à medida que descobrir o que funciona
• Documente paywalls e telas vencedoras para que o agente possa usá-las como padrões comprovados

Isso transforma a skill em um playbook vivo de conversão in-app, e não apenas em uma ajudante pontual.