Communitygithub.com

aiscripto/marca-voz

Analisa a voz, o tom e as mensagens de uma marca em todos os canais disponíveis e gera um documento abrangente de diretrizes de voz de marca. Esta habilidade examina como uma marca se comunica, identifica padrões e inconsistências e produz diretrizes acionáveis que qualquer redator ou profissional de marketing pode seguir para manter a consistência da marca.

O que é marca-voz?

Esta habilidade (skill) realiza uma análise profunda e estruturada da voz da marca, mapeando quatro dimensões principais (Formal x Casual, Sério x Lúdico, Técnico x Simples, Reservado x Ousado) com evidências coletadas de fontes como site, blog, redes sociais e e-mails. O assistente gera um documento completo de diretrizes de voz da marca (BRAND-VOICE.md), incluindo um espectro de tom, um framework de personalidade baseado em 5 arquétipos, análise de vocabulário, comparação com concorrentes, auditoria de consistência e exemplos práticos de copy. A habilidade é ativada pelo comando /market brand seguido de uma URL e é útil para equipes de marketing, redatores, agências e processos de rebranding, garantindo que toda a comunicação da marca seja coerente e alinhada. Suporta plataformas como Claude Code, Cursor e Codex, utilizando ferramentas de navegador e scripts para acesso ao conteúdo web.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aiscripto/ai-marketing/tree/HEAD/skills/market-brand

Perguntar na sua IA favorita

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

Documentação

Análise e Geração de Diretrizes de Voz da Marca

Propósito da Habilidade

Analisar a voz, o tom e as mensagens de uma marca em todos os canais disponíveis e gerar um documento abrangente de diretrizes de voz da marca. Esta habilidade examina como uma marca se comunica, identifica padrões e inconsistências e produz diretrizes acionáveis que qualquer redator ou profissional de marketing pode seguir para manter a consistência da marca.

Quando Usar

  • O usuário deseja entender ou documentar a voz de uma marca
  • O usuário precisa de diretrizes de voz de marca para a equipe, freelancers ou agência
  • O usuário deseja garantir consistência entre os canais de marketing
  • O usuário está reformulando ou refinando a identidade da marca
  • O usuário deseja comparar a voz de sua marca com a dos concorrentes
  • Acionado por /market brand <url> ou /market brand

Como Executar

Etapa 1: Coleta de Material de Origem

Para analisar a voz de uma marca, examine o conteúdo de várias fontes. Priorize nesta ordem:

Fontes Primárias (devem ser analisadas):

  1. Página Inicial – A representação mais curada da marca
  2. Página Sobre Nós – Como a marca se descreve
  3. Páginas de Produto/Serviço – Como apresentam suas ofertas

Fontes Secundárias (analisar se disponíveis): 4. Posts de Blog (pelo menos 3 a 5 posts recentes) 5. Perfis de Redes Sociais (biografia, posts recentes, estilo de engajamento) 6. Newsletters por E-mail (e-mail de boas-vindas, envios recentes) 7. Textos voltados ao Cliente (mensagens de erro, fluxos de integração, documentos de ajuda)

Fontes Terciárias: 8. Vagas de Emprego – Revela a cultura e os valores internos 9. Comunicados de Imprensa – Estilo formal de comunicação 10. Textos de Anúncios – Abordagem de mensagens pagas 11. Roteiros de Vídeo ou Transcrições de Podcast – Voz falada da marca

Use ferramentas de navegador ou o script analyze_page.py para acessar o conteúdo web. Para redes sociais, verifique o site em busca de links sociais e analise os perfis vinculados.

Etapa 2: Análise das Dimensões da Voz

Mapeie a voz da marca ao longo de quatro dimensões principais. Cada dimensão é um espectro, não um binário.

Dimensão 1: Formal <-----> Casual

Onde a marca se encontra no espectro de formalidade?

SinalFormalCasual
ContraçõesEvita-as ("não", "nunca")Usa-as livremente ("não", "nunca")
Estrutura de frasesComplexas, mais longasCurtas, contundentes
VocabulárioProfissional, padrão do setorColoquial, palavras do dia a dia
Saudações"Prezado cliente""Olá!"
PronomesTerceira pessoa ("a empresa", "o usuário")Primeira/segunda pessoa ("nós", "você")
HumorRaro ou ausenteFrequente, natural
Gírias/expressões coloquiaisNuncaOcasionalmente ou frequentemente

Pontuação: 1 (extremamente formal) a 10 (extremamente casual)

Evidência necessária: Cite de 3 a 5 exemplos específicos do material de origem que sustentem sua classificação.

Dimensão 2: Sério <-----> Lúdico

Quanta leveza a marca injeta em sua comunicação?

SinalSérioLúdico
TomAutoritário, comedidoDescontraído, divertido
MetáforasRaras, conservadorasCriativas, inesperadas
Pontos de exclamaçãoRarosFrequentes
Uso de emojisNuncaÀs vezes ou frequentemente
Trocadilhos/jogos de palavrasNuncaAprecia-os
Mensagens de erro"Ocorreu um erro""Ops! Algo saiu do lugar"
AutodepreciaçãoNuncaOcasionalmente

Pontuação: 1 (extremamente sério) a 10 (extremamente lúdico)

Dimensão 3: Técnico <-----> Simples

Quanto conhecimento de domínio a marca assume em seu público?

SinalTécnicoSimples
JargãoUsa termos do setor livrementeEvita ou explica todo jargão
SiglasUsa sem definiçãoExplica no primeiro uso
Nível de detalheExplicações aprofundadasVisões gerais em alto nível
Suposição do públicoPúblico especialistaPúblico geral
Dados/estatísticasFrequentes, detalhadosOcasional, simplificados
ExemplosComplexos, específicos do domínioAnalogias simples e relacionáveis

Pontuação: 1 (extremamente técnico) a 10 (extremamente simples)

Dimensão 4: Reservado <-----> Ousado

Quanta personalidade e confiança a marca projeta?

SinalReservadoOusado
AfirmaçõesCautelosas ("acreditamos", "pode ajudar")Diretas ("garantimos", "o melhor")
OpiniõesNeutras, equilibradasFortes, opinativas
Referências a concorrentesEvita mencionar concorrentesCompara diretamente
PersonalidadeProfissional, discretaMarcante, memorável
PromessasConservadorasAmbiciosas
PolêmicaEvitaAbraça quando alinhada com valores

Pontuação: 1 (extremamente reservado) a 10 (extremamente ousado)

Etapa 3: Mapeamento do Espectro de Tom

Além das quatro dimensões, mapeie como o tom da marca muda em diferentes contextos:

ContextoTom TípicoExemplo
Página inicial[Confiante/Acolhedor/Urgente/etc.]"[citação da página inicial]"
Descrição do produto[Informativo/Persuasivo/Técnico/etc.]"[citação]"
Post de blog[Educacional/Coloquial/Autoritário/etc.]"[citação]"
Redes sociais[Casual/Engajador/Promocional/etc.]"[citação]"
Página de erro/404[Pedido de desculpas/Humorístico/Útil/etc.]"[citação]"
Linhas de assunto de e-mail[Direto/Curioso/Urgente/etc.]"[citação]"
Botões CTA[Orientado à ação/Baseado em benefícios/Urgente/etc.]"[citação]"
Suporte ao cliente[Empático/Profissional/Amigável/etc.]"[citação]"

Etapa 4: Estrutura de Personalidade da Marca

Mapeie a marca para um dos cinco arquétipos principais de personalidade (as marcas podem combinar de 1 a 2):

Os 5 Arquétipos

1. A Autoridade

  • Características: Especialista, confiável, orientado a dados, estabelecido
  • Voz: Confiante, mas não arrogante, educacional, precisa
  • Setores: Finanças, saúde, B2B enterprise, direito, consultoria
  • Exemplos de marcas: McKinsey, IBM, Mayo Clinic
  • Frases-chave: "Pesquisas mostram...", "Nossos especialistas...", "Líder do setor..."

2. O Inovador

  • Características: Visionário, disruptivo, com visão de futuro, experiente em tecnologia
  • Voz: Empolgante, focada no futuro, às vezes provocativa
  • Setores: Tecnologia, SaaS, startups, energia renovável
  • Exemplos de marcas: Tesla, Stripe, Notion
  • Frases-chave: "Reimagine...", "O futuro de...", "Estamos construindo..."

3. O Amigo

  • Características: Caloroso, acessível, útil, relacionável
  • Voz: Coloquial, empático, inclusivo, encorajador
  • Setores: Produtos de consumo, educação, plataformas comunitárias
  • Exemplos de marcas: Mailchimp, Slack, Duolingo
  • Frases-chave: "Entendemos...", "Você consegue...", "Aqui para ajudar..."

4. O Rebelde

  • Características: Ousado, desafia convenções, irreverente, apaixonado
  • Voz: Direto, opinativo, às vezes confrontador, memorável
  • Setores: Estilo de vida, fitness, indústrias criativas, direct-to-consumer
  • Exemplos de marcas: Nike, Oatly, Cards Against Humanity
  • Frases-chave: "Pare de se contentar com...", "A verdade é...", "Chega de..."

5. O Guia

  • Características: Sábio, paciente, metódico, confiável
  • Voz: Claro, instrutivo, solidário, conhecedor
  • Setores: Educação, desenvolvimento profissional, ferramentas, plataformas
  • Exemplos de marcas: HubSpot, Khan Academy, Ahrefs
  • Frases-chave: "Veja como...", "Passo a passo...", "O guia completo para..."

Avaliação:

  • Arquétipo primário: [qual e por quê]
  • Arquétipo secundário: [se aplicável]
  • Adequação ao arquétipo: [Forte/Moderada/Fraca – o quão bem a marca incorpora este arquétipo?]

Etapa 5: Análise de Vocabulário

Identifique padrões nas escolhas de palavras da marca:

Palavras que Usam com Frequência

Analise todo o material de origem e identifique as 15 a 20 palavras ou frases mais características. Organize por categoria:

Palavras de ação: (verbos que favorecem)

  • ex.: "construir", "escalar", "transformar", "otimizar"

Palavras descritivas: (adjetivos que usam)

  • ex.: "poderoso", "simples", "nível enterprise", "sem esforço"

Palavras de valor: (palavras que refletem seus valores)

  • ex.: "transparente", "sustentável", "inclusivo", "inovador"

Termos específicos do setor:

  • ex.: "fluxo de trabalho", "pipeline", "conversão", "engajamento"

Palavras que Evitam

Identifique palavras que estão notavelmente ausentes ou que pareceriam fora de caráter:

  • Palavras muito casuais para a marca (se formal)
  • Palavras muito técnicas para a marca (se simples)
  • Terminologia de concorrentes que evitam deliberadamente
  • Clichês do setor que parecem evitar

Frases Marcantes

A marca tem frases recorrentes, slogans ou padrões linguísticos?

  • Slogan: [se tiver um]
  • Frases recorrentes: [padrões que você nota]
  • Padrões linguísticos: [ex.: sempre começa frases com verbos, usa travessões com frequência, favorece parágrafos curtos]

Etapa 6: Comparação de Voz com Concorrentes

Compare a voz da marca com 2 a 3 concorrentes principais:

Matriz de Comparação de Voz:

Dimensão[Marca]Concorrente 1Concorrente 2Concorrente 3
Formal <> CasualX/10X/10X/10X/10
Sério <> LúdicoX/10X/10X/10X/10
Técnico <> SimplesX/10X/10X/10X/10
Reservado <> OusadoX/10X/10X/10X/10
Arquétipo Primário[tipo][tipo][tipo][tipo]

Avaliação de Diferenciação:

  • Quão distinta é a voz da marca dos concorrentes?
  • Onde as vozes se sobrepõem? (oportunidade potencial de diferenciação)
  • Que território de voz está desocupado no cenário competitivo?
  • Recomendações específicas para diferenciação vocal

Etapa 7: Auditoria de Consistência

Avalie a consistência da voz em todos os canais analisados:

CanalConsistência da VozObservações
Página inicialConsistente/Na maior parte/Inconsistente[observações específicas]
Página Sobre NósConsistente/Na maior parte/Inconsistente[observações]
BlogConsistente/Na maior parte/Inconsistente[observações]
Redes sociaisConsistente/Na maior parte/Inconsistente[observações]
E-mailConsistente/Na maior parte/Inconsistente[observações]
Páginas de produtoConsistente/Na maior parte/Inconsistente[observações]

Problemas Comuns de Consistência:

  • Diferentes redatores criando tons visivelmente diferentes
  • Voz nas redes sociais drasticamente diferente do site
  • Texto formal no site, mas newsletters casuais
  • Conteúdo do blog escrito em voz completamente diferente das páginas de produto
  • Mensagens de erro ou microcópia que parecem fora da marca
  • Páginas antigas que não foram atualizadas para corresponder à voz atual da marca

Pontuação Geral de Consistência: X/10

Etapa 8: Hierarquia de Mensagens da Marca

Documente as mensagens da marca, da mais condensada à mais expandida:

Nível 1: Slogan (menos de 10 palavras)

A forma mais comprimida da mensagem da marca.

  • Atual: "[slogan existente ou sugerido]"
  • Avaliação: Ele captura a proposta de valor central?

Nível 2: Propostas de Valor (1 frase cada)

3 a 5 propostas de valor centrais que sustentam a promessa da marca.

  1. "[Proposta de valor 1]"
  2. "[Proposta de valor 2]"
  3. "[Proposta de valor 3]"

Nível 3: Elevator Pitch (30 segundos / 75 palavras)

Uma explicação coloquial do que a marca faz e por que é importante. "[Rascunho do elevator pitch com base no conteúdo analisado]"

Nível 4: Boilerplate (100-150 palavras)

O parágrafo padrão "sobre nós" usado em comunicados de imprensa, assinaturas de e-mail e bios de palestrantes. "[Rascunho do boilerplate com base no conteúdo analisado]"

Nível 5: História Completa da Marca (300-500 palavras)

A narrativa completa de quem é a marca, o que ela defende e por que existe.

  • Status atual: [Existe/Parcial/Ausente]
  • Recomendações para melhoria

Etapa 9: Gerar Documentação de Voz da Marca

Crie o guia abrangente de O que Fazer e O que Não Fazer:

Gráfico de Voz

NOSSA VOZ É:                    NOSSA VOZ NÃO É:
--------------------------------------------------
[Característica 1]              [Anticaracterística 1]
ex.: "Confiante"                ex.: "Arrogante"

[Característica 2]              [Anticaracterística 2]
ex.: "Útil"                     ex.: "Condescendente"

[Característica 3]              [Anticaracterística 3]
ex.: "Claro"                    ex.: "Simplificado demais"

[Característica 4]              [Anticaracterística 4]
ex.: "Ousado"                   ex.: "Agressivo"

O que Fazer e O que Não Fazer na Escrita

FAÇA:

  • [Instrução específica de escrita com base na análise]
  • [Exemplo: "Use contrações para soar natural (nós somos, você vai, é)"]
  • [Exemplo: "Comece pelo benefício, não pela funcionalidade"]
  • [Exemplo: "Use voz ativa em todos os títulos e CTAs"]
  • [Exemplo: "Dirija-se ao leitor diretamente com 'você' e 'seu'"]

NÃO FAÇA:

  • [Antipadrões específicos com base na análise]
  • [Exemplo: "Não use jargão sem explicá-lo"]
  • [Exemplo: "Não use voz passiva em chamadas para ação"]
  • [Exemplo: "Não use pontos de exclamação mais de uma vez por parágrafo"]
  • [Exemplo: "Não comece frases com 'Nós' – foque no cliente"]

Etapa 10: Amostras de Cópia na Voz Identificada

Forneça de 5 a 8 amostras de texto escritas na voz de marca identificada para que a equipe tenha exemplos concretos para referência:

1. Título da Página Inicial: "[Título de amostra na voz da marca]"

2. Parágrafo de Descrição do Produto: "[Descrição de produto de amostra na voz da marca]"

3. Abertura de Post de Blog: "[Introdução de blog de amostra na voz da marca]"

4. Postagem em Rede Social: "[Postagem social de amostra na voz da marca]"

5. Linha de Assunto de E-mail: "[Linha de assunto de amostra na voz da marca]"

6. Texto do Botão CTA: "[Texto de CTA de amostra na voz da marca]"

7. Mensagem de Erro: "[Mensagem de erro de amostra na voz da marca]"

8. Mensagem de Agradecimento ao Cliente: "[Mensagem de agradecimento de amostra na voz da marca]"

Formato de Saída

Gere um arquivo chamado BRAND-VOICE.md com:

# Diretrizes de Voz da Marca
## [Nome da Marca]
### Data da Análise: [Data]

---

## Resumo da Voz
[Resumo de 2 a 3 frases da voz da marca, personalidade e principais características]

---

## Dimensões da Voz

### Formal <-----> Casual: [X/10]
[Evidência e explicação]

### Sério <-----> Lúdico: [X/10]
[Evidência e explicação]

### Técnico <-----> Simples: [X/10]
[Evidência e explicação]

### Reservado <-----> Ousado: [X/10]
[Evidência e explicação]

### Mapa Visual da Voz

Formal Casual |----[X]----------------------------------| Sério Lúdico |----[X]----------------------------------| Técnico Simples |----[X]----------------------------------| Reservado Ousado |----[X]----------------------------------|


---

## Espectro de Tom

| Contexto | Tom | Exemplo |
|---|---|---|
| Página inicial | [...] | "[...]" |
| Descrição do produto | [...] | "[...]" |
| Post de blog | [...] | "[...]" |
| Redes sociais | [...] | "[...]" |
| Página de erro/404 | [...] | "[...]" |
| Linhas de assunto de e-mail | [...] | "[...]" |
| Botões CTA | [...] | "[...]" |
| Suporte ao cliente | [...] | "[...]" |

---

## Personalidade da Marca

**Arquétipo Primário:** [Tipo]
**Arquétipo Secundário:** [Tipo, se aplicável]
**Adequação:** [Forte/Moderada/Fraca]

**Características:**
- [Característica 1]
- [Característica 2]
- [Característica 3]

---

## Vocabulário

### Palavras Frequentes
**Ação:** [palavra 1], [palavra 2], [palavra 3]...
**Descritivas:** [palavra 1], [palavra 2], [palavra 3]...
**Valor:** [palavra 1], [palavra 2], [palavra 3]...
**Setor:** [termo 1], [termo 2], [termo 3]...

### Palavras a Evitar
- [Palavra 1]
- [Palavra 2]
- [Palavra 3]

### Frases Marcantes
- Slogan: "[...]"
- Frases recorrentes: "[...]"
- Padrões: [descrição]

---

## Comparação com Concorrentes

| Dimensão | [Marca] | [Concorrente 1] | [Concorrente 2] |
|---|---|---|---|
| Formal <> Casual | X/10 | X/10 | X/10 |
| Sério <> Lúdico | X/10 | X/10 | X/10 |
| Técnico <> Simples | X/10 | X/10 | X/10 |
| Reservado <> Ousado | X/10 | X/10 | X/10 |
| Arquétipo | [Tipo] | [Tipo] | [Tipo] |

**Diferenciação:** [Análise de como a marca se diferencia]

---

## Auditoria de Consistência

| Canal | Consistência | Observações |
|---|---|---|
| Página inicial | [Consistente/Na maior parte/Inconsistente] | [...] |
| Página Sobre Nós | [Consistente/Na maior parte/Inconsistente] | [...] |
| Blog | [Consistente/Na maior parte/Inconsistente] | [...] |
| Redes sociais | [Consistente/Na maior parte/Inconsistente] | [...] |
| E-mail | [Consistente/Na maior parte/Inconsistente] | [...] |
| Páginas de produto | [Consistente/Na maior parte/Inconsistente] | [...] |

**Pontuação Geral:** X/10

---

## Hierarquia de Mensagens

**Nível 1: Slogan**
"[...]"

**Nível 2: Propostas de Valor**
1. "[...]"
2. "[...]"
3. "[...]"

**Nível 3: Elevator Pitch**
"[...]"

**Nível 4: Boilerplate**
"[...]"

---

## Guia de Voz

### Gráfico de Voz

NOSSA VOZ É: NOSSA VOZ NÃO É: [Característica 1] [Anticaracterística 1] [Característica 2] [Anticaracterística 2] [Característica 3] [Anticaracterística 3]


### O que Fazer
- [Fazer 1]
- [Fazer 2]
- [Fazer 3]

### O que Não Fazer
- [Não fazer 1]
- [Não fazer 2]
- [Não fazer 3]

---

## Amostras de Cópia

**Título:** "[...]"
**Descrição do Produto:** "[...]"
**Abertura de Blog:** "[...]"
**Postagem Social:** "[...]"
**Linha de Assunto:** "[...]"
**CTA:** "[...]"
**Mensagem de Erro:** "[...]"
**Agradecimento:** "[...]"

---

*Gerado por [Nome da Ferramenta] em [Data]*

Habilidades Relacionadas