Communitygithub.com

asc localize metadata

Utilisez cette compétence pour extraire les métadonnées App Store en anglais (ou toute autre langue source), les traduire via LLM et les repousser automatiquement dans App Store Connect.

Qu'est-ce que asc localize metadata ?

Cette compétence automatise le processus de localisation des métadonnées App Store. Elle permet de télécharger les métadonnées existantes (descriptions, mots-clés, notes de version, etc.) depuis App Store Connect, de les traduire à l'aide d'un modèle de langage (LLM) en respectant les contraintes formelles de ton et de registre, puis de téléverser ces traductions dans App Store Connect pour chaque marché cible. Elle prend en charge à la fois les localisations liées aux versions (description, keywords, whatsNew, promotionalText... via `asc localizations download/upload --version`) et les localisations au niveau de l'application (nom, sous-titre, URL de politique de confidentialité... via `--type app-info`). L'assistant IA guide l'utilisateur tout au long du processus : résolution des identifiants (app, version, app-info), respect des limites de caractères, validation des traductions avant téléversement, et gestion des erreurs par locale. Idéale pour les développeurs et ASO managers souhaitant industrialiser la traduction de leurs fiches App Store.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/rudrankriyam/app-store-connect-cli-skills/asc-localize-metadata

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait asc localize metadata ?

Utilisez cette compétence pour extraire les métadonnées App Store en anglais (ou toute autre langue source), les traduire via LLM et les repousser automatiquement dans App Store Connect.

Découverte des commandes et conventions de sortie

  • Confirmez toujours les options avec --help pour la version exacte de asc :
    • asc localizations --help
    • asc localizations download --help
    • asc localizations upload --help
    • asc apps info edit --help
  • Privilégiez les options longues explicites (--app, --version, --version-id, --type, --app-info).
  • La sortie par défaut est JSON ; utilisez --output table uniquement pour les étapes de vérification humaine.
  • Privilégiez les opérations basées sur des identifiants déterministes. Ne « sélectionnez pas la première ligne » via head -1 sauf accord explicite de l'utilisateur.

Prérequis

  • Authentification configurée (asc auth login ou variables d'environnement ASC_*)
  • Connaître l'identifiant de votre application (asc apps list pour le trouver)
  • Au moins une locale (généralement en-US) possède déjà des métadonnées dans App Store Connect

Locales prises en charge

Locales App Store Connect pour les localisations de version et d'informations de l'application :

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

Deux types de métadonnées

Localisations de version (par version)

Champs : description, keywords, whatsNew, supportUrl, marketingUrl, promotionalText

Localisations des informations de l'application (niveau application, persistantes)

Champs : name, subtitle, privacyPolicyUrl, privacyChoicesUrl, privacyPolicyText

Workflow

Étape 1 : Résoudre les identifiants

# Trouver l'identifiant de l'application
asc apps list --output table

# Trouver l'identifiant de la dernière version
asc versions list --app "APP_ID" --state READY_FOR_DISTRIBUTION --output table
# ou pour une version modifiable :
asc versions list --app "APP_ID" --state PREPARE_FOR_SUBMISSION --output table

# Trouver l'identifiant des infos de l'application (pour les champs de niveau app comme nom/sous-titre)
asc apps info list --app "APP_ID" --output table

Remarques :

  • Les champs de localisation de version (description, keywords, whatsNew, etc.) sont liés à une version spécifique.
  • Les champs d'informations de l'application (nom, sous-titre, URL de confidentialité/texte) sont au niveau de l'application et utilisent --type app-info.
  • Si vous ne disposez que de noms (nom de l'app, numéro de version) et avez besoin des identifiants de manière déterministe, utilisez asc-id-resolver.

Étape 2 : Télécharger la locale source

# Télécharger les localisations de version dans des fichiers .strings locaux
# (description, keywords, whatsNew, promotionalText, supportUrl, marketingUrl, ...)
asc localizations download --version "VERSION_ID" --path "./localizations"

# Télécharger les localisations des infos de l'application dans des fichiers .strings locaux
# (name, subtitle, privacyPolicyUrl, privacyChoicesUrl, privacyPolicyText, ...)
asc localizations download --app "APP_ID" --type app-info --app-info "APP_INFO_ID" --path "./app-info-localizations"

Cela crée des fichiers comme ./localizations/en-US.strings et ./app-info-localizations/en-US.strings. Si le téléchargement est indisponible, lisez les champs individuellement :

# Lister les localisations de version pour voir les locales existantes et leur contenu
asc localizations list --version "VERSION_ID" --output table

Étape 3 : Traduire avec LLM

Pour chaque locale cible, traduisez le texte source. Suivez ces règles :

Consignes de traduction

  • Ton et registre : Utilisez toujours un langage formel et poli. Utilisez les formes de vouvoiement là où la langue les distingue (russe : «вы», allemand : «Sie», français : «vous», espagnol : «usted», néerlandais : «u», italien : «Lei», portugais : «você» formel, etc.). Les descriptions App Store sont des textes marketing professionnels — n'utilisez jamais un registre décontracté ou informel.
  • description : Traduisez naturellement, adaptez le ton au marché local. Conservez la mise en forme (sauts de ligne, puces, émojis). Restez sous 4000 caractères.
  • keywords : Ne traduisez PAS littéralement. Recherchez ce que les utilisateurs de cette locale rechercheraient. Séparés par des virgules, max 100 caractères au total. Pas de doublons, pas de nom d'app (Apple l'ajoute automatiquement).
  • whatsNew : Traduisez les notes de version. Restez concis. Max 4000 caractères.
  • promotionalText : Traduisez l'accroche marketing. Max 170 caractères. Peut être mis à jour sans nouvelle version.
  • subtitle : Traduisez ou adaptez le slogan. Max 30 caractères — c'est très limité, une adaptation créative peut être nécessaire.
  • name : Conservez généralement le nom original de l'application. Ne traduisez que si l'utilisateur le demande explicitement. Max 30 caractères.

Modèle de prompt de traduction LLM

Pour chaque locale cible, utilisez cette approche :

Traduisez les métadonnées App Store suivantes de {source_locale} vers {target_locale}.

Règles :
- description : Traduction naturelle et fluide. Conservez la mise en forme (sauts de ligne, puces, émojis). Max 4000 caractères.
- keywords : Ne traduisez PAS littéralement. Choisissez des mots-clés que les locuteurs natifs rechercheraient dans l'App Store. Séparés par des virgules, max 100 caractères au total. N'incluez pas le nom de l'application.
- whatsNew : Traduisez les notes de version naturellement. Max 4000 caractères.
- promotionalText : Traduisez l'accroche marketing. Max 170 caractères.
- subtitle : Adaptez le slogan de manière créative pour tenir dans 30 caractères max.
- name : Conservez le nom original de l'application sauf demande explicite de traduction. Max 30 caractères.
- Utilisez un langage formel et poli ainsi que les formes de vouvoiement (russe : вы, allemand : Sie, français : vous, espagnol : usted, néerlandais : u, etc.). Le texte App Store est une communication marketing professionnelle — n'utilisez jamais un registre informel.
- Respectez le contexte culturel. Un ton ludique en anglais peut nécessiter un ajustement pour les marchés formels (par exemple, ja, de-DE).

Source ({source_locale}) :
description : """
{description}
"""

keywords : {keywords}

whatsNew : """
{whatsNew}
"""

promotionalText : {promotionalText}

name : {name}

subtitle : {subtitle}

Étape 4 : Téléverser les traductions

Option A : Via les fichiers .strings (en masse)

Créez un fichier .strings par locale dans le répertoire approprié.

Exemple de localisation de version :

// nl-NL.strings
"description" = "Je app-beschrijving hier";
"keywords" = "wiskunde,kinderen,tafels,leren";
"whatsNew" = "Bugfixes en verbeteringen";
"promotionalText" = "Leer de tafels van vermenigvuldiging!";

Ensuite, téléversez les localisations de version :

asc localizations upload --version "VERSION_ID" --path "./localizations"

Exemple de localisation des infos de l'application :

// nl-NL.strings
"subtitle" = "Leer tafels spelenderwijs";

Ensuite, téléversez les localisations des infos de l'application :

asc localizations upload --app "APP_ID" --type app-info --app-info "APP_INFO_ID" --path "./app-info-localizations"

Option B : Via des commandes individuelles (contrôle fin)

# Champs de localisation de version (contrôle fin).
# Privilégiez le passage explicite de l'ID de version pour le déterminisme.
asc apps info edit --app "APP_ID" --version-id "VERSION_ID" --locale "nl-NL" \
  --description "Je beschrijving..." \
  --keywords "wiskunde,kinderen,tafels" \
  --whats-new "Bugfixes en verbeteringen"

Pour les champs au niveau de l'application :

# Le sous-titre/le nom (localisation des infos de l'application) est géré via les localisations des infos de l'application.
# Utilisez le flux .strings + téléversement des localisations des infos de l'application (il n'y a pas de commande `asc app-infos localizations ...`).
#
# 1) Modifiez : ./app-info-localizations/nl-NL.strings
# "subtitle" = "Leer tafels spelenderwijs";
#
# 2) Téléversez :
asc localizations upload --app "APP_ID" --type app-info --app-info "APP_INFO_ID" --path "./app-info-localizations"

Étape 5 : Vérifier

# Vérifier que toutes les locales sont présentes
asc localizations list --version "VERSION_ID" --output table

# Vérifier les localisations des infos de l'application
asc localizations list --app "APP_ID" --type app-info --app-info "APP_INFO_ID" --output table

Limites de caractères (à vérifier avant téléversement !)

ChampLimite
Nom (name)30
Sous-titre (subtitle)30
Mots-clés (keywords)100 (séparés par des virgules)
Description4000
Notes de version (whatsNew)4000
Texte promotionnel (promotionalText)170

Validez toujours que le texte traduit respecte les limites avant de téléverser. Un texte tronqué donne un aspect non professionnel. Si la traduction dépasse la limite, raccourcissez-la — ne tronquez pas au milieu d'une phrase.

Exemple complet : Ajouter nl-NL et ru à Roxy Math

# 1) Résoudre les identifiants de manière déterministe (ne pas sélectionner automatiquement la « première » ligne)
# Si vous ne disposez que de noms, utilisez la compétence asc-id-resolver.
asc apps list --output table
APP_ID="ID_DE_L_APP"

asc versions list --app "$APP_ID" --state PREPARE_FOR_SUBMISSION --output table
VERSION_ID="ID_DE_LA_VERSION"

asc apps info list --app "$APP_ID" --output table
APP_INFO_ID="ID_DES_INFOS_APP"

# 2) Télécharger la source anglaise (ou votre locale source choisie)
asc localizations download --version "$VERSION_ID" --path "./localizations"
asc localizations download --app "$APP_ID" --type app-info --app-info "$APP_INFO_ID" --path "./app-info-localizations"

# 3) Lire en-US.strings, traduire vers nl-NL et ru (étape LLM)

# 4) Écrire nl-NL.strings et ru.strings dans :
#    - ./localizations/ (champs de localisation de version)
#    - ./app-info-localizations/ (champs sous-titre/nom/confidentialité)

# 5) Tout téléverser
asc localizations upload --version "$VERSION_ID" --path "./localizations"
asc localizations upload --app "$APP_ID" --type app-info --app-info "$APP_INFO_ID" --path "./app-info-localizations"

# 6) Vérifier
asc localizations list --version "$VERSION_ID" --output table
asc localizations list --app "$APP_ID" --type app-info --app-info "$APP_INFO_ID" --output table

Comportement de l'agent

  1. Commencez toujours par lire la locale source — ne traduisez jamais de mémoire ou par supposition.
  2. Vérifiez d'abord les localisations existantes — n'écrasez pas les traductions existantes sauf si l'utilisateur demande de les mettre à jour.
  3. Version vs informations de l'application sont différents — les champs de version se trouvent sous --version "VERSION_ID" ; le sous-titre/nom/confidentialité se trouvent sous --app ... --type app-info.
  4. Privilégiez les identifiants déterministes — ne sélectionnez pas les identifiants via head -1 sauf demande explicite ; utilisez --output table pour la sélection ou asc-id-resolver.
  5. Validez les limites de caractères avant de téléverser. Comptez les caractères pour chaque champ. Si la limite est dépassée, retraduction plus courte.
  6. Les mots-clés sont spéciaux — ne les traduisez pas littéralement. Recherchez des termes de recherche adaptés à la locale. Pensez comme un utilisateur recherchant dans l'App Store dans cette langue.
  7. Montrez les traductions à l'utilisateur avant de téléverser — présentez un tableau récapitulatif de tous les champs × locales pour approbation. Ne poussez pas sans confirmation.
  8. Traitez une locale à la fois si vous traduisez plusieurs langues — plus facile à réviser et à détecter les erreurs.
  9. Si le téléversement échoue pour une locale, enregistrez l'erreur, continuez avec les autres locales, signalez tous les échecs à la fin.
  10. Pour les mises à jour de localisations existantes — téléchargez les actuelles, affichez la différence de ce qui va changer, obtenez l'approbation, puis téléversez.

Remarques

  • Les localisations de version sont liées à une version spécifique. Créez d'abord la version si elle n'existe pas.
  • promotionalText peut être mis à jour à tout moment sans soumettre une nouvelle version.
  • whatsNew n'est pertinent que pour les mises à jour, pas pour la première version.
  • Utilisez la compétence asc-id-resolver si vous ne disposez que des noms d'application/de version au lieu des identifiants.
  • Utilisez la compétence asc-metadata-sync pour les opérations de métadonnées non liées à la traduction.
  • Pour la localisation des noms d'affichage des abonnements/IAP, utilisez plutôt la compétence asc-subscription-localization.

Individual skills in this repo

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

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

Skills associés