Communitygithub.com

asodevapp/skills

Úsalo cuando el usuario quiera crear, planificar, auditar, optimizar, localizar o completar eventos dentro de la aplicación en ASO.dev para la App Store: tarjetas de evento para las pestañas Hoy/Juegos/Apps, búsqueda, páginas de producto, reenganche, desafíos, competiciones, eventos en vivo, estrenos, temporadas, actualizaciones importantes y eventos especiales.

¿Qué es skills?

Este skill está diseñado para ayudar a desarrolladores y profesionales de ASO a gestionar eventos dentro de la aplicación (In-App Events) en la App Store de Apple. Su propósito principal es guiar la estrategia, redacción de metadatos, dirección de medios, localización, validación y el llenado de borradores en la plataforma ASO.dev. El skill integra flujos de trabajo con `app-store-connect-mcp` para leer eventos activos, usar un calendario estacional para fechas culturales o campañas mensuales, y validar datos con `validate_ai_companion_data`. Cubre la selección de insignias (badges) según el tipo de app (juegos, fitness, productividad, etc.), restricciones de Apple (límites de caracteres, duración, cantidad de eventos solapados), y consejos de redacción centrados en el usuario. Además, proporciona una lista de verificación de mejora y reglas claras para no inventar fechas o reclamar urgencia sin datos. Está optimizado para su uso con Claude Code, Cursor y Codex, y se enfoca en generar borradores completos y validados listos para enviar.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Eventos dentro de la aplicación

Usa esto para la estrategia, metadatos, dirección de medios, localización, validación y llenado de borradores de eventos dentro de la aplicación en ASO.dev.

Flujo de trabajo MCP

  1. Usa app-store-connect-mcp.
  2. Lee el evento activo con get_app_event_data.
  3. Lee el contexto del proyecto cuando el posicionamiento o el tono sean importantes.
  4. Usa seasonal-calendar cuando el evento esté vinculado a días festivos, momentos culturales o planificación de campañas mensuales.
  5. Identifica el objetivo del evento, la insignia/tipo, la audiencia, los territorios, las fechas y el alcance de la localización.
  6. Redacta los campos del evento, el texto localizado y la dirección de medios.
  7. Valida con validate_ai_companion_data destino appEvent.
  8. Si se solicita aplicar, completa con fill_app_event.

Qué hacen los eventos

Los eventos dentro de la aplicación son tarjetas temporales de la App Store para contenido o actividades oportunas dentro de la app. Pueden aparecer en la página de producto, en la búsqueda y en ubicaciones editoriales/personalizadas en todas las superficies de la App Store. Pueden apoyar la adquisición, el reenganche, la adopción de funciones y las campañas estacionales.

Son más efectivos cuando el evento es más que una funcionalidad normal de la aplicación.

Campos admitidos

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

Restricciones de Apple

ElementoRestricción
Nombre de referencia64 caracteres
Nombre del evento30 caracteres
Descripción corta50 caracteres
Descripción larga120 caracteres
Duración15 minutos a 31 días
Inicio de publicaciónHasta 14 días antes del inicio del evento
Eventos solapadosHasta 10 a la vez
Eventos aprobadosHasta 15 por app
Eventos en borradorHasta 50

Especificaciones de medios:

RecursoRelaciónMínimoMáximo
Imagen/vídeo de tarjeta de evento16:91920x10803840x2160
Imagen/vídeo de detalles del evento9:161080x19202160x3840

Usa JPG/PNG para imágenes y MOV/M4V/MP4 para vídeos. Mantén los elementos visuales importantes legibles como una miniatura de tarjeta pequeña.

Estrategia de insignias

InsigniaMejor para
ChallengeFinalización de objetivos, rachas, fitness, educación, progreso en juegos
CompetitionClasificaciones, torneos, concursos puntuados, tablas de clasificación
Live EventSesiones en tiempo real que los usuarios experimentan juntos
Major UpdateNueva función/contenido significativo más allá de correcciones de errores
PremierePrimer lanzamiento de nuevo contenido o medios
New SeasonNueva temporada de contenido, pase de batalla, actualización de biblioteca de contenido
Special EventCampaña estacional, temática, de colaboración o por tiempo limitado

Por tipo de app:

  • Juegos: Challenge, Competition, New Season, Major Update
  • Fitness/bienestar: Challenge, Live Event, Major Update
  • Productividad/utilidad: Major Update, Special Event
  • Social/comunidad: Live Event, Challenge, Competition
  • Streaming/contenido: Premiere, New Season, Special Event

Lista de verificación de mejora

  • El evento tiene una razón real para existir: challenge, competition, live event, major update, new season, premiere o special event.
  • El nombre es específico y oportuno.
  • La descripción corta da valor inmediato.
  • La descripción larga dice qué sucede, para quién es y cómo participar.
  • El requisito de compra/suscripción es claro.
  • El enlace profundo se conserva a menos que el usuario solicite cambiarlo.
  • Las localizaciones traducen la intención, no las palabras.
  • Los medios del evento muestran el resultado, la recompensa, el contenido o la actividad, en lugar de una captura de pantalla genérica de la interfaz.

Reglas de redacción

  • El nombre del evento debe liderar con la acción del usuario, el beneficio, el contenido o el momento. Evita comenzar con el nombre de la app a menos que el reconocimiento de marca sea el objetivo.
  • La descripción corta debe responder a "¿qué gano yo?"
  • La descripción larga debe cubrir qué, por qué y cómo participar.
  • Usa solo 1-2 palabras clave cuando sea natural; no abuses de palabras clave en los nombres de eventos.
  • Escribe el nombre del evento como si pudiera aparecer solo en notificaciones, búsquedas y tarjetas.

Flujo de trabajo de planificación

  1. Elige el objetivo principal: adquisición, reenganche, lanzamiento de función, lanzamiento de contenido, visibilidad estacional o activación de la comunidad.
  2. Para ideas estacionales, usa el calendario de ASO.dev en https://aso.dev/blog/calendar/ o la suscripción al Calendario de Google vinculada allí.
  3. Elige la insignia/tipo basándote en la actividad real del usuario.
  4. Elige las fechas y envía con suficiente antelación para la revisión; indica si la fecha de inicio está demasiado cerca.
  5. Redacta el texto para cada idioma.
  6. Especifica la dirección de medios para la tarjeta y los detalles.
  7. Define KPI: impresiones del evento, visitas a la página del evento, recordatorios, toques en notificaciones, aperturas de app, descargas, suscripciones o ventas.
  8. Crea un calendario mensual cuando el usuario solicite una estrategia continua.

Salida

# Resumen y borrador del evento dentro de la aplicación

Evento:
App:
Idioma principal:
Objetivo:
Insignia:
Fechas:
Estado:

## Estado actual
| Campo | Actual | Caracteres | Problema |
|---|---:|---|

## Estrategia
- Audiencia:
- Objetivo principal:
- Por qué este evento merece serlo:
- KPI:
- Riesgo de envío/revisión:

## Campos propuestos
| Campo | Valor | Razón |
|---|---|---|

## Localizaciones
| Idioma | Nombre | Descripción corta | Descripción larga |
|---|---|---|---|

## Dirección de medios
- Medios de la tarjeta de evento:
- Medios de los detalles del evento:
- Visual clave:
- Riesgo de miniatura:
- Texto en imagen:

## Calendario de eventos
| Semana/fecha | Evento | Insignia | Objetivo | Notas |
|---|---|---|---|---|

## Validación
- Ángulo claro del evento:
- Acceso/coste claro:
- Enlace profundo conservado/probado:
- Límites de caracteres:
- Fechas dentro de las restricciones:
- Especificaciones de medios:
- Validación MCP:
- Listo para `fill_app_event`:

Reglas

  • No inventes fechas, premios, términos de acceso o disponibilidad.
  • No reclames urgencia a menos que los datos actuales la respalden.
  • Si se requiere un pago adicional, dilo claramente.
  • No uses eventos dentro de la aplicación para correcciones de errores menores, funciones normales permanentes o promociones genéricas sin una actividad oportuna del usuario.
  • No prometas ubicación en la pestaña Hoy ni notificaciones de la App Store. Trata la ubicación y los recordatorios como oportunidades, no como garantías.

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.

Skills relacionados