Communitygithub.com

JordanCoin/ios-skills-collection

Analisa dados oficiais de performance do seu aplicativo vindos do App Store Connect — downloads exatos, receita, compras dentro do aplicativo, assinaturas, testes e desagregação por país, sincronizados via Appeeky Connect.

O que é ios-skills-collection?

Esta skill permite que agentes de IA analisem dados oficiais de performance de aplicativos iOS diretamente do App Store Connect, sincronizados através da plataforma Appeeky. Diferente de estimativas de terceiros, a skill trabalha com dados primários exatos — incluindo downloads, receita, compras dentro do aplicativo (IAP), assinaturas e testes (trials), com até 90 dias de histórico. A skill suporta análises como comparação período a período, tendências diárias, desagregação por país e qualidade da receita (ARPD, taxa de teste, conversão de assinatura). Para desenvolvedores e Product Managers, ela fornece insights acionáveis como identificar quedas de downloads, oportunidades de localização e melhorias de monetização. A skill integra-se ao fluxo de trabalho de outras skills complementares, como `monetization-strategy`, `retention-optimization` e `localization`, formando um ecossistema completo de análise de aplicativos.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/JordanCoin/ios-skills-collection/tree/HEAD/skills/eronred--asc-metrics

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Métricas ASC

Você analisa os dados oficiais do App Store Connect do usuário sincronizados no Appeeky — downloads exatos, receita, IAP, assinaturas e testes. Estes são dados primários, não estimativas.

Pré-requisitos

  • Conta Appeeky com ASC conectado (Configurações → Integrações → App Store Connect)
  • Plano Indie ou superior (2 créditos por requisição)
  • Sincronização de dados noturna; até 90 dias de histórico disponíveis

Se o ASC não estiver conectado, peça ao usuário para conectá-lo em appeeky.com/settings e retorne.

Avaliação Inicial

  1. Verifique se existe app-marketing-context.md — leia-o para obter contexto do aplicativo
  2. Pergunte: O que você quer analisar? (downloads, receita, assinaturas, desagregação por país, comparação de tendências)
  3. Pergunte: Qual período de tempo? (padrão: últimos 30 dias)
  4. Pergunte: Aplicativo específico ou todos os aplicativos?

Buscando Dados

Passo 1 — Listar aplicativos disponíveis

GET /v1/connect/metrics/apps

Relacione o aplicativo do usuário a um app_apple_id se ainda não conhecido.

Passo 2 — Obter visão geral (portfólio)

GET /v1/connect/metrics?from=AAAA-MM-DD&to=AAAA-MM-DD

Passo 3 — Obter detalhes do aplicativo (aplicativo único)

GET /v1/connect/metrics/apps/:appId?from=AAAA-MM-DD&to=AAAA-MM-DD

A resposta inclui: daily[], countries[], totals.

Veja a referência completa da API: appeeky-connect.md

Estruturas de Análise

Comparação Período a Período

Busque duas janelas de tamanho igual e compare:

MétricaPeríodo AnteriorPeríodo AtualVariação
Downloads[N][N][+/-X%]
Receita$[N]$[N][+/-X%]
Assinaturas[N][N][+/-X%]
Testes[N][N][+/-X%]
Taxa Teste → Assinatura[X]%[X]%[+/-X pp]

O que observar:

  • Downloads subindo mas receita estável → problema de precificação ou paywall
  • Testes subindo mas conversões estáveis → problema de paywall ou onboarding
  • Receita subindo mas downloads estáveis → boa melhoria de monetização

Análise de Tendência Diária

A partir de daily[], identifique:

  • Picos — Uma funcionalidade, atualização ou imprensa os desencadeou?
  • Quedas — Correlacione com atualizações, sazonalidade ou mudanças de algoritmo
  • Direção da tendência — Média móvel de 7 dias vs 7 dias anteriores

Desagregação por País

Ordene countries[] por downloads e receita:

  1. Top 5 por downloads — Você está investindo em ASO para esses mercados?
  2. Top 5 por receita — ARPD (receita média por download) mais alto = priorize ASO
  3. Downloads altos, receita baixa — Mercados com monetização fraca
  4. Downloads baixos, receita alta — Mercados premium subexplorados (localize)

Verificação da Qualidade da Receita

Calcule a partir dos dados:

MétricaFórmulaReferência
ARPDReceita / Downloads> $0,05 bom; > $0,20 excelente
Taxa de testeTestes / Downloads> 20% significa forte alcance do paywall
Conversão de assinaturaAssinaturas / Testes> 25% é forte
Receita por assinanteReceita / AssinaturasDepende da precificação

Formato de Saída

Instantâneo de Performance

📊 [Nome do Aplicativo] — [Período]

Downloads:     [N]  ([+/-X%] vs período anterior)
Receita:       $[N] ([+/-X%])
Assinaturas:   [N]  ([+/-X%])
Testes:        [N]  ([+/-X%])
Qtd. IAP:      [N]  ([+/-X%])
Teste→Assin:   [X]%

Principais Mercados (downloads):
  1. [País] — [N] downloads, $[N]
  2. [País] — [N] downloads, $[N]
  3. [País] — [N] downloads, $[N]

Observações Chave:
- [O que a tendência significa]
- [Qualquer anomalia e causa provável]
- [Oportunidade identificada]

Ações Recomendadas:
1. [Ação específica baseada nos dados]
2. [Ação específica baseada nos dados]

Alerta de Tendência

Quando uma mudança significativa (>20%) for detectada, sinalize-a:

⚠️  Queda de [X]% nos downloads esta semana
    Causas possíveis: [liste 2-3 hipóteses]
    Próximos passos: [ações diagnósticas específicas]

Perguntas Comuns

"Por que meus downloads caíram?"

  1. Puxe a tendência diária — quando começou?
  2. Verifique se uma atualização foi enviada nessa data
  3. Verifique o ranking de palavras-chave (use a skill keyword-research)
  4. Verifique a atividade de concorrentes (use a skill competitor-analysis)

"Quais países devo priorizar para localização?" Puxe a desagregação por país → ordene por downloads → identifique mercados de alto download que não falam inglês → use a skill localization

"Minha monetização está melhorando?" Compare a taxa de teste e a taxa de teste→assinatura período a período → use a skill monetization-strategy para melhorias de paywall

Skills Relacionadas

  • app-analytics — Configuração completa do stack de analytics e framework de KPIs
  • monetization-strategy — Melhorar conversão de assinaturas e paywall
  • retention-optimization — Reduzir churn usando as métricas como insumo
  • localization — Expandir mercados de alto desempenho vistos nos dados de países
  • ua-campaign — Validar se instalações pagas aparecem nos picos de downloads

Individual skills in this repo

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

JordanCoin/ios-skills-collection

Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries. Use when the user asks about GitHub issues, pull requests, workflows, or wants to interact with GitHub repositories from the command line — including tasks like check CI status, create PR, list issues, or query the GitHub API.

JordanCoin/ios-skills-collection

Create media playback experiences using AVKit. Use when adding video players with AVPlayerViewController, enabling Picture-in-Picture, routing media with AirPlay, using SwiftUI VideoPlayer views, configuring transport controls, displaying subtitles and closed captions, or integrating AVFoundation playback with system UI.

JordanCoin/ios-skills-collection

Integrate and optimize Core ML models in iOS apps for on-device machine learning inference. Covers model loading (.mlmodelc, .mlpackage), predictions with auto-generated classes and MLFeatureProvider, compute unit configuration (CPU, GPU, Neural Engine), MLTensor, VNCoreMLRequest, MLComputePlan, multi-model pipelines, and deployment strategies. Use when loading Core ML models, making predictions, configuring compute units, or profiling model performance.

JordanCoin/ios-skills-collection

Implement, review, or improve maps and location features in iOS/macOS apps using MapKit and CoreLocation. Use when working with Map views, annotations, markers, polylines, user location tracking, geocoding, reverse geocoding, search/autocomplete, directions and routes, geofencing, region monitoring, CLLocationUpdate async streams, or location authorization flows. Also use when working with maps, coordinates, addresses, places, directions, distance calculations, or location-based features in Swift apps.

JordanCoin/ios-skills-collection

Display and manipulate PDF documents using PDFKit. Use when embedding PDFView to show PDF files, creating or modifying PDFDocument instances, adding annotations (highlights, notes, signatures), extracting text with PDFSelection, navigating pages, generating thumbnails, filling PDF forms, or wrapping PDFView in SwiftUI.

JordanCoin/ios-skills-collection

Implement, review, or improve in-app tips and onboarding using Apple's TipKit framework. Use when adding feature discovery tooltips, onboarding flows, contextual tips, first-run experiences, coach marks, or working with Tip protocol, TipView, popoverTip, tip rules, tip events, or feature education UI.

JordanCoin/ios-skills-collection

When the user wants to optimize their Google Play Store listing — title, short description, full description, keywords, ratings, or Play Store-specific features. Use when the user mentions "Google Play", "Android", "Play Store", "Play Console", "short description", "full description indexed", "Google Play ASO", or wants Google Play-specific keyword, creative, or ratings strategy. For iOS App Store optimization, see aso-audit and metadata-optimization.

JordanCoin/ios-skills-collection

When the user wants to implement, optimize, or use App Clips for app discovery and conversion. Use when the user mentions "App Clip", "app clip code", "mini app", "instant app", "App Clip card", "App Clip link", "no download required", "instant experience", or wants to understand how App Clips appear in App Store search. For general App Store discoverability, see aso-audit. For marketing campaigns, see ua-campaign.

JordanCoin/ios-skills-collection

When the user wants to plan a launch strategy for a new app or major update. Also use when the user mentions "app launch", "launch plan", "launch checklist", "pre-launch", "launch day", or "how to launch my app". For ongoing ASO after launch, see aso-audit. For paid acquisition during launch, see ua-campaign.

JordanCoin/ios-skills-collection

When the user wants a full ASO health audit, review their App Store listing quality, or diagnose why their app isn't ranking. Also use when the user mentions "ASO audit", "ASO score", "why am I not ranking", "listing review", or "optimize my app store page". For keyword-specific research, see keyword-research. For metadata writing, see metadata-optimization.

JordanCoin/ios-skills-collection

Always use when working on any iOS, macOS, Swift, SwiftUI, Xcode, or Apple platform project. Routes to the correct specialized skills based on development phase and task context. This collection contains 210 skills from 28 authors covering the full iOS lifecycle.

Habilidades Relacionadas