aso-audit

## Visão geral do skill aso-audit

### Para que serve o aso-audit
O skill `aso-audit` serve para fazer um diagnóstico estruturado de saúde de ASO em uma listagem da app store, e não para escrever copy do zero. Ele ajuda a entender por que um app está abaixo do esperado, comparar a listagem com concorrentes e transformar dúvidas soltas de ASO em um plano de ação priorizado. Se você precisa de um `aso-audit` para fluxo de trabalho de SEO Content, este é o skill certo quando o objetivo é auditoria primeiro, não brainstorming de palavras-chave.

### Quem aproveita mais
Use `aso-audit` se você gerencia uma listagem de app, quer um diagnóstico rápido de ranking ou precisa explicar problemas de ASO para times de produto ou marketing. Ele é especialmente útil quando você já tem um app ID, um país-alvo e uma plataforma em mente, porque esses insumos fazem a auditoria sair de conselhos genéricos e virar uma análise real.

### O que o diferencia
O skill foi construído em torno de uma estrutura baseada em pontuação: título, metadados, screenshots, avaliações, palavras-chave, concorrentes e sentimento das reviews. Isso deixa a saída mais pronta para decisão do que um prompt genérico, porque força o modelo a priorizar os problemas e recomendar o que corrigir primeiro. A principal troca é que ele funciona melhor quando você consegue fornecer dados do app ou permitir que o modelo os recupere.

## Como usar o skill aso-audit

### Instalação e ponto de partida
Use o fluxo `aso-audit install` do instalador padrão de skills do diretório e, em seguida, abra primeiro `skills/aso-audit/SKILL.md`. Para ter uma visão rápida do escopo, leia as instruções iniciais e depois veja como a auditoria é estruturada antes de copiar qualquer coisa para o seu próprio fluxo. Se o seu ambiente oferecer suporte, procure também por `app-marketing-context.md` no projeto antes de acionar o skill.

### O que fornecer antes de perguntar
O ponto ideal de `aso-audit usage` é um prompt que inclua o app ID, a plataforma, o país-alvo e o motivo da auditoria. Um bom exemplo seria: “Audite minha listagem de iOS para os EUA. App ID: 123456789. Tivemos queda nos installs orgânicos depois de uma atualização de metadados e quero os 5 principais ajustes ranqueados por impacto.” Se você já souber o problema, diga isso; se não souber, peça uma auditoria ampla de saúde de ASO e deixe o skill diagnosticar as lacunas.

### Fluxo de trabalho prático
Um bom fluxo `aso-audit guide` é: identificar o app, coletar dados da listagem e dos concorrentes, pontuar os principais elementos de ASO e transformar os achados em um plano de ação curto. Se você puder acessar dados externos via Appeeky MCP ou API, use isso; caso contrário, envie ao skill seu título atual, subtítulo, descrição, screenshots e quaisquer rankings conhecidos. Essa escolha afeta materialmente a qualidade da saída, porque o skill foi desenhado para auditar insumos reais da listagem, e não inferir tudo da memória.

### Melhores arquivos para ler primeiro
Comece com `SKILL.md`, porque ele contém a lógica da auditoria e as perguntas iniciais de avaliação. Se você estiver integrando o skill a um processo mais amplo, leia antes da execução qualquer arquivo de contexto referenciado, como `app-marketing-context.md`, já que é lá que normalmente ficam as restrições de marca e de mercado. O repositório é pequeno, então a árvore de arquivos é leve, mas o arquivo do skill em si é a principal fonte de verdade.

## FAQ do skill aso-audit

### O aso-audit serve mais para auditoria ou para reescrever metadados?
Ele serve principalmente para auditoria. O skill `aso-audit` pode apontar fragilidades em metadados, mas o valor central está no diagnóstico, na pontuação e na priorização. Se sua necessidade principal é gerar novos títulos, subtítulos ou descrições, um skill de escrita de metadados costuma ser a opção melhor.

### Preciso de uma fonte de dados para usá-lo bem?
Não obrigatoriamente, mas dados melhores tornam a auditoria muito mais útil. O skill funciona melhor com metadados do app, rankings, concorrentes e sinais de reviews. Sem isso, a saída tende a se apoiar mais em análise heurística e menos em evidências.

### Ele é amigável para iniciantes?
Sim, desde que você consiga responder a algumas perguntas básicas e informar o app ID. Ele é especialmente amigável para iniciantes quando você quer uma auditoria clara de ASO sem precisar aprender antes todo o framework de app store optimization. A principal limitação é que iniciantes podem precisar de ajuda para interpretar a pontuação e escolher o ajuste de maior impacto.

### Quando não devo usar o aso-audit?
Não use quando você só precisa de descoberta de palavras-chave, um rascunho novo de metadados ou uma revisão pontual de copy. Ele também é menos útil se você não conseguir informar o app, a plataforma e o mercado, porque esses dados são essenciais para uma auditoria significativa. Nesses casos, o skill `aso-audit` vai ser forçado a adivinhar demais.

## Como melhorar o skill aso-audit

### Dê insumos prontos para decisão
A forma mais rápida de melhorar o `aso-audit` é fornecer o contexto exato da listagem: app ID, plataforma, país, categoria, metadados atuais e seu objetivo de crescimento. Se o ranking caiu depois de uma mudança, diga quando a mudança aconteceu e o que foi alterado. Isso ajuda o skill a separar problemas óbvios da listagem de questões mais amplas de mercado ou sazonalidade.

### Peça correções ranqueadas, não só uma nota
Um modo comum de falhar é parar na nota de ASO. Peça os 3 a 5 principais ajustes, ranqueados por impacto, esforço e confiança. Por exemplo: “Depois da auditoria, diga o que mudar nesta semana, o que testar no próximo mês e o que ainda não mexer.” Isso deixa a saída do `aso-audit` mais acionável para equipes de SEO Content e produto.

### Itere com evidências
Depois da primeira rodada, devolva novos dados: metadados atualizados, variações de screenshots, mudanças de ranking ou temas recorrentes nas reviews. Em seguida, peça ao skill para reauditar apenas as áreas alteradas. Isso melhora a segunda passada porque transforma o skill de uma análise pontual em um ciclo de feedback para trabalho contínuo de ASO.