Communitygithub.com

ComeOnOliver/skillshub

Nutze dieses Skill, um App Store Metadaten in einer Ausgangssprache abzurufen, per LLM zu übersetzen und die Übersetzungen automatisiert zurück in App Store Connect zu übertragen.

Was ist skillshub?

Dieses Skill automatisiert den gesamten Workflow zur Lokalisierung von App Store Metadaten für Entwickler, die mit dem `asc` CLI-Tool arbeiten. Es unterstützt das Herunterladen von Metadaten aus App Store Connect, die Übersetzung mittels eines Large Language Models (LLM) und das Hochladen der übersetzten Versionen. Das Tool unterscheidet zwischen versionsspezifischen Feldern (Beschreibung, Keywords, What's New) und app-weiten Feldern (Name, Untertitel, Datenschutzlinks) und bietet detaillierte Richtlinien für die Übersetzung, einschließlich Tonfall, Zeichenbegrenzungen und kultureller Anpassung. Es unterstützt zahlreiche Locales wie `de-DE`, `ja`, `fr-FR` und viele mehr. Der Workflow umfasst die ID-Auflösung, den Download der Quelldateien im `.strings`-Format, die LLM-basierte Übersetzung mit einem bereitgestellten Prompt-Template und den Upload über Stapel- oder Einzelbefehle. Das Skill legt Wert auf deterministische Operationen, verwendet bevorzugt lange Flags und validiert Zeichenlimits vor dem Hochladen. Nach der Übersetzung präsentiert es dem Benutzer eine Zusammenfassung zur Genehmigung, bevor es die Änderungen überträgt. Es ist für Plattformen wie Claude Code, Cursor und Codex (via `asc`) optimiert und stellt sicher, dass Übersetzungen professionell, formal und den App Store Richtlinien entsprechend sind.

Funktioniert mit~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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

asc localize metadata

Nutze dieses Skill, um englische (oder andere Ausgangssprache) App Store Metadaten abzurufen, per LLM zu übersetzen und die Übersetzungen automatisiert zurück in App Store Connect zu übertragen.

Befehlsfindung und Ausgabekonventionen

  • Bestätige Flags immer mit --help für die exakte asc-Version:
    • asc localizations --help
    • asc localizations download --help
    • asc localizations upload --help
    • asc apps info edit --help
  • Bevorzuge explizite lange Flags (--app, --version, --version-id, --type, --app-info).
  • Standardausgabe ist JSON; verwende --output table nur für manuelle Überprüfungsschritte.
  • Bevorzuge deterministische ID-basierte Operationen. Wähle nicht die "erste Zeile" via head -1, es sei denn, der Benutzer stimmt ausdrücklich zu.

Voraussetzungen

  • Authentifizierung konfiguriert (asc auth login oder ASC_*-Umgebungsvariablen)
  • Kennen deiner App-ID (asc apps list zum Finden)
  • Mindestens ein Gebietsschema (normalerweise en-US) hat bereits Metadaten in App Store Connect

Unterstützte Gebietsschemata

App Store Connect-Gebietsschemata für Versions- und App-Info-Lokalisierungen:

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

Zwei Arten von Metadaten

Versionslokalisierungen (pro Release)

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

App-Info-Lokalisierungen (App-Ebene, dauerhaft)

Felder: name, subtitle, privacyPolicyUrl, privacyChoicesUrl, privacyPolicyText

Arbeitsablauf

Schritt 1: IDs auflösen

# App-ID finden
asc apps list --output table

# Neueste Versions-ID finden
asc versions list --app "APP_ID" --state READY_FOR_DISTRIBUTION --output table
# oder für bearbeitbare Version:
asc versions list --app "APP_ID" --state PREPARE_FOR_SUBMISSION --output table

# App-Info-ID finden (für App-Ebenen-Felder wie Name/Untertitel)
asc apps info list --app "APP_ID" --output table

Hinweise:

  • Versionslokalisierungsfelder (description, keywords, whatsNew, etc.) sind versionsspezifisch.
  • App-Info-Felder (name, subtitle, privacy URLs/text) sind App-Ebene und verwenden --type app-info.
  • Wenn du nur Namen (App-Name, Versionszeichenfolge) hast und IDs deterministisch benötigst, verwende asc-id-resolver.

Schritt 2: Ausgangsgebietsschema herunterladen

# Versionslokalisierungen in lokale .strings-Dateien herunterladen
# (description, keywords, whatsNew, promotionalText, supportUrl, marketingUrl, ...)
asc localizations download --version "VERSION_ID" --path "./localizations"

# App-Info-Lokalisierungen in lokale .strings-Dateien herunterladen
# (name, subtitle, privacyPolicyUrl, privacyChoicesUrl, privacyPolicyText, ...)
asc localizations download --app "APP_ID" --type app-info --app-info "APP_INFO_ID" --path "./app-info-localizations"

Dies erstellt Dateien wie ./localizations/en-US.strings und ./app-info-localizations/en-US.strings. Falls ein Download nicht verfügbar ist, lies die Felder einzeln aus:

# Vorhandene Lokalisierungen und deren Inhalt anzeigen
asc localizations list --version "VERSION_ID" --output table

Schritt 3: Mit LLM übersetzen

Für jedes Zielgebietsschema den Quelltext übersetzen. Beachte dabei folgende Regeln:

Übersetzungsrichtlinien

  • Tonfall & Register: Verwende immer formelle, höfliche Sprache. Verwende formelle "Sie"-Formen, wo die Sprache diese unterscheidet (Russisch: «вы», Deutsch: «Sie», Französisch: «vous», Spanisch: «usted», Niederländisch: «u», Italienisch: «Lei», Portugiesisch: «você» formell usw.). App Store-Beschreibungen sind professionelle Marketingtexte – niemals lockeren oder informellen Tonfall verwenden.
  • description: Natürlich übersetzen, Tonfall an den lokalen Markt anpassen. Formatierung beibehalten (Zeilenumbrüche, Aufzählungspunkte, Emojis). Innerhalb von 4000 Zeichen bleiben.
  • keywords: NICHT wörtlich übersetzen. Recherchiere, wonach Benutzer in diesem Gebietsschema im App Store suchen würden. Komma-getrennt, maximal 100 Zeichen insgesamt. Keine Duplikate, kein App-Name (Apple fügt ihn automatisch hinzu).
  • whatsNew: Versionshinweise übersetzen. Prägnant halten. Maximal 4000 Zeichen.
  • promotionalText: Marketing-Slogan übersetzen. Maximal 170 Zeichen. Kann ohne neue Version aktualisiert werden.
  • subtitle: Slogan kreativ anpassen. Maximal 30 Zeichen – sehr knapp, möglicherweise kreative Anpassung nötig.
  • name: Normalerweise den ursprünglichen App-Namen beibehalten. Nur übersetzen, wenn der Benutzer es ausdrücklich verlangt. Maximal 30 Zeichen.

LLM-Übersetzungs-Prompt-Vorlage

Für jedes Zielgebietsschema diesen Ansatz verwenden:

Übersetze die folgenden App Store-Metadaten von {source_locale} nach {target_locale}.

Regeln:
- description: Natürliche, flüssige Übersetzung. Formatierung beibehalten (Zeilenumbrüche, Aufzählungspunkte, Emojis). Maximal 4000 Zeichen.
- keywords: NICHT wörtlich übersetzen. Wähle Schlüsselwörter, die Muttersprachler im App Store suchen würden. Komma-getrennt, maximal 100 Zeichen insgesamt. App-Namen nicht einfügen.
- whatsNew: Versionshinweise natürlich übersetzen. Maximal 4000 Zeichen.
- promotionalText: Marketing-Slogan übersetzen. Maximal 170 Zeichen.
- subtitle: Slogan kreativ anpassen, um maximal 30 Zeichen zu passen.
- name: Originalen App-Namen beibehalten, es sei denn, der Benutzer hat ausdrücklich um eine Übersetzung gebeten. Maximal 30 Zeichen.
- Verwende formelle, höfliche Sprache und formelle "Sie"-Formen (Deutsch: Sie, Russisch: вы, Französisch: vous, Spanisch: usted, Niederländisch: u usw.). App Store-Texte sind professionelle Marketingtexte – niemals informellen Tonfall verwenden.
- Respektiere den kulturellen Kontext. Ein spielerischer Ton im Englischen muss möglicherweise für formelle Märkte angepasst werden (z.B. ja, de-DE).

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

keywords: {keywords}

whatsNew: """
{whatsNew}
"""

promotionalText: {promotionalText}

name: {name}

subtitle: {subtitle}

Schritt 4: Übersetzungen hochladen

Option A: Über .strings-Dateien (Stapelverarbeitung)

Erstelle eine .strings-Datei pro Gebietsschema im entsprechenden Verzeichnis.

Beispiel für Versionslokalisierung:

// de-DE.strings
"description" = "Deine App-Beschreibung hier";
"keywords" = "Mathe,Kinder,Einmaleins,Lernen";
"whatsNew" = "Fehlerbehebungen und Verbesserungen";
"promotionalText" = "Lerne das Einmaleins spielend!";

Dann die Versionslokalisierungen hochladen:

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

Beispiel für App-Info-Lokalisierung:

// de-DE.strings
"subtitle" = "Einmaleins spielend lernen";

Dann die App-Info-Lokalisierungen hochladen:

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

Option B: Über einzelne Befehle (Feinsteuerung)

# Versionslokalisierungsfelder (Feinsteuerung).
# Bevorzuge die explizite Angabe der Versions-ID für Determinismus.
asc apps info edit --app "APP_ID" --version-id "VERSION_ID" --locale "de-DE" \
  --description "Deine Beschreibung..." \
  --keywords "Mathe,Kinder,Einmaleins" \
  --whats-new "Fehlerbehebungen und Verbesserungen"

Für App-Ebenen-Felder:

# Untertitel/Name (App-Info-Lokalisierung) wird über App-Info-Lokalisierungen verwaltet.
# Verwende den .strings + Upload-Ablauf (es gibt keinen `asc app-infos localizations ...` Befehl).
#
# 1) Bearbeiten: ./app-info-localizations/de-DE.strings
# "subtitle" = "Einmaleins spielend lernen";
#
# 2) Hochladen:
asc localizations upload --app "APP_ID" --type app-info --app-info "APP_INFO_ID" --path "./app-info-localizations"

Schritt 5: Überprüfen

# Überprüfen, ob alle Gebietsschemata vorhanden sind
asc localizations list --version "VERSION_ID" --output table

# App-Info-Lokalisierungen überprüfen
asc localizations list --app "APP_ID" --type app-info --app-info "APP_INFO_ID" --output table

Zeichenbegrenzungen (vor dem Hochladen durchsetzen!)

FeldBegrenzung
Name30
Untertitel30
Schlüsselwörter100 (komma-getrennt)
Beschreibung4000
What's New4000
Werbetext170

Validiere immer, dass der übersetzte Text innerhalb der Begrenzungen liegt, bevor du hochlädst. Abgeschnittener Text wirkt unprofessionell. Falls die Übersetzung die Begrenzung überschreitet, kürze sie – schneide sie nicht mitten im Satz ab.

Vollständiges Beispiel: nl-NL und ru zu Roxy Math hinzufügen

# 1) IDs deterministisch auflösen (nicht automatisch die "erste" Zeile auswählen)
# Wenn du nur Namen hast, verwende das asc-id-resolver Skill.
asc apps list --output table
APP_ID="APP_ID_HERE"

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

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

# 2) Englische Quelle herunterladen (oder dein gewähltes Ausgangsschema)
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) en-US.strings lesen, nach nl-NL und ru übersetzen (LLM-Schritt)

# 4) nl-NL.strings und ru.strings schreiben nach:
#    - ./localizations/ (Versionslokalisierungsfelder)
#    - ./app-info-localizations/ (Untertitel/Name/Datenschutzfelder)

# 5) Alle hochladen
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) Überprüfen
asc localizations list --version "$VERSION_ID" --output table
asc localizations list --app "$APP_ID" --type app-info --app-info "$APP_INFO_ID" --output table

Agentenverhalten

  1. Beginne immer damit, die Ausgangssprache zu lesen – übersetze niemals aus dem Gedächtnis oder Annahmen.
  2. Überprüfe zuerst vorhandene Lokalisierungen – überschreibe keine bestehenden Übersetzungen, es sei denn, der Benutzer bittet um eine Aktualisierung.
  3. Version vs. App-Info ist unterschiedlich – Versionsfelder liegen unter --version "VERSION_ID"; Untertitel/Name/Datenschutz liegen unter --app ... --type app-info.
  4. Bevorzuge deterministische IDs – wähle IDs nicht via head -1 aus, es sei denn, ausdrücklich gewünscht; verwende --output table zur Auswahl oder asc-id-resolver.
  5. Validiere Zeichenbegrenzungen vor dem Hochladen. Zähle Zeichen für jedes Feld. Bei Überschreitung neu übersetzen, kürzer.
  6. Schlüsselwörter sind speziell – nicht wörtlich übersetzen. Recherchiere gebietsschema-angepasste Suchbegriffe. Denke wie ein Benutzer, der im App Store in dieser Sprache sucht.
  7. Zeige dem Benutzer die Übersetzungen vor dem Hochladen – präsentiere eine Zusammenfassungstabelle aller Felder × Gebietsschemata zur Genehmigung. Nicht ohne Bestätigung übertragen.
  8. Verarbeite ein Gebietsschema nach dem anderen, wenn viele Sprachen übersetzt werden – einfacher zur Überprüfung und Fehlererkennung.
  9. Wenn der Upload für ein Gebietsschema fehlschlägt, protokolliere den Fehler, fahre mit anderen Gebietsschemata fort und melde alle Fehler am Ende.
  10. Für Aktualisierungen bestehender Lokalisierungen – lade die aktuellen Daten herunter, zeige, was sich ändern wird, hole Genehmigung ein, dann lade hoch.

Hinweise

  • Versionslokalisierungen sind an eine bestimmte Version gebunden. Erstelle die Version zuerst, falls sie nicht existiert.
  • promotionalText kann jederzeit ohne neue Versionseinreichung aktualisiert werden.
  • whatsNew ist nur für Updates relevant, nicht für die erste Version.
  • Verwende das asc-id-resolver Skill, wenn du nur App-/Versionsnamen anstelle von IDs hast.
  • Verwende das asc-metadata-sync Skill für nicht-übersetzungsbezogene Metadatenoperationen.
  • Für die Lokalisierung von Abonnement-/In-App-Kauf-Anzeigenamen verwende stattdessen das asc-subscription-localization Skill.

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

Verwandte Skills