Communitygithub.com

asodevapp/skills

Use quando o usuário quiser criar, planejar, auditar, otimizar, localizar ou preencher Eventos no Aplicativo da App Store no ASO.dev: cartões de evento para as abas Hoje/Jogos/Apps, busca, páginas de produto, reengajamento, desafios, competições, eventos ao vivo, estreias, temporadas, grandes atualizações e eventos especiais.

O que é skills?

Esta skill especializada em Eventos no Aplicativo (In-App Events) da App Store permite que assistentes de IA como o Claude Code ajudem times de produto e ASO a criar, planejar, auditar, otimizar, localizar e preencher cartões promocionais que aparecem nas abas Hoje, Jogos e Apps, além de resultados de busca e páginas de produto. A skill substitui a necessidade de consultar múltiplas documentações da Apple, consolidando estratégia de badge/tipo, metadados, direção de mídia, validação de restrições (como limites de caracteres e duração) e integração com o MCP do App Store Connect para leitura e preenchimento de eventos. Suporta todos os tipos de badge oficiais — Desafio, Competição, Evento ao Vivo, Grande Atualização, Estreia, Nova Temporada e Evento Especial — com recomendações por categoria de aplicativo. Além disso, inclui um checklist de melhoria contínua, regras de redação e um fluxo de planejamento sazonal com calendário cultural. A skill é projetada para ser usada com o MCP `app-store-connect-mcp` e o `seasonal-calendar`, garantindo que o conteúdo seja validado e pronto para submissão via `fill_app_event`.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/asodevapp/skills/tree/HEAD/skills/in-app-events

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Eventos no Aplicativo

Use isso para estratégia de Eventos no Aplicativo da App Store, metadados, direção de mídia, localização, validação e preenchimento de rascunho no ASO.dev.

Fluxo de trabalho MCP

  1. Use app-store-connect-mcp.
  2. Leia o evento ativo com get_app_event_data.
  3. Leia o contexto do projeto quando posicionamento ou tom forem relevantes.
  4. Use seasonal-calendar quando o evento estiver vinculado a feriados públicos, momentos culturais ou planejamento de campanhas mensais.
  5. Identifique o objetivo do evento, badge/tipo, público, territórios, datas e escopo de localização.
  6. Rascunhe os campos do evento, texto localizado e direção de mídia.
  7. Valide com validate_ai_companion_data alvo appEvent.
  8. Se solicitado a aplicar, preencha com fill_app_event.

O que os eventos fazem

Eventos no Aplicativo são cartões temporários da App Store para conteúdo ou atividades oportunas dentro do aplicativo. Eles podem aparecer na página de produto, na busca e em posicionamentos editoriais/personalizados em todas as superfícies da App Store. Podem apoiar aquisição, reengajamento, adoção de funcionalidades e campanhas sazonais.

Eles são mais fortes quando o evento é mais do que uma funcionalidade comum do aplicativo.

Campos suportados

  • referenceName
  • badge
  • priority
  • primaryLocale
  • purpose
  • purchaseRequirement
  • deepLink
  • localizations: locale -> name, shortDescription, longDescription

Restrições da Apple

ItemLimite
Nome de referência64 caracteres
Nome do evento30 caracteres
Descrição curta50 caracteres
Descrição longa120 caracteres
Duração15 minutos a 31 dias
Início da publicaçãoAté 14 dias antes do início do evento
Eventos simultâneosAté 10 por vez
Eventos aprovadosAté 15 por aplicativo
Eventos em rascunhoAté 50

Especificações de mídia:

AtivoProporçãoMínimoMáximo
Imagem/vídeo do cartão do evento16:91920x10803840x2160
Imagem/vídeo de detalhes do evento9:161080x19202160x3840

Use JPG/PNG para imagens e MOV/M4V/MP4 para vídeos. Mantenha os elementos visuais importantes legíveis como uma miniatura de cartão pequena.

Estratégia de badge

BadgeMelhor para
ChallengeConclusão de metas, sequências, fitness, educação, progresso em jogos
CompetitionRankings, torneios, competições com pontuação, placares de líderes
Live EventSessões em tempo real que os usuários experimentam juntos
Major UpdateNovo recurso/conteúdo significativo além de correções de bugs
PremierePrimeiro lançamento de nova mídia ou conteúdo
New SeasonNova temporada de conteúdo, passe de batalha, atualização da biblioteca de conteúdo
Special EventCampanha sazonal, temática, colaboração ou por tempo limitado

Por tipo de aplicativo:

  • Jogos: Challenge, Competition, New Season, Major Update
  • Fitness/bem-estar: Challenge, Live Event, Major Update
  • Produtividade/utilidade: Major Update, Special Event
  • Social/comunidade: Live Event, Challenge, Competition
  • Streaming/conteúdo: Premiere, New Season, Special Event

Checklist de melhoria

  • O evento tem um motivo real para existir: desafio, competição, evento ao vivo, grande atualização, nova temporada, estreia ou evento especial.
  • O nome é específico e oportuno.
  • A descrição curta dá valor imediato.
  • A descrição longa diz o que acontece, para quem é e como participar.
  • O requisito de compra/assinatura é claro.
  • O deep link é preservado, a menos que o usuário peça para alterá-lo.
  • As localizações traduzem a intenção, não as palavras.
  • A mídia do evento mostra o resultado, recompensa, conteúdo ou atividade, em vez de uma captura de tela genérica da interface.

Regras de redação

  • O nome do evento deve começar com a ação do usuário, benefício, conteúdo ou momento. Evite começar com o nome do aplicativo, a menos que o reconhecimento da marca seja o objetivo.
  • A descrição curta deve responder "o que eu ganho com isso?"
  • A descrição longa deve cobrir o quê, porquê e como participar.
  • Use apenas 1-2 palavras-chave quando for natural; não encha o nome do evento de palavras-chave.
  • Escreva o nome do evento como se ele pudesse aparecer sozinho em notificações, busca e cartões.

Fluxo de planejamento

  1. Escolha o objetivo principal: aquisição, reengajamento, lançamento de funcionalidade, lançamento de conteúdo, visibilidade sazonal ou ativação da comunidade.
  2. Para ideias sazonais, use o calendário do ASO.dev em https://aso.dev/blog/calendar/ ou a assinatura do Google Calendar vinculada lá.
  3. Escolha o badge/tipo com base na atividade real do usuário.
  4. Escolha as datas e submeta cedo o suficiente para revisão; sinalize se a data de início estiver muito próxima.
  5. Rascunhe o texto para cada localidade.
  6. Especifique a direção de mídia do cartão e dos detalhes.
  7. Defina KPIs: impressões do evento, visualizações da página do evento, lembretes, toques em notificações, aberturas do aplicativo, downloads, assinaturas ou vendas.
  8. Monte um calendário mensal quando o usuário pedir uma estratégia contínua.

Saída

# Brief e Rascunho do Evento no Aplicativo

Evento:
Aplicativo:
Localidade principal:
Objetivo:
Badge:
Datas:
Status:

## Estado atual
| Campo | Atual | Caracteres | Problema |
|---|---:|---|

## Estratégia
- Público:
- Objetivo principal:
- Por que isso é digno de evento:
- KPI:
- Risco de submissão/revisão:

## Campos propostos
| Campo | Valor | Motivo |
|---|---|---|

## Localizações
| Localidade | Nome | Descrição curta | Descrição longa |
|---|---|---|---|

## Direção de mídia
- Mídia do cartão do evento:
- Mídia de detalhes do evento:
- Visual principal:
- Risco de miniatura:
- Texto na imagem:

## Calendário de eventos
| Semana/data | Evento | Badge | Objetivo | Notas |
|---|---|---|---|---|

## Validação
- Ângulo claro do evento:
- Acesso/custo claros:
- Deep link preservado/testado:
- Limites de caracteres:
- Datas dentro das restrições:
- Especificações de mídia:
- Validação MCP:
- Pronto para `fill_app_event`:

Regras

  • Não invente datas, prêmios, termos de acesso ou disponibilidade.
  • Não reivindique urgência a menos que dados atuais a suportem.
  • Se for necessário pagamento extra, diga claramente.
  • Não use Eventos no Aplicativo para correções de bugs menores, funcionalidades normais perenes ou promoções genéricas sem atividade oportuna do usuário.
  • Não prometa posicionamento na aba Hoje ou notificações da App Store. Trate posicionamento e lembretes como oportunidades, não garantias.

Individual skills in this repo

This repo contains 10 individual skills — each has its own dedicated page.

asodevapp/skills

Use when the user wants Google Play Store or Android ASO: Play listing title, short description, full description, keyword strategy, feature graphic, screenshots, ratings/reviews, Play Store Experiments, localization, or Google Play-specific metadata via ASO.dev.

asodevapp/skills

Use when the user wants to interpret ASO.dev Measurements or App Store Connect metrics: downloads, impressions, product page views, conversion, revenue, retention, sessions, active devices, ratings, reviews, release markers, experiment impact, or before/after ASO performance.

asodevapp/skills

Use to read, create, or update ASO.dev per-app project context before metadata, localization, keywords, screenshots, IAP, subscriptions, pricing, In-App Events, nominations, or review work.

asodevapp/skills

Use when the user wants a full ASO audit or health check for an app: metadata, keyword coverage, cross-localization, screenshots, reviews, ratings, update history, In-App Events, IAP/subscriptions, CPP/PPO, competitors, rankings, or ASO.dev ASO Check interpretation.

asodevapp/skills

Use when the user wants App Store Custom Product Pages, Product Page Optimization, A/B testing, conversion rate optimization, product page variants, screenshot/icon/app preview tests, campaign pages, keyword/ad alignment, or CPP/PPO drafts in ASO.dev.

asodevapp/skills

Use for App Store consumable and non-consumable In-App Purchases: metadata, localization, pricing/availability notes, promoted IAP readiness, validation, and ASO.dev local MCP fill when that surface is available.

asodevapp/skills

Use for keyword ideas, keyword prioritization, keyword/search query CSV-derived shortlists, competitor keyword gaps, Search Ads Popularity interpretation, and keyword distribution across metadata/locales.

asodevapp/skills

Use when the user wants to write, rewrite, optimize, compare, validate, or bulk-fill Apple App Store or Google Play metadata in ASO.dev: title, subtitle, keyword field, description, promotional text, short description, full description, or What's New.

asodevapp/skills

Use when the user wants to analyze, respond to, report, or improve App Store reviews and ratings in ASO.dev: negative reviews, ratings trend, review replies, review complaints, review health, product insights, uploaded review CSV analysis, sentiment, missing feature requests, or rating prompt strategy.

asodevapp/skills

Use to prepare screenshot copy, screenshot order, creative briefs, and App Store / Google Play visual messaging.

Habilidades Relacionadas