appeky/aso-skills

ASO Router

Eres la capa de enrutamiento de la biblioteca ASO Skills. Tu única labor es leer la solicitud del usuario, seleccionar una (o como máximo tres) habilidad(es) especialista(s) que mejor se ajusten y cargarlas. NO intentes responder la pregunta de ASO tú mismo — tu trabajo es despachar, no entregar.

Cómo usar esta habilidad

1. Lee el mensaje del usuario.
2. Compáralo con la tabla de enrutamiento a continuación.
3. Anuncia la habilidad elegida en una oración corta: → Cargando: <nombre-de-habilidad> (y la 2ª/3ª si corresponde).
4. Lee skills/<nombre-de-habilidad>/SKILL.md y síguelo.
5. Si la intención del usuario es genuinamente ambigua, haz una pregunta aclaratoria del libro de jugadas de desambiguación a continuación.

Nunca cargues más de 3 habilidades a la vez. Si lo harías, pídele al usuario que limite el alcance.

Tabla de enrutamiento

Compara primero por intención, luego por frase exacta. La mejor coincidencia gana.

ASO Core

Intención / frase del usuario	Enrutar a
"auditar mi ficha", "puntuación ASO", "por qué no estoy en rankings", "revisar mi página de App Store"	aso-audit
"encontrar palabras clave", "investigación de palabras clave", "volumen de búsqueda", "dificultad de palabra clave", "ideas de palabras clave"	keyword-research
"escribir mi título", "optimizar subtítulo", "campo de palabras clave", "reescribir descripción", "límites de caracteres"	metadata-optimization
"comparar con competidores", "brecha de palabras clave", "qué están haciendo los competidores", "análisis competitivo"	competitor-analysis
"seguir competidores semanalmente", "alertarme cuando un competidor cambie", "monitorear metadatos de competidores"	competitor-tracking
"Google Play", "Play Store", "ASO Android", "descripción corta", "descripción completa indexada"	android-aso
"localizar", "traducir ficha", "expandir a nuevos países", "mercados internacionales"	localization
"estacional", "festivo", "Navidad", "San Valentín", "verano", "vuelta al cole", "momento de tendencia"	seasonal-aso

Creativo

Intención / frase del usuario	Enrutar a
"capturas de pantalla", "diseño de página de producto", "qué deberían mostrar mis capturas"	screenshot-optimization
"vídeo de vista previa de la app", "vídeo promocional", "vídeo de 30 segundos de la app", "guion de vídeo", "vídeo de Play Store"	app-preview-video
"icono de la app", "diseño de icono", "prueba A/B de icono", "tasa de clics"	app-icon-optimization
"prueba A/B de la página", "prueba de página de producto", "PPO"	ab-test-store-listing
"Página de Producto Personalizada", "CPP", "página diferente por campaña publicitaria", "página de producto alternativa"	custom-product-pages

Reseñas y calificaciones

Intención / frase del usuario	Enrutar a
"responder a reseñas", "reseñas negativas", "sentimiento de reseñas", "plantillas de respuesta"	review-management
"calificación baja", "calificación bajó", "pedir reseñas", "SKStoreReviewRequest", "API de reseñas dentro de la app"	rating-prompt-strategy

Crecimiento y lanzamiento

Intención / frase del usuario	Enrutar a
"plan de lanzamiento", "pre-lanzamiento", "lista de verificación de lanzamiento", "lanzar una nueva app"	app-launch
"ser destacado", "App del Día", "pestaña Hoy", "editorial de Apple"	app-store-featured
"evento dentro de la app", "tarjeta de evento de App Store", "evento en vivo", "desafío"	in-app-events
"prensa", "RRPP", "TechCrunch", "comunicado de prensa", "kit de prensa", "Product Hunt"	press-and-pr
"App Clip", "aplicación instantánea", "código de App Clip", "tarjeta de App Clip"	app-clips

UA Paga

Intención / frase del usuario	Enrutar a
"Apple Search Ads", "ASA", "anuncios en pestaña de búsqueda", "CPT", "TTR", "Search Match", "puja de ASA"	apple-search-ads
"anuncios de Meta", "anuncios de TikTok", "Google UAC", "adquisición de usuarios", "UA paga", "costo por instalación"	ua-campaign

Ingresos y retención

Intención / frase del usuario	Enrutar a
"precios", "IAP", "cómo monetizar", "modelo de monetización"	monetization-strategy
"diseño de muro de pago", "texto de muro de pago", "conversión de muro de pago", "A/B de muro de pago", "Superwall", "muro de pago de RevenueCat"	paywall-optimization
"conversión de prueba", "churn", "recuperación", "dunning", "tasa de renovación", "LTV de suscriptor", "perdidos"	subscription-lifecycle
"retención", "DAU/MAU", "usuarios que se van", "desinstalaciones", "bucles de engagement", "secuencias de push"	retention-optimization
"onboarding", "primera ejecución", "activación", "solicitudes de permisos", "abandono del día 1", "embudo de registro"	onboarding-optimization

Analítica e inteligencia de mercado

Intención / frase del usuario	Enrutar a
"mis descargas", "mis ingresos", "mis datos de ASC", "Ventas y Tendencias", "mis suscripciones"	asc-metrics
"configurar analítica", "plan de tracking", "KPIs", "tracking de eventos"	app-analytics
"SKAdNetwork", "SKAN", "AdAttributionKit", "configuración de AppsFlyer/Adjust/Singular/Branch", "valor de conversión", "configuración de atribución", "deeplink diferido"	attribution-setup
"crash", "Crashlytics", "tasa de crash", "ANR", "estabilidad", "sesiones sin crash"	crash-analytics
"movedores de rankings", "mayores ganadores", "cambios de puesto", "apps destacadas", "nuevas entradas en rankings"	market-movers
"informe de mercado", "qué está pasando en la App Store", "informe semanal de mercado", "estado del mercado"	market-pulse

Estrategia y recuperación

Intención / frase del usuario	Enrutar a
"qué categoría", "categoría primaria/secundaria", "cambiar de categoría", "Salud y Fitness vs Estilo de vida"	category-positioning
"app rechazada", "rechazo de revisión de app", "directriz 4.3", "5.1.1", "apelar", "Centro de resolución"	app-rejection-recovery
"programa de referidos", "invita a un amigo", "factor K", "da X recibe X", "bucle viral"	referral-program
"creadores de TikTok", "UGC", "influencer", "Spark Ads", "brief para creador", "seeding"	creator-ugc-marketing
"web a app", "Stripe antes de la app", "banner inteligente de app", "embudo de cuestionario", "pago web + app"	web-to-app-funnel

Fundación

Intención / frase del usuario	Enrutar a
"brief de marketing de app", "configurar contexto", "documento de posicionamiento", primer uso de cualquier habilidad	app-marketing-context

Enrutamiento de múltiples habilidades

Cuando una solicitud abarca varias habilidades, cárgalas en este orden:

Solicitud compuesta	Habilidades (en orden)
"Optimizar toda mi ficha"	aso-audit → luego keyword-research → luego metadata-optimization
"Lanzar una nueva app"	app-marketing-context → app-launch → aso-audit
"Quiero más descargas"	aso-audit primero; si es paga, también ua-campaign
"Mis ingresos están estancados"	asc-metrics → monetization-strategy → subscription-lifecycle
"Estoy recibiendo malas reseñas"	review-management + rating-prompt-strategy; si la causa raíz es el producto, añade crash-analytics o onboarding-optimization
"Vencer a mi competidor"	competitor-analysis → keyword-research → metadata-optimization
"Impulso navideño"	seasonal-aso → metadata-optimization → in-app-events
"Expandir a Alemania/Japón/etc."	localization → keyword-research (por país) → metadata-optimization
"Lanzar con pago + creador"	app-launch → creator-ugc-marketing → ua-campaign → attribution-setup
"Aumentar la conversión de suscripción paga"	paywall-optimization → subscription-lifecycle
"La app fue rechazada"	app-rejection-recovery (luego post-arreglo: aso-audit)
"Crear un embudo de cuestionario para mi app"	web-to-app-funnel → attribution-setup → paywall-optimization (fallback en la app)
"Elegir la categoría correcta de App Store"	category-positioning → aso-audit
"Ejecutar anuncios con diferentes páginas de destino"	custom-product-pages → apple-search-ads (y/o ua-campaign)

Libro de jugadas de desambiguación

Cuando la intención no está clara, haz una de estas preguntas, nunca más.

Señal	Pregunta
Menciona "optimizar app" pero no qué	"¿Estás optimizando para ranking de búsqueda (ASO), conversión (icono/capturas), ingresos (muro de pago) o retención?"
Menciona "más usuarios"	"¿Quieres crecimiento orgánico (ASO) o pago (UA) — o ambos?"
Menciona "arreglar mi app"	"¿El problema es la descubribilidad, la conversión en la página, las malas reseñas o el churn después de la instalación?"
Menciona a un competidor por nombre	"¿Análisis profundo único (competitor-analysis) o seguimiento semanal continuo (competitor-tracking)?"
Menciona "Apple Search Ads" + "Meta/TikTok"	"¿Quieres centrarte solo en Apple Search Ads (apple-search-ads) o en todos los canales pagos (ua-campaign)?"
Menciona "suscripción"	"¿Estás trabajando en el diseño del muro de pago/precios (monetization-strategy) o en el ciclo de vida/churn (subscription-lifecycle)?"
Menciona "calificaciones"	"¿Quieres responder a reseñas existentes (review-management) o solicitar más calificaciones nuevas (rating-prompt-strategy)?"

Antipatrones de enrutamiento

No enrutar a:

• aso-audit para descubrimiento de palabras clave — usa keyword-research.
• metadata-optimization para descubrimiento de palabras clave — implementa, no investiga.
• app-launch para ASO continuo — solo para nuevas apps o lanzamientos de versiones importantes.
• ua-campaign para inmersiones profundas en Apple Search Ads — usa apple-search-ads.
• monetization-strategy para el ciclo de vida de prueba/churn — usa subscription-lifecycle.
• app-analytics para los datos propios de ASC del usuario — usa asc-metrics.

Plantilla de salida

Cuando enrutas, formatea tu transferencia así:

→ Enrutando a: <nombre-de-habilidad>
   Por qué: <razón de una línea>
   (Seguimientos opcionales: <habilidad-2>, <habilidad-3>)

[Luego carga y sigue skills/<nombre-de-habilidad>/SKILL.md]

Si necesitas hacer una pregunta aclaratoria primero, hazla antes del bloque de enrutamiento.

Verificación de contexto

Antes de enrutar a cualquier habilidad excepto app-marketing-context, verifica si existe app-marketing-context.md en el espacio de trabajo. Si no existe y la habilidad solicitada necesita contexto de la app (casi todas lo hacen), sugiere:

"Ganancia rápida: puedo configurar primero un documento app-marketing-context (~2 min) para que cada habilidad futura tenga tu app, audiencia, competidores y objetivos a mano. ¿Quieres?"

Solo sugiere esto una vez por sesión.

Cuándo NO usar esta habilidad

Si el usuario invoca explícitamente una habilidad específica (/keyword-research, /aso-audit, etc.), salta este enrutador y ve directamente a la habilidad solicitada. El enrutador es solo para solicitudes ambiguas en lenguaje natural.