Communitygithub.com

exiao/skills

Traduce de forma masiva los nombres visibles de suscripciones y compras integradas en todos los idiomas de la App Store usando asc. Úsalo cuando quieras rellenar nombres de suscripción/IAP para cada idioma sin tener que hacer clic manualmente en App Store Connect.

¿Qué es skills?

Esta habilidad permite a los desarrolladores automatizar la tediosa tarea de localizar nombres de suscripciones, grupos de suscripciones y compras integradas (IAP) en todos los idiomas soportados por App Store Connect mediante la herramienta de línea de comandos `asc`. En lugar de tener que navegar manualmente por cada idioma en la interfaz web de App Store Connect para configurar el mismo nombre, el agente puede ejecutar comandos bulk para crear o actualizar localizaciones de forma masiva. Soporta más de 35 locales, incluyendo variantes regionales como `en-AU`, `es-MX`, `fr-CA` y `zh-Hant`. El flujo de trabajo típico consiste en listar las localizaciones existentes para evitar duplicados, luego crear las faltantes con un solo nombre o nombres específicos por idioma, y finalmente verificar los resultados. La habilidad es compatible con `asc` y se integra naturalmente con el `asc-id-resolver` para trabajar con nombres de aplicaciones en lugar de IDs. Es ideal para equipos que lanzan aplicaciones globales y necesitan mantener consistencia en los nombres de sus productos dentro de la App Store sin esfuerzo manual repetitivo.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/exiao/skills/tree/HEAD/app-store/app-store-connect/subscription-localization

Preguntar en tu IA favorita

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

Documentación

Localización de suscripciones asc

Usa esta habilidad para crear o actualizar de forma masiva los nombres visibles (y descripciones) de suscripciones, grupos de suscripciones y compras integradas en todos los idiomas de App Store Connect. Esto elimina el tedioso proceso manual de hacer clic en cada idioma en App Store Connect para establecer el mismo nombre visible.

Precondiciones

  • Autenticación configurada (asc auth login o variables de entorno ASC_*).
  • Conocer el ID de tu aplicación (ASC_APP_ID o --app).
  • Los grupos de suscripciones y las suscripciones ya deben existir.

Idiomas admitidos en App Store

Estos son los idiomas que App Store Connect soporta para las localizaciones de suscripciones e IAP:

ar-SA, ca, cs, da, de-DE, el, en-AU, en-CA, en-GB, en-US,
es-ES, es-MX, fi, fr-CA, fr-FR, he, hi, hr, hu, id, it,
ja, ko, ms, nl-NL, no, pl, pt-BR, pt-PT, ro, ru, sk,
sv, th, tr, uk, vi, zh-Hans, zh-Hant

Flujo de trabajo: Localización masiva de una suscripción

1. Resolver IDs

# Encontrar grupos de suscripciones
asc subscriptions groups list --app "APP_ID" --output table

# Encontrar suscripciones dentro de un grupo
asc subscriptions list --group "GROUP_ID" --output table

2. Verificar localizaciones existentes

asc subscriptions localizations list --subscription-id "SUB_ID" --paginate --output table

Esto muestra qué idiomas ya tienen un nombre establecido. Solo crea localizaciones para los idiomas que faltan.

3. Crear localizaciones para todos los idiomas faltantes

Para cada idioma que aún no tenga una localización, ejecuta:

asc subscriptions localizations create \
  --subscription-id "SUB_ID" \
  --locale "LOCALE" \
  --name "Nombre visible"

Por ejemplo, para establecer "Mensual Pro" en todos los idiomas:

# Un comando por idioma (salta los que ya existan)
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ar-SA" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ca" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "cs" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "da" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "de-DE" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "el" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "en-AU" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "en-CA" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "en-GB" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "es-ES" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "es-MX" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "fi" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "fr-CA" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "fr-FR" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "he" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "hi" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "hr" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "hu" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "id" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "it" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ja" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ko" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ms" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "nl-NL" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "no" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "pl" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "pt-BR" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "pt-PT" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ro" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ru" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "sk" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "sv" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "th" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "tr" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "uk" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "vi" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "zh-Hans" --name "Mensual Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "zh-Hant" --name "Mensual Pro"

4. Verificar

asc subscriptions localizations list --subscription-id "SUB_ID" --paginate --output table

Flujo de trabajo: Localización masiva de un grupo de suscripciones

Los grupos de suscripciones también tienen su propio nombre visible por idioma (este es el "nombre del grupo" que se muestra a los usuarios en la hoja de gestión de suscripciones).

1. Verificar localizaciones existentes del grupo

asc subscriptions groups localizations list --group-id "GROUP_ID" --paginate --output table

2. Crear para los idiomas faltantes

asc subscriptions groups localizations create \
  --group-id "GROUP_ID" \
  --locale "LOCALE" \
  --name "Nombre visible del grupo"

Opcional: establecer un nombre de aplicación personalizado para el grupo:

asc subscriptions groups localizations create \
  --group-id "GROUP_ID" \
  --locale "LOCALE" \
  --name "Nombre visible del grupo" \
  --custom-app-name "Mi App"

3. Verificar

asc subscriptions groups localizations list --group-id "GROUP_ID" --paginate --output table

Flujo de trabajo: Localización masiva de una compra integrada (IAP)

Las compras integradas tienen sus propios comandos de localización con el mismo patrón.

1. Resolver ID de IAP

asc iap list --app "APP_ID" --output table

2. Verificar localizaciones existentes

asc iap localizations list --iap-id "IAP_ID" --paginate --output table

3. Crear para los idiomas faltantes

asc iap localizations create \
  --iap-id "IAP_ID" \
  --locale "LOCALE" \
  --name "Nombre visible"

Descripción opcional:

asc iap localizations create \
  --iap-id "IAP_ID" \
  --locale "LOCALE" \
  --name "Desbloquear todas las funciones" \
  --description "Compra única para desbloquear todas las funciones premium"

4. Verificar

asc iap localizations list --iap-id "IAP_ID" --paginate --output table

Actualizar localizaciones existentes

Para cambiar el nombre visible de localizaciones existentes:

Suscripciones

asc subscriptions localizations update --id "LOC_ID" --name "Nuevo nombre"

Grupos de suscripciones

asc subscriptions groups localizations update --id "LOC_ID" --name "Nuevo nombre del grupo"

Compras integradas

asc iap localizations update --id "LOC_ID" --name "Nuevo nombre"

Para actualizar de forma masiva, primero lista las localizaciones existentes, extrae los IDs y luego actualiza cada uno.

Localización masiva de todas las suscripciones en una aplicación

Para una aplicación completa con múltiples grupos de suscripciones y suscripciones:

# 1. Listar todos los grupos
asc subscriptions groups list --app "APP_ID" --paginate

# 2. Para cada grupo, localizar el propio grupo
#    (repetir el flujo de trabajo de localización de grupos anterior)

# 3. Para cada grupo, listar suscripciones
asc subscriptions list --group "GROUP_ID" --paginate

# 4. Para cada suscripción, localizarla
#    (repetir el flujo de trabajo de localización de suscripciones anterior)

Comportamiento del agente

  • Siempre lista primero las localizaciones existentes para evitar errores de creación duplicados.
  • Omite los idiomas que ya tienen una localización; solo crea las que faltan.
  • Cuando el usuario proporciona un único nombre visible, úsalo para todos los idiomas (mismo nombre en todas partes).
  • Cuando el usuario proporciona nombres traducidos por idioma, usa el nombre específico del idioma para cada uno.
  • Si se proporciona una descripción, pasa --description al crear. En caso contrario, omítelo.
  • Usa --output table para los pasos de verificación, para que el usuario pueda confirmar visualmente.
  • Usa la salida JSON predeterminada para pasos de automatización intermedios.
  • Después de la creación masiva, siempre ejecuta el comando list para verificar la integridad.
  • Para aplicaciones con muchas suscripciones, procésalas secuencialmente por grupo para mantener la salida legible.
  • Si una llamada de creación falla para un idioma, registra el idioma y el error, luego continúa con los idiomas restantes. Después de que el lote se complete, informa todos los fallos juntos para que el usuario pueda solucionarlos.

Notas

  • Los nombres visibles de las suscripciones son lo que los usuarios ven en la hoja de gestión de suscripciones y en los diálogos de compra.
  • Crear una localización para un idioma que ya existe fallará; siempre verifica primero.
  • No existe una API masiva; cada idioma requiere una llamada de creación separada.
  • Usa --paginate en los comandos list para asegurar que se devuelvan todas las localizaciones existentes.
  • Usa la habilidad asc-id-resolver si solo tienes nombres de aplicaciones en lugar de IDs.

Individual skills in this repo

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

Skills relacionados