Communitygithub.com

asodevapp/skills

Úsalo cuando el usuario quiera escribir, reescribir, optimizar, comparar, validar o rellenar en lotes metadatos de Apple App Store o Google Play en ASO.dev: título, subtítulo, campo de palabras clave, descripción, texto promocional, descripción corta, descripción larga o Novedades.

¿Qué es skills?

Esta habilidad de ASO.dev está diseñada para que agentes de IA (como Claude Code, Cursor, Codex, etc.) puedan optimizar metadatos de tiendas de aplicaciones de forma profesional y conforme a las plataformas. Su flujo de trabajo guía al agente desde la obtención de metadatos actuales hasta la validación y el rellenado masivo, utilizando herramientas como `current-metadata-fetch`, `keyword-research` y `bulk_fill` (para Apple) o `bulk_fill_google` (para Google Play). El agente debe respetar una estricta puerta de calidad: los campos recomendados deben estar listos para copiar y pegar, sin marcadores de posición ni corchetes sin resolver, respetando los límites de caracteres y las reglas específicas de cada plataforma. Además, se integra con el editor contextual de ASO.dev, aprovechando datos reales del editor inteligente, editor masivo y el historial de versiones para evitar suposiciones. Finalmente, la habilidad proporciona estructuras de salida detalladas (paquete de optimización, diagnóstico, matriz de cobertura de palabras clave, antes/después y validación) y define el formato exacto del payload para el rellenado de metadatos de Apple.

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

Preguntar en tu IA favorita

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

Documentación

Optimización de Metadatos

Escribe metadatos para App Store y Google Play que equilibren visibilidad en búsqueda, conversión, claridad y cumplimiento.

Flujo de trabajo

  1. Usa current-metadata-fetch para leer los valores actuales.
  2. Usa get_project_context si el posicionamiento, tono, audiencia o afirmaciones prohibidas son relevantes.
  3. Identifica la plataforma, país, configuración regional, palabras clave objetivo y tipo de página: listing predeterminado, metadatos de versión, borrador de CPP/PPO o listing de Google.
  4. Si faltan palabras clave objetivo, usa primero keyword-research; usa keyword-coverage para distribuir las palabras clave seleccionadas.
  5. Redacta solo las configuraciones regionales y campos solicitados.
  6. Valida con validate_ai_companion_data usando appMetadata o googleMetadata.
  7. Si el usuario solicitó aplicar/rellenar, usa bulk_fill o bulk_fill_google.

Puerta de calidad

  • Los campos recomendados deben estar listos para copiar y pegar: sin marcadores de posición, sin corchetes sin resolver, conteos exactos de caracteres y límites específicos de la plataforma respetados.
  • Si faltan el posicionamiento de la app, la audiencia, la monetización, las pruebas, las URL de soporte o las palabras clave objetivo, pregunta o marca la carencia en el análisis; no lo inventes dentro de los metadatos finales.
  • Proporciona alternativas para campos de alto impacto, pero etiqueta claramente una opción recomendada.
  • Trata los pasos de implementación por separado del texto de metadatos para que el usuario pueda pegar los campos sin necesidad de limpieza adicional.

Contexto del editor de ASO.dev

Cuando los datos del editor de ASO.dev estén disponibles, úsalos en lugar de adivinar:

  • Editor inteligente de metadatos: valores actuales, comprobaciones de longitud, vista previa, reutilización/deshacer de versiones anteriores, importación/exportación, Fastlane, guardado directo en App Store Connect y contexto de envío de revisión.
  • Editor masivo: todas las localizaciones, detección de duplicados, copia de versiones anteriores, estado de traducción con IA/Google/DeepL.
  • Localización cruzada: cobertura de título/subtítulo/palabra clave por combinación de país-localización.
  • Cronología/Registro de cambios: metadatos anteriores e historial de versiones para comparaciones antes/después.
  • Flujo de trabajo de versiones: la versión de la app, el tipo de versión, la selección de compilación, la clasificación por edad, las notificaciones del servidor, la localización principal y el estado de agregación/eliminación de localizaciones pueden afectar lo que es seguro redactar o rellenar.

Límites de la plataforma

Apple App Store

CampoLímiteRol en la búsqueda
title30Indexado, mayor peso
subtitle30Indexado
keywords100 caracteres unidosIndexado, oculto
promotionalText170Conversión, no indexado, puede cambiar sin versión de la app
description4000Conversión, no indexado por la búsqueda de App Store
whatsNew4000Comunicación de actualización

Google Play

CampoLímiteRol en la búsqueda
title30Indexado
shortDescription80Indexado y visible
fullDescription4000Indexado y conversión

Marco de optimización

Título

  • Incluye la palabra clave objetivo más fuerte de forma natural cuando sea posible.
  • Lidera con la marca solo cuando sea una marca conocida con demanda de búsqueda significativa o valor de confianza.
  • Para apps menos conocidas, lidera con la palabra clave funcional/intención más importante y coloca la marca al final cuando aún sea necesaria su inclusión; esto ayuda a que las sugerencias de App Store y las frases se formen a partir de palabras clave de mayor prioridad primero.
  • Mantenlo legible en los resultados de búsqueda.
  • Evita desperdiciar caracteres en marcas legales a menos que sea obligatorio.
  • Proporciona 3 opciones al optimizar un título.

Estructuras buenas:

  • Palabra clave primaria: Frase de beneficio
  • Palabra clave primaria - Intención secundaria
  • Palabra clave primaria de Marca
  • Marca conocida: Palabra clave primaria

Subtítulo de Apple

  • Agrega palabras clave secundarias y lenguaje de beneficio.
  • No repitas palabras de palabras clave del título a menos que haya una razón estratégica clara.
  • Hazlo amigable para la conversión, no solo una lista de palabras clave.
  • Proporciona 3 opciones al optimizar un subtítulo.

Campo de palabras clave de Apple

  • Separado por comas sin espacios.
  • Trátalo internamente como un arreglo para los payloads de MCP.
  • No repitas palabras ya incluidas en título/subtítulo a menos que sea deliberado.
  • Prefiere formas singulares a menos que los datos respalden el plural.
  • No incluyas el nombre de la app, marcas de la competencia, app o free.
  • Prioriza primero por relevancia, luego por popularidad/oportunidad.

Descripción de Apple

  • La búsqueda de App Store no la indexa; escribe principalmente para conversión.
  • Las primeras 2-3 líneas deben comunicar el beneficio principal para el usuario antes de que toque "más".
  • Usa beneficios antes que listas de características.
  • Incluye solo pruebas reales: calificaciones, premios, prensa, números de uso o testimonios que el usuario proporcione.
  • No agregues emojis a menos que el tono de la marca lo respalde.

Estructura sugerida:

  1. Gancho
  2. Beneficios principales
  3. Características clave
  4. Cómo funciona
  5. Confianza/pruebas
  6. Llamada a la acción

Descripción de Google

  • Equilibra conversión y cobertura natural de palabras clave.
  • Carga los términos más relevantes al inicio del primer párrafo; los primeros ~250 caracteres deben funcionar por sí solos antes de expandirse.
  • Usa variantes y sinónimos; no hagas keyword-stuffing.
  • Usa viñetas y saltos de línea para facilitar la lectura.
  • Mantén una densidad natural y legible.

Texto promocional

Úsalo para mensajes oportunos:

  • lanzamientos de funciones
  • campañas estacionales
  • Eventos dentro de la app
  • contenido por tiempo limitado
  • premios o hitos reales

No codifiques precios, fechas, descuentos o disponibilidad a menos que los datos actuales o el usuario los confirmen.

Reglas de Apple

  • Las palabras clave de Apple deben estar separadas por comas sin espacios.
  • Evita palabras clave duplicadas en título, subtítulo y palabras clave a menos que sea deliberado.
  • No agregues marcas comerciales de la competencia ni afirmaciones no respaldadas.
  • No cambies URLs, texto de privacidad ni texto legal a menos que se solicite explícitamente.
  • Señala ganchos débiles como "Bienvenido a..." o afirmaciones genéricas de "mejor app para...".
  • Señala el presupuesto de caracteres no utilizado solo cuando agregar caracteres mejore la relevancia o conversión.

Salida

# Paquete de Optimización de Metadatos

App:
Plataforma:
País:
Configuraciones regionales:
Palabras clave objetivo:

## Diagnóstico
| Configuración regional | Campo | Problema | Solución |
|---|---|---|---|

## Metadatos recomendados
### código-localización
| Campo | Recomendado | Caracteres | Palabras clave cubiertas | Justificación |
|---|---:|---|---|

## Alternativas
| Campo | Opción | Texto | Caracteres | Enfoque |
|---|---|---:|---|

## Matriz de cobertura de palabras clave
| Palabra clave | Título | Subtítulo/descripción corta | Campo de palabras clave | Descripción | Notas |
|---|---|---|---|---|---|

## Antes/después
| Campo | Actual | Recomendado | Mejora |
|---|---|---|---|

## Validación
- Límites de caracteres:
- Duplicación de palabras clave:
- Fuente de investigación de palabras clave:
- Afirmaciones no respaldadas:
- URLs/privacidad/legal sin cambios:
- Validación MCP:
- Listo para `bulk_fill`:

Regla de payload de rellenado

Al rellenar metadatos de Apple, envía:

{
  "locales": ["en-US"],
  "fields": ["title", "subtitle", "keywords"],
  "data": {
    "en-US": {
      "title": "...",
      "subtitle": "...",
      "keywords": ["keyword", "keyword2"]
    }
  }
}

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 when the user wants to create, plan, audit, optimize, localize, or fill App Store In-App Events in ASO.dev: event cards for Today/Games/Apps tabs, search, product pages, re-engagement, challenges, competitions, live events, premieres, seasons, major updates, and special events.

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 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