asc-revenuecat-catalog-sync

Visão geral da skill asc-revenuecat-catalog-sync

asc-revenuecat-catalog-sync é uma skill de workflow para manter o App Store Connect e o RevenueCat alinhados. Ela ajuda a auditar divergências, criar assinaturas ou compras no app faltantes no ASC e mapear esses itens para produtos, entitlements, offerings e packages no RevenueCat com menos conferência manual cruzada.

Essa asc-revenuecat-catalog-sync skill é mais indicada para equipes de ecommerce e assinaturas que já têm um catálogo em um dos sistemas e precisam de uma forma confiável de espelhar tudo no outro. O principal objetivo não é “aprender RevenueCat” ou “aprender ASC” isoladamente; é sair de dados de catálogo confusos e parcialmente correspondentes para um plano de sincronização determinístico, que você possa revisar antes de aplicar mudanças.

O que esta skill faz bem

• Inicializar o RevenueCat a partir de um catálogo ASC já existente.
• Criar assinaturas ou IAPs faltantes no ASC antes de mapeá-los para o RevenueCat.
• Rodar uma auditoria de divergências antes de um release ou migração.
• Preservar identificadores estáveis para que produtos em produção não quebrem.

O que a torna diferente

• Ela é orientada por identificadores, não por suposição: ASC productId é a chave primária entre os sistemas.
• É mais segura do que um prompt avulso porque espera um fluxo de trabalho com auditoria primeiro.
• É prática para equipes que usam o asc-revenuecat-catalog-sync guide para reduzir erros de sincronização e reconciliação manual.

Quando ela é uma boa opção

Use asc-revenuecat-catalog-sync se você já tem autenticação configurada para o ASC e o RevenueCat MCP e quer um processo de sincronização repetível. Se você só precisa de uma estratégia de produto em alto nível ou de uma sessão única para pensar nomes, esta skill provavelmente traz mais complexidade do que valor.

Como usar a skill asc-revenuecat-catalog-sync

Instale e leia primeiro o arquivo certo

Instale o asc-revenuecat-catalog-sync com:

npx skills add rudrankriyam/app-store-connect-cli-skills --skill asc-revenuecat-catalog-sync

Depois, comece por skills/asc-revenuecat-catalog-sync/SKILL.md. Neste repositório, não há pastas auxiliares para explorar, então o próprio arquivo da skill é a fonte de verdade. Isso torna a primeira leitura especialmente importante: foque nos pré-requisitos, nos padrões de segurança e nas regras canônicas de identificador antes de tentar executar qualquer coisa.

Dê à skill informações que ela realmente consiga usar

O asc-revenuecat-catalog-sync usage funciona melhor quando você fornece fatos concretos do catálogo, e não um objetivo vago. Inclua:

• ASC app ID
• project_id do RevenueCat
• tipo de app de destino: app_store ou mac_app_store
• bundle ID para fluxos de criação
• se você quer apenas auditoria ou modo de escrita
• quaisquer pares de mapeamento já conhecidos entre ASC productId e RevenueCat store_identifier

Um prompt forte seria assim:

“Audite meu catálogo do ASC em comparação com o RevenueCat para o app 123456789. Use primeiro o modo de auditoria. Aqui está a lista atual de ASC productId e os store_identifier existentes no RevenueCat. Destaque itens faltantes, incompatibilidades e quaisquer identificadores instáveis antes de propor escritas.”

Siga a ordem de trabalho mais segura

Um bom asc-revenuecat-catalog-sync guide normalmente segue esta sequência:

1. Confirmar a autenticação para asc e RevenueCat MCP.
2. Rodar primeiro a auditoria em modo somente leitura.
3. Revisar itens faltantes, divergências e inconsistências de identificador.
4. Confirmar explicitamente qualquer criação ou atualização proposta.
5. Aplicar escrita somente depois de entender o diff.

Para asc-revenuecat-catalog-sync for Ecommerce, o maior ganho de qualidade vem de tratar identificadores como fonte da verdade e evitar renomeações improvisadas depois que os produtos já estão ativos.

Verifique o manual de regras no texto da skill

Antes de executar, valide três pontos em SKILL.md:

• padrões de segurança: sem deletes, confirmação explícita antes de writes
• tratamento de falhas: continuar item por item e resumir os erros
• mapeamento canônico: productId deve corresponder a store_identifier

Essas regras são o que tornam a skill viável em produção, e não apenas útil em um demo.

FAQ da skill asc-revenuecat-catalog-sync

Isso é só para usuários de RevenueCat?

Não. É para equipes que usam tanto o App Store Connect quanto o RevenueCat, especialmente quando precisam de uma camada de mapeamento limpa entre os dois. Se você não usa o RevenueCat MCP, esta skill não vai ajudar muito.

Posso usar se meu catálogo estiver bagunçado?

Sim, mas espere começar pelo modo de auditoria e por revisão manual. A skill foi feita para expor divergências e itens faltantes, não para adivinhar magicamente todos os mapeamentos ambíguos.

Isso é melhor do que um prompt genérico?

Geralmente, sim. Um prompt genérico consegue descrever o objetivo, mas a asc-revenuecat-catalog-sync skill embute as restrições operacionais importantes: autenticação, identificadores estáveis, comportamento com auditoria primeiro e segurança contra deletes. Isso reduz a chance de drift acidental no catálogo.

O que mais costuma travar a adoção?

Autenticação ausente, app IDs ou project IDs faltando e uma estratégia de identificadores pouco clara. Se você não consegue confirmar o mapeamento de ASC productId para RevenueCat store_identifier, a sincronização vira chute e a qualidade da saída cai rápido.

Como melhorar a skill asc-revenuecat-catalog-sync

Forneça dados exatos da fonte de verdade

A melhor melhoria é um input mais limpo. Envie o catálogo atual do ASC, o catálogo atual do RevenueCat e qualquer tabela de mapeamento conhecida em uma lista estruturada. A asc-revenuecat-catalog-sync skill funciona melhor quando consegue comparar identificadores exatos, em vez de ler descrições como “o plano mensal” ou “a oferta premium”.

Deixe claro o escopo da mudança desejada

Diga à skill se você quer:

• apenas auditoria
• criar itens faltantes no ASC
• mapear itens existentes para o RevenueCat
• reconciliação completa para um release

Essa escolha de escopo muda o que o modelo deve priorizar. Sem isso, a skill pode se preparar demais para um plano de escrita quando você só queria um relatório de divergências.

Trate incompatibilidades como problema de workflow, não de nome

Se o resultado parecer errado, muitas vezes o problema é ID instável, autenticação ausente ou dados de origem incompletos. Corrija isso primeiro antes de rodar novamente. Para asc-revenuecat-catalog-sync usage, a iteração mais útil costuma ser apertar os identificadores e rodar de novo em modo de auditoria, não pedir brainstorming mais amplo.

Peça um diff e depois valide

Uma segunda passada eficiente é pedir uma lista concisa de:

• itens faltantes no ASC
• itens no RevenueCat sem correspondência no ASC
• conflitos de identificador
• ações propostas de criação/atualização

Esse formato facilita revisar e aprovar mudanças, especialmente em catálogos de assinaturas de ecommerce, em que pequenas divergências podem gerar problemas reais de cobrança e entitlement.