Communitygithub.com

Otimização de Metadados ASO

Use quando o usuário deseja escrever, reescrever, otimizar, comparar, validar ou preencher em lote metadados da Apple App Store ou Google Play no ASO.dev: título, subtítulo, campo de palavras-chave, descrição, texto promocional, descrição curta, descrição completa ou Novidades.

O que é Otimização de Metadados ASO?

Esta skill capacita agentes de IA a otimizar metadados da Apple App Store e Google Play diretamente na plataforma ASO.dev. Ela segue um fluxo de trabalho estruturado: busca os valores atuais com `current-metadata-fetch`, obtém contexto do projeto com `get_project_context` (posicionamento, tom, público, alegações proibidas), identifica a plataforma, país, localidade e tipo de página (listagem padrão, metadados de versão, CPP/PPO ou listagem do Google), e realiza pesquisa de palavras-chave com `keyword-research` quando necessário. A skill distribui as palavras-chave selecionadas usando `keyword-coverage` e elabora os metadados apenas para as localidades e campos solicitados, validando com `validate_ai_companion_data` para `appMetadata` ou `googleMetadata`. Se o usuário solicitar preenchimento, utiliza `bulk_fill` ou `bulk_fill_google`. A skill impõe um rigoroso 'portão de qualidade': os campos recomendados devem estar prontos para copiar e colar, sem placeholders, respeitando limites de caracteres e regras específicas de cada plataforma. Ela também oferece alternativas para campos de alto impacto, mas com uma opção recomendada claramente identificada. Quando dados do editor ASO.dev estão disponíveis (Smart Metadata Editor, Bulk Editor, Timeline/Changelog), a skill os utiliza para evitar suposições. A saída final é um pacote de otimização de metadados que inclui diagnóstico, tabelas de metadados recomendados e alternativos, matriz de cobertura de palavras-chave, comparações antes/depois e validação, tudo pronto para ser aplicado via payload de preenchimento.

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

Perguntar na sua IA favorita

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

Documentação

Otimização de Metadados

Escreva metadados da App Store e Google Play que equilibram visibilidade em busca, conversão, clareza e conformidade.

Fluxo de Trabalho

  1. Use current-metadata-fetch para ler os valores atuais.
  2. Use get_project_context se posicionamento, tom, público ou alegações proibidas forem relevantes.
  3. Identifique plataforma, país, localidade, palavras-chave alvo e tipo de página: listagem padrão, metadados de versão, rascunho CPP/PPO ou listagem do Google.
  4. Se as palavras-chave alvo estiverem ausentes, use keyword-research primeiro; use keyword-coverage para distribuir as palavras-chave selecionadas.
  5. Elabore apenas as localidades e campos solicitados.
  6. Valide com validate_ai_companion_data usando appMetadata ou googleMetadata.
  7. Se o usuário solicitou aplicar/preencher, use bulk_fill ou bulk_fill_google.

Portão de Qualidade

  • Os campos recomendados devem estar prontos para copiar e colar: sem placeholders, sem colchetes não resolvidos, contagem exata de caracteres e limites específicos da plataforma respeitados.
  • Se posicionamento do aplicativo, público, monetização, prova, URLs de suporte ou palavras-chave alvo estiverem ausentes, pergunte ou marque a lacuna na análise; não invente dentro dos metadados finais.
  • Forneça alternativas para campos de alto impacto, mas rotule claramente uma opção recomendada.
  • Trate as etapas de implementação separadamente do texto dos metadados para que o usuário possa colar os campos sem limpeza.

Contexto do Editor ASO.dev

Quando os dados do editor ASO.dev estiverem disponíveis, use-os em vez de adivinhar:

  • Smart Metadata Editor: valores atuais, verificações de comprimento, visualização, reutilizaç��o/rollback de versão anterior, importação/exportação, Fastlane, salvamento direto no App Store Connect e contexto de submissão de revisão.
  • Bulk Editor: todas as localizações, detecção de duplicatas, cópia de versões anteriores, estado de tradução AI/Google/DeepL.
  • Cross Localization: cobertura de título/subtítulo/palavra-chave por combinação de país-localização.
  • Timeline/Changelog: metadados anteriores e histórico de versões para comparações antes/depois.
  • Fluxo de trabalho de versão: versão do aplicativo, tipo de versão, seleção de build, classificação etária, notificações do servidor, localização primária e estado de adição/exclusão de localização podem afetar o que é seguro elaborar ou preencher.

Limites da Plataforma

Apple App Store

CampoLimitePapel na busca
title30Indexado, maior peso
subtitle30Indexado
keywords100 caracteres unidosIndexado, oculto
promotionalText170Conversão, não indexado, pode mudar sem versão do aplicativo
description4000Conversão, não indexado pela busca da App Store
whatsNew4000Comunicação de atualização

Google Play

CampoLimitePapel na busca
title30Indexado
shortDescription80Indexado e visível
fullDescription4000Indexado e conversão

Estrutura de Otimização

Título

  • Inclua a palavra-chave alvo mais forte naturalmente quando possível.
  • Liderar com a marca apenas quando for uma marca conhecida com demanda de busca ou valor de confiança significativos.
  • Para aplicativos menos conhecidos, lidere com a palavra-chave funcional/intenção mais importante e coloque a marca no final quando a inclusão da marca ainda for necessária; isso ajuda as sugestões da App Store e as frases a se formarem a partir de palavras-chave de maior prioridade primeiro.
  • Mantenha-o legível nos resultados de busca.
  • Evite desperdiçar caracteres com marcas legais, a menos que exigido.
  • Forneça 3 opções ao otimizar um título.

Boas estruturas:

  • Palavra-chave Primária: Frase de Benefício
  • Palavra-chave Primária - Intenção Secundária
  • Palavra-chave Primária by Marca
  • Marca Conhecida: Palavra-chave Primária

Subtítulo da Apple

  • Adicione palavras-chave secundárias e linguagem de benefício.
  • Não repita palavras do título a menos que haja uma razão estratégica clara.
  • Torne-o amigável para conversão, não apenas uma lista de palavras-chave.
  • Forneça 3 opções ao otimizar um subtítulo.

Campo de Palavras-Chave da Apple

  • Separado por vírgulas sem espaços.
  • Trate como um array internamente para payloads MCP.
  • Não repita palavras já no título/subtítulo a menos que seja deliberado.
  • Prefira formas singulares a menos que os dados suportem o plural.
  • Não inclua nome do aplicativo, marcas concorrentes, app ou free.
  • Priorize por relevância primeiro, depois por popularidade/oportunidade.

Descrição da Apple

  • A busca da App Store não a indexa; escreva principalmente para conversão.
  • As primeiras 2-3 linhas devem comunicar o benefício principal do usuário antes de tocar em "mais".
  • Use benefícios antes de listas de recursos.
  • Inclua apenas provas reais: avaliações, prêmios, imprensa, números de uso ou depoimentos fornecidos pelo usuário.
  • Não adicione emoji a menos que o tom da marca suporte.

Estrutura sugerida:

  1. Gancho
  2. Benefícios principais
  3. Principais recursos
  4. Como funciona
  5. Confiança/prova
  6. Chamada para ação

Descrição do Google

  • Equilibre conversão e cobertura natural de palavras-chave.
  • Carregue os termos mais relevantes no primeiro parágrafo; os primeiros ~250 caracteres devem funcionar sozinhos antes da expansão.
  • Use variantes e sinônimos; não exagere em palavras-chave.
  • Use marcadores e quebras de linha para escaneabilidade.
  • Mantenha a densidade natural e legível.

Texto Promocional

Use para mensagens oportunas:

  • lançamentos de recursos
  • campanhas sazonais
  • Eventos no Aplicativo
  • conteúdo por tempo limitado
  • prêmios ou marcos reais

Não codifique preços, datas, descontos ou disponibilidade a menos que dados atuais ou o usuário os confirmem.

Regras da Apple

  • As palavras-chave da Apple devem ser separadas por vírgulas sem espaços.
  • Evite palavras-chave duplicadas em título, subtítulo e palavras-chave, a menos que seja deliberado.
  • Não adicione marcas registradas de concorrentes ou alegações não suportadas.
  • Não altere URLs, texto de privacidade ou cópia legal a menos que explicitamente solicitado.
  • Sinalize ganchos fracos como "Bem-vindo ao..." ou alegações genéricas de "melhor aplicativo para...".
  • Sinalize orçamento de caracteres não utilizado apenas quando adicionar caracteres melhorar a relevância ou conversão.

Saída

# Pacote de Otimização de Metadados

Aplicativo:
Plataforma:
País:
Localidades:
Palavras-chave alvo:

## Diagnóstico
| Localidade | Campo | Problema | Correção |
|---|---|---|---|

## Metadados Recomendados
### código-localidade
| Campo | Recomendado | Caracteres | Palavras-chave cobertas | Justificativa |
|---|---:|---|---|

## Alternativas
| Campo | Opção | Texto | Caracteres | Ângulo |
|---|---:|---:|---|

## Matriz de Cobertura de Palavras-chave
| Palavra-chave | Título | Subtítulo/descrição curta | Campo de palavras-chave | Descrição | Notas |
|---|---|---|---|---|---|

## Antes/Depois
| Campo | Atual | Recomendado | Melhoria |
|---|---|---|---|

## Validação
- Limites de caracteres:
- Duplicação de palavras-chave:
- Fonte da pesquisa de palavras-chave:
- Alegações não suportadas:
- URLs/privacidade/legal inalterados:
- Validação MCP:
- Pronto para `bulk_fill`:

Regra de Payload de Preenchimento

Ao preencher metadados da Apple, envie:

{
  "locales": ["en-US"],
  "fields": ["title", "subtitle", "keywords"],
  "data": {
    "en-US": {
      "title": "...",
      "subtitle": "...",
      "keywords": ["palavra-chave", "palavra-chave2"]
    }
  }
}

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 analyze, respond to, report, or improve App Store reviews and ratings in ASO.dev: negative reviews, ratings trend, review replies, review complaints, review health, product insights, uploaded review CSV analysis, sentiment, missing feature requests, or rating prompt strategy.

asodevapp/skills

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

Habilidades Relacionadas