asc-metadata-sync

Migrate and validate App Store metadata localizations against App Store Connect.

33|2|Updated Feb 21, 2025
One-click install
npx skills add https://github.com/yspreen/dotfiles --skill asc-metadata-sync
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: asc-metadata-sync
Source: https://github.com/yspreen/dotfiles/tree/main/.agents/skills/asc-metadata-sync
Command: npx skills add https://github.com/yspreen/dotfiles --skill asc-metadata-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Keeps App Store Connect metadata in sync with local files and translations, preventing drift and ensuring consistency when updating app information across releases.

Core Features & Use Cases

  • Export, validate, and migrate metadata between local files and App Store Connect for both version localizations and app-info localizations.
  • Handle version localizations (description, keywords, what's new, etc.) and app-info localizations (name, subtitle, privacyPolicyUrl, privacyPolicyText, privacyChoicesUrl) across multiple locales.
  • Apply legacy metadata format migrations with a clear export -> validate -> import workflow to ensure compatibility and correctness.

Quick Start

Export current metadata with asc migrate export, update local files in your preferred editor, and import changes with asc migrate import.

Frequently Asked Questions about asc-metadata-sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync App Store Connect metadata with local files across multiple locales?

You can sync App Store Connect metadata by running an export, updating local files, and importing changes back. This enforces consistency for both version localizations and app-info localizations across multiple locales.

What is the best way to migrate legacy App Store metadata formats?

The best way to migrate legacy App Store metadata is using a structured export, validate, and import workflow. This process ensures format compatibility and correctness before applying changes to App Store Connect.

Can I validate App Store metadata character limits before importing?

Yes, you can validate App Store metadata character limits before importing. The validation step enforces character limits for version localizations like description and keywords to prevent upload errors.

What App Store Connect app-info localizations can I manage with metadata sync?

Metadata sync allows you to manage app-info localizations including name, subtitle, privacyPolicyUrl, privacyChoicesUrl, and privacyPolicyText. This ensures your app information stays consistent across all configured locales.

Why does App Store Connect metadata drift when updating releases?

App Store Connect metadata drifts when local files and translations are updated without syncing back to the portal. Using a metadata migration workflow prevents this drift and ensures consistency across releases.