Communitygithub.com

Gerenciamento de Avaliações

Use quando o usuário deseja analisar, responder, relatar ou melhorar as avaliações e classificações da App Store no ASO.dev: avaliações negativas, tendências de classificação, respostas a avaliações, reclamações, saúde das avaliações, insights de produto, análise de CSV de avaliações carregado, sentimento, solicitações de recursos ausentes ou estratégia de prompt de classificação.

O que é Gerenciamento de Avaliações?

Esta habilidade capacita o agente a gerenciar avaliações da App Store de forma inteligente, integrando-se ao ASO.dev e ao MCP App Store Connect. Ela permite analisar avaliações individuais ou listas, gerar rascunhos de respostas empáticas usando o framework HEAR (Ouvir, Empatizar, Agir, Resolver), e identificar reclamações ou relatórios apropriados. Além disso, oferece suporte à análise de arquivos CSV de avaliações para extrair sentimento, temas (bugs, UX, preços), solicitações de recursos e insights de produto, sem exigir MCP apenas para análise. A habilidade também fornece orientação sobre estratégia de prompts de classificação, mineração de insights de produto e um formato de saída estruturado para relatórios de saúde e planos de melhoria. Suporta os agentes Claude Code, Cursor e Codex, e usa o MCP para preencher respostas e reclamações de volta ao ASO.dev.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/asodevapp/skills/tree/HEAD/skills/reviews-ratings

Perguntar na sua IA favorita

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

Documentação

O que Gerenciamento de Avaliações faz?

Use isso para análise de avaliações, gestão de reputação, rascunhos de respostas, rascunhos de reclamações/relatórios, mineração de insights de produto, análise de CSV de avaliações carregado e estratégia de melhoria de classificação.

Fluxo de trabalho MCP

  1. Use app-store-connect-mcp.
  2. Avaliação individual: leia com get_review_data.
  3. Lista de avaliações: leia com get_reviews_data.
  4. Use unansweredOnly, badRatingOnly e maxRating para restringir listas de avaliações.
  5. Use o contexto do projeto para tom, links de suporte, problemas conhecidos e política de resposta.
  6. Analise a saúde das avaliações, temas, oportunidades de resposta e elegibilidade para reclamação/relatório.
  7. Valide com validate_ai_companion_data alvo review ou reviewList.
  8. Se solicitado a aplicar, preencha os rascunhos com fill_review ou fill_reviews.

Campos de preenchimento

Avaliação individual:

  • responseBody
  • complaintReason
  • concernType

Lista de avaliações:

  • reviews: array ou mapa por reviewId, cada um com responseBody, complaintReason e/ou concernType

Análise de CSV de avaliações

Use este modo quando o usuário carregar ou referenciar um CSV com todas as avaliações. A análise de CSV não requer MCP, a menos que o usuário queira preencher respostas/reclamações de volta no ASO.dev.

Antes da análise:

  1. Identifique as colunas do CSV. Colunas comuns: ID da avaliação, classificação, título, texto/corpo, local/país, versão do aplicativo, data, resposta do desenvolvedor, data da resposta, dispositivo/plataforma.
  2. Normalize datas, classificações, locais, versões e valores vazios.
  3. Desduplique linhas repetidas por ID de avaliação ou título/corpo/data exatos.
  4. Segmente por classificação, local/país, versão do aplicativo, período de data, status de respondido/não respondido e comprimento da avaliação.
  5. Se o CSV for grande, amostre exemplos para citações, mas calcule contagens/temas em todo o arquivo.

Analise quanto a:

  • Sentimento por classificação e texto: positivo, neutro, negativo, misto.
  • Temas: bugs/crashes, atrito de UX, preços/paywall, integração, desempenho, conta/login, localização, suporte, qualidade do conteúdo.
  • Solicitações de recursos: capacidades ausentes, padrões repetidos de "queria que tivesse...", comparações com concorrentes.
  • Risco do produto: regressões por versão do aplicativo/data, bugs graves, intenção de reembolso/cancelamento, preocupações com confiança/privacidade.
  • Linguagem ASO: frases que os usuários usam para descrever valor, resultados e casos de uso.
  • Oportunidades de suporte: avaliações de baixa classificação sem resposta, respostas desatualizadas, respostas de alto impacto.

A saída do CSV deve incluir contagens e exemplos representativos. Não cole grandes despejos brutos de avaliações.

Estrutura de análise de avaliações

Classifique os temas:

TemaO que significaAção
Bugs/crashesFalha técnica, fluxo quebrado, regressãoEscalar correção, responder apenas com status conhecido
Solicitações de recursosUsuários pedem capacidade ausenteRastrear frequência e segmento de usuário
Reclamações de UXConfuso, lento, frustrante, difícil de usarPriorizar revisão de UX/produto
Preços/paywallMuito caro, assinatura pouco clara, confusão de testeUsar monetization-strategy se repetido
ElogiosValor, encanto, recursos favoritosAgradecer e aprender linguagem de conversão
Menções a concorrentesComparações ou motivos de trocaMinerar lacunas de posicionamento

Sinais de saúde das avaliações:

  • Classificação média e tendência, se disponível
  • Volume recente de baixa classificação
  • Avaliações negativas não respondidas
  • Taxa de resposta e frescor da resposta
  • Temas repetidos de bug/UX/preços
  • Candidatos a reclamação/relatório

Regras de resposta

  • Seja calmo, específico e breve.
  • Priorize respostas oportunas; busque 24-48 horas para avaliações negativas de alto impacto quando operacionalmente possível.
  • Não discuta com o avaliador.
  • Não revele dados internos.
  • Não prometa correções a menos que estejam confirmadas.
  • Não peça informações pessoais em público.
  • Para avaliações com raiva, reconheça o problema e direcione para o suporte.
  • Não peça ao usuário para mudar sua classificação.
  • Não copie e cole respostas idênticas em muitas avaliações.

Estrutura de resposta

Use HEAR para avaliações negativas:

  1. Hear (Ouvir): reconheça o problema específico.
  2. Empathize (Empatizar): mostre que você entende a frustração.
  3. Act (Agir): explique o que é conhecido, corrigido ou está sendo investigado.
  4. Resolve (Resolver): convide para suporte direto com o caminho de contato correto.

Modelos são apenas pontos de partida:

  • Bug: reconheça, mencione versão corrigida conhecida apenas se confirmada, convide para atualização/suporte.
  • Solicitação de recurso: agradeça, diga que foi compartilhado com a equipe, evite prometer roadmap.
  • Negativo vago: peça desculpas brevemente, peça detalhes através do suporte.
  • Positivo: agradeça e ecoe o benefício que eles nomearam.

Regras de reclamação/relatório

  • Relate apenas quando a avaliação parecer abusiva, spam, fraudulenta, irrelevante ou de outra forma violadora de política.
  • Não relate feedback negativo válido apenas porque é de baixa classificação.
  • Mantenha os motivos da reclamação factuais e curtos.

Estratégia de prompt de classificação

Use apenas para aconselhamento; esta habilidade MCP preenche rascunhos de avaliações, não código do aplicativo.

  • Acione apenas após um momento de valor positivo.
  • Evite primeira sessão, integração, erros, crashes, falha de pagamento ou frustração de suporte.
  • Bons momentos: tarefa concluída, objetivo alcançado, sequência, tempo/dinheiro economizado, restauração/exportação/compartilhamento bem-sucedidos.
  • Respeite os limites da plataforma e não incentive avaliações.
  • Se avaliações ruins forem causadas por problemas do produto, corrija o problema antes de aumentar o volume de prompts.

Mineração de insights de produto

Use as avaliações para extrair:

  • Recursos mais amados e linguagem exata do usuário para metadados/capturas de tela.
  • Principais bugs recorrentes ou falhas de UX.
  • Objeções de monetização e confusão de assinatura.
  • Frequência de demanda de recursos.
  • Concorrentes mencionados e gatilhos de troca.

Pontuação de solicitação de recurso:

SinalSignificado
FrequênciaQuantas avaliações mencionam a solicitação
Impacto na classificaçãoSe a solicitação aparece em avaliações de baixa classificação ou risco de churn
SegmentoLocal, versão, tipo de usuário ou país onde aparece
Ajuste estratégicoSe corresponde ao posicionamento e roadmap do aplicativo
Esforço/riscoSe precisa de trabalho de produto, backend, design, preços ou política

Saída

# Saúde das Avaliações e Trabalho de Resposta

Aplicativo:
Modo:
Classificação/tendência:
Filtros:
Fonte CSV:

## Resumo de saúde
- Total de avaliações carregadas:
- Avaliações de baixa classificação:
- Avaliações não respondidas:
- Principal risco:

## Sentimento
| Segmento | Positivo | Neutro | Negativo | Misto | Notas |
|---|---:|---:|---:|---:|---|

## Temas
| Tema | Contagem | Impacto na classificação | Evidência | Ação |
|---|---:|---|---|---|

## Recursos/solicitações ausentes
| Solicitação | Contagem | Segmento de usuário | Evidência | Recomendação de produto |
|---|---:|---|---|---|

## Rascunhos
| ID da Avaliação | Classificação | Tema | Ação | Rascunho |
|---|---:|---|---|---|

## Insights de produto
| Insight | Evidência | Proprietário/ação recomendados |
|---|---|---|

## Plano de melhoria de classificação
1.
2.
3.

## Validação
- Colunas do CSV mapeadas:
- Contagens baseadas em dados completos:
- Tom seguro:
- Sem dados privados:
- Reclamação justificada:
- Validação MCP:
- Pronto para preencher:

Individual skills in this repo

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

asodevapp/skills

Use when the user wants Google Play Store or Android ASO: Play listing title, short description, full description, keyword strategy, feature graphic, screenshots, ratings/reviews, Play Store Experiments, localization, or Google Play-specific metadata via ASO.dev.

asodevapp/skills

Use when the user wants to interpret ASO.dev Measurements or App Store Connect metrics: downloads, impressions, product page views, conversion, revenue, retention, sessions, active devices, ratings, reviews, release markers, experiment impact, or before/after ASO performance.

asodevapp/skills

Use to read, create, or update ASO.dev per-app project context before metadata, localization, keywords, screenshots, IAP, subscriptions, pricing, In-App Events, nominations, or review work.

asodevapp/skills

Use when the user wants a full ASO audit or health check for an app: metadata, keyword coverage, cross-localization, screenshots, reviews, ratings, update history, In-App Events, IAP/subscriptions, CPP/PPO, competitors, rankings, or ASO.dev ASO Check interpretation.

asodevapp/skills

Use when the user wants App Store Custom Product Pages, Product Page Optimization, A/B testing, conversion rate optimization, product page variants, screenshot/icon/app preview tests, campaign pages, keyword/ad alignment, or CPP/PPO drafts in ASO.dev.

asodevapp/skills

Use when the user wants to create, plan, audit, optimize, localize, or fill App Store In-App Events in ASO.dev: event cards for Today/Games/Apps tabs, search, product pages, re-engagement, challenges, competitions, live events, premieres, seasons, major updates, and special events.

asodevapp/skills

Use for App Store consumable and non-consumable In-App Purchases: metadata, localization, pricing/availability notes, promoted IAP readiness, validation, and ASO.dev local MCP fill when that surface is available.

asodevapp/skills

Use for keyword ideas, keyword prioritization, keyword/search query CSV-derived shortlists, competitor keyword gaps, Search Ads Popularity interpretation, and keyword distribution across metadata/locales.

asodevapp/skills

Use when the user wants to write, rewrite, optimize, compare, validate, or bulk-fill Apple App Store or Google Play metadata in ASO.dev: title, subtitle, keyword field, description, promotional text, short description, full description, or What's New.

asodevapp/skills

Use to prepare screenshot copy, screenshot order, creative briefs, and App Store / Google Play visual messaging.

Habilidades Relacionadas