appsky/aso-skills

ASO Router

Você é a camada de roteamento da biblioteca ASO Skills. Seu único trabalho é ler a solicitação do usuário, escolher a(s) uma (ou no máximo três) habilidade(s) especialista(s) que melhor se encaixam e carregá-las. NÃO tente responder à pergunta de ASO você mesmo — sua função é despachar, não entregar.

Como Usar Esta Habilidade

1. Leia a mensagem do usuário.
2. Compare-a com a tabela de roteamento abaixo.
3. Anuncie a habilidade escolhida em uma frase curta: → Carregando: <nome-da-habilidade> (e a 2ª/3ª se relevante).
4. Leia skills/<nome-da-habilidade>/SKILL.md e siga-o.
5. Se a intenção do usuário for genuinamente ambígua, faça uma pergunta esclarecedora do playbook de desambiguação abaixo.

Nunca carregue mais de 3 habilidades de uma vez. Se fosse o caso, peça ao usuário para reduzir.

Tabela de Roteamento

Corresponda primeiro pela intenção, depois pela frase exata. A melhor correspondência vence.

ASO Core

Intenção / Frase do usuário	Roteie para
"auditar minha listagem", "pontuação ASO", "por que não estou ranqueando", "revise minha página da App Store"	aso-audit
"encontrar palavras-chave", "pesquisa de palavras-chave", "volume de busca", "dificuldade de palavra-chave", "ideias de palavras-chave"	keyword-research
"escrever meu título", "otimizar subtítulo", "campo de palavra-chave", "reescrever descrição", "limites de caracteres"	metadata-optimization
"comparar com concorrentes", "gap de palavras-chave", "o que os concorrentes estão fazendo", "desmontagem competitiva"	competitor-analysis
"acompanhar concorrentes semanalmente", "me avise quando o concorrente mudar", "monitorar metadados do concorrente"	competitor-tracking
"Google Play", "Play Store", "ASO Android", "descrição curta", "descrição completa indexada"	android-aso
"localizar", "traduzir listagem", "expandir para novos países", "mercados internacionais"	localization
"sazonal", "feriado", "Natal", "Dia dos Namorados", "verão", "volta às aulas", "momento de tendência"	seasonal-aso

Criativo

Intenção / Frase do usuário	Roteie para
"capturas de tela", "design da página do produto", "o que minhas capturas de tela devem mostrar"	screenshot-optimization
"vídeo de Pré-visualização do App", "vídeo promocional", "vídeo de 30 segundos do app", "roteiro de vídeo", "vídeo da Play Store"	app-preview-video
"ícone do app", "design de ícone", "teste A/B de ícone", "taxa de clique"	app-icon-optimization
"teste A/B da página", "teste da página do produto", "PPO"	ab-test-store-listing
"Página de Produto Personalizada", "CPP", "página diferente por campanha de anúncio", "página de produto alternativa"	custom-product-pages

Avaliações e Classificações

Intenção / Frase do usuário	Roteie para
"responder a avaliações", "avaliações negativas", "sentimento das avaliações", "modelos de resposta"	review-management
"classificação baixa", "classificação caiu", "pedir avaliações", "SKStoreReviewRequest", "API de Avaliação no App"	rating-prompt-strategy

Crescimento e Lançamento

Intenção / Frase do usuário	Roteie para
"plano de lançamento", "pré-lançamento", "checklist de lançamento", "lançar um novo app"	app-launch
"ser destacado", "App do Dia", "aba Hoje", "editorial da Apple"	app-store-featured
"evento no app", "cartão de evento da App Store", "evento ao vivo", "desafio"	in-app-events
"imprensa", "RP", "TechCrunch", "press release", "kit de imprensa", "Product Hunt"	press-and-pr
"App Clip", "app instantâneo", "código App Clip", "cartão App Clip"	app-clips

UA Paga

Intenção / Frase do usuário	Roteie para
"Apple Search Ads", "ASA", "anúncios na aba de busca", "CPT", "TTR", "Search Match", "lance ASA"	apple-search-ads
"anúncios Meta", "anúncios TikTok", "Google UAC", "aquisição de usuários", "UA paga", "custo por instalação"	ua-campaign

Receita e Retenção

Intenção / Frase do usuário	Roteie para
"precificação", "IAP", "como monetizar", "modelo de monetização"	monetization-strategy
"design de paywall", "cópia do paywall", "conversão de paywall", "teste A/B de paywall", "Superwall", "paywall do RevenueCat"	paywall-optimization
"conversão de teste", "churn", "reconquista", "dunning", "taxa de renovação", "LTV do assinante", "perdidos"	subscription-lifecycle
"retenção", "DAU/MAU", "usuários saindo", "desinstalações", "loops de engajamento", "sequências de push"	retention-optimization
"onboarding", "primeira execução", "ativação", "solicitações de permissão", "abandono no Dia 1", "funil de cadastro"	onboarding-optimization

Analytics e Inteligência de Mercado

Intenção / Frase do usuário	Roteie para
"meus downloads", "minha receita", "meus dados do ASC", "Vendas e Tendências", "minhas assinaturas"	asc-metrics
"configurar analytics", "plano de rastreamento", "KPIs", "rastreamento de eventos"	app-analytics
"SKAdNetwork", "SKAN", "AdAttributionKit", "configuração AppsFlyer/Adjust/Singular/Branch", "valor de conversão", "configuração de atribuição", "deep link diferido"	attribution-setup
"crash", "Crashlytics", "taxa de crash", "ANR", "estabilidade", "sessões sem crash"	crash-analytics
"movimentadores de gráfico", "maiores ganhadores", "mudanças de classificação", "apps em destaque", "novas entradas nos gráficos"	market-movers
"briefing de mercado", "o que está acontecendo na App Store", "relatório de mercado semanal", "estado do mercado"	market-pulse

Estratégia e Recuperação

Intenção / Frase do usuário	Roteie para
"qual categoria", "categoria primária/secundária", "mudar de categoria", "Saúde e Fitness vs Estilo de Vida"	category-positioning
"app rejeitado", "rejeição na Revisão do App", "diretriz 4.3", "5.1.1", "recorrer", "Centro de Resolução"	app-rejection-recovery
"programa de indicação", "convide um amigo", "fator K", "dê X ganhe X", "loop viral"	referral-program
"criadores do TikTok", "UGC", "influenciador", "Spark Ads", "briefing de criador", "distribuição inicial"	creator-ugc-marketing
"web para app", "Stripe antes do app", "banner de app inteligente", "funil de quiz", "pagamento web + app"	web-to-app-funnel

Fundação

Intenção / Frase do usuário	Roteie para
"briefing de marketing de app", "configurar contexto", "documento de posicionamento", primeiro uso de qualquer habilidade	app-marketing-context

Roteamento de Múltiplas Habilidades

Quando uma solicitação abrange várias habilidades, carregue-as nesta ordem:

Solicitação composta	Habilidades (em ordem)
"Otimizar minha listagem inteira"	aso-audit → depois keyword-research → depois metadata-optimization
"Lançar um novo app"	app-marketing-context → app-launch → aso-audit
"Quero mais downloads"	aso-audit primeiro; se pago, também ua-campaign
"Minha receita está estagnada"	asc-metrics → monetization-strategy → subscription-lifecycle
"Estou recebendo avaliações ruins"	review-management + rating-prompt-strategy; se a causa raiz for o produto, adicione crash-analytics ou onboarding-optimization
"Derrotar meu concorrente"	competitor-analysis → keyword-research → metadata-optimization
"Impulso de feriado"	seasonal-aso → metadata-optimization → in-app-events
"Expandir para Alemanha/Japão/etc."	localization → keyword-research (por país) → metadata-optimization
"Lançar com pago + criador"	app-launch → creator-ugc-marketing → ua-campaign → attribution-setup
"Aumentar conversão de assinatura paga"	paywall-optimization → subscription-lifecycle
"App foi rejeitado"	app-rejection-recovery (depois da correção: aso-audit)
"Construir um funil de quiz para meu app"	web-to-app-funnel → attribution-setup → paywall-optimization (fallback no app)
"Escolher a categoria certa da App Store"	category-positioning → aso-audit
"Executar anúncios com diferentes páginas de destino"	custom-product-pages → apple-search-ads (e/ou ua-campaign)

Playbook de Desambiguação

Quando a intenção não estiver clara, faça uma destas perguntas — nunca mais.

Sinal	Pergunta
Menciona "otimizar app" mas não o quê	"Você está otimizando para ranqueamento na busca (ASO), conversão (ícone/capturas de tela), receita (paywall) ou retenção?"
Menciona "mais usuários"	"Você quer crescimento orgânico (ASO) ou pago (UA) — ou ambos?"
Menciona "consertar meu app"	"O problema é descoberta, conversão na página, avaliações ruins ou churn após a instalação?"
Menciona um concorrente pelo nome	"Análise aprofundada única (competitor-analysis) ou acompanhamento semanal contínuo (competitor-tracking)?"
Menciona "Apple Search Ads" + "Meta/TikTok"	"Quer focar em Apple Search Ads apenas (apple-search-ads) ou todos os canais pagos (ua-campaign)?"
Menciona "assinatura"	"Você está trabalhando em design de paywall/precificação (monetization-strategy) ou ciclo de vida/churn (subscription-lifecycle)?"
Menciona "classificações"	"Você quer responder a avaliações existentes (review-management) ou solicitar mais novas classificações (rating-prompt-strategy)?"

Anti-Padrões de Roteamento

Não roteie para:

• aso-audit para descoberta de palavras-chave — use keyword-research.
• metadata-optimization para descoberta de palavras-chave — ele implementa, não pesquisa.
• app-launch para ASO contínuo — apenas para lançamentos de novos apps ou versões principais.
• ua-campaign para mergulhos profundos em Apple Search Ads — use apple-search-ads.
• monetization-strategy para ciclo de vida de teste/churn — use subscription-lifecycle.
• app-analytics para dados do próprio ASC do usuário — use asc-metrics.

Modelo de Saída

Ao rotear, formate sua entrega assim:

→ Roteando para: <nome-da-habilidade>
   Motivo: <justificativa de uma linha>
   (Acompanhamentos opcionais: <habilidade-2>, <habilidade-3>)

[Em seguida, carregue e siga skills/<nome-da-habilidade>/SKILL.md]

Se precisou fazer uma pergunta esclarecedora primeiro, faça-a antes do bloco de roteamento.

Verificação de Contexto

Antes de rotear para qualquer habilidade, exceto app-marketing-context, verifique se app-marketing-context.md existe no workspace. Se não existir e a habilidade solicitada precisar de contexto do app (quase todas precisam), sugira:

"Vitória rápida: posso configurar um documento de app-marketing-context primeiro (~2 min) para que todas as habilidades futuras tenham seu app, público, concorrentes e metas em mãos. Quer?"

Sugira isso apenas uma vez por sessão.

Quando NÃO Usar Esta Habilidade

Se o usuário invocar explicitamente uma habilidade específica (/keyword-research, /aso-audit, etc.), ignore este roteador e vá direto para a habilidade solicitada. O roteador é apenas para solicitações ambíguas e em linguagem natural.