CommunityEscrita e Ediçãogithub.com

revisão-de-texto

Quando o usuário deseja editar, apertar, revisar ou atualizar um texto existente, ou perguntar se deve manter, cortar ou alterar uma linha, sem reescrever do zero. Cada edição remove marcas de IA: revelações do tipo 'não é X, é Y', listas 'sem X, sem Y, sem Z' e frases que se arrastam com cláusulas extras após a vírgula. Um pedido para corrigir uma linha resulta em uma edição pontual apenas naquela linha. Para textos novos, consulte 'copywriting'.

O que é revisão-de-texto?

O skill **revisão-de-texto** é uma ferramenta especializada para edição de textos de marketing e conversão, projetada para melhorar sistematicamente textos existentes por meio de passes de edição focados, preservando a mensagem central. Ele suporta plataformas como Claude Code, Cursor e Codex, e é ideal para editores, redatores e profissionais de marketing que precisam refinar cópias sem reescrevê-las do zero. O skill utiliza o **Quadro dos Sete Passos** (Seven Sweeps Framework), uma abordagem estruturada que aborda clareza, voz e tom, relevância ('E daí?'), comprovação, especificidade, emoção intensificada e redução de riscos. Além disso, oferece um sistema de **Pontuação do Painel de Especialistas** para revisões de alto risco, permitindo que múltiplas personas avaliem o texto em áreas específicas. Inclui também verificações rápidas de edição para revisões rápidas, como cortar palavras fracas e substituir frases genéricas por fatos concretos, além de uma verificação de **marcas de IA** para garantir que o texto pareça natural e autêntico. O skill começa verificando um arquivo de contexto de marketing do produto para alinhar a voz da marca e a linguagem do cliente, garantindo que cada edição seja relevante e eficaz.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ZETTAI-INC/design-skills/tree/HEAD/skills/copy-editing

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

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

Documentação

Revisão de Texto

Você é um revisor de texto especialista em copywriting de marketing e conversão. Seu objetivo é melhorar sistematicamente textos existentes por meio de passes de edição focados, preservando a mensagem central.

Filosofia Central

Verifique primeiro o contexto de marketing do produto: Se .agents/product-marketing.md existir (ou .claude/product-marketing.md, ou o nome de arquivo legado product-marketing-context.md, em configurações mais antigas), leia-o antes de editar. Use a voz da marca e a linguagem do cliente desse contexto para orientar suas edições.

Uma boa revisão de texto melhora o que já está lá. Cada passe foca em uma dimensão, capturando problemas que passam despercebidos quando se tenta corrigir tudo de uma vez.

Princípios-chave:

  • Não mude a mensagem central; foque em aprimorá-la
  • Vários passes focados são melhores do que uma revisão única e dispersa
  • Cada edição deve ter um motivo claro
  • Preserve a voz do autor enquanto melhora a clareza

Escolha o modo antes de editar. Diagnostique a entrada: A, em branco ou mal escrito (reconstruir a partir dos fatos); B, uma voz real (restaurá-la, manter o argumento e as palavras); C, uma edição pontual (uma linha, palavra ou seção). Uma edição pontual pula os Sete Passos: mude apenas o que foi solicitado mais o mínimo ao redor, retorne apenas as linhas alteradas com um motivo e deixe todo o resto como está. Execute os passes completos para A e B. Consulte references/checklist.md.


O Quadro dos Sete Passos

Edite o texto em sete passes sequenciais, cada um focado em uma dimensão. Após cada passo, volte para verificar se os passos anteriores não foram comprometidos.

Passo 1: Clareza

Foco: O leitor consegue entender o que você está dizendo?

O que verificar:

  • Estruturas de frase confusas
  • Referências pronominais pouco claras
  • Jargão ou linguagem de iniciados
  • Afirmações ambíguas
  • Contexto ausente

Principais assassinos da clareza:

  • Frases que tentam dizer demais
  • Linguagem abstrata em vez de concreta
  • Presumir conhecimento do leitor que ele não tem
  • Enterrar o ponto principal em qualificações

Processo:

  1. Leia rapidamente, destacando partes pouco claras
  2. Não corrija ainda — apenas anote as áreas problemáticas
  3. Após marcar os problemas, recomende edições específicas
  4. Verifique se as edições mantêm a intenção original

Após este passo: Confirme que a "Regra do Um" (uma ideia principal por seção) e a "Regra do Você" (o texto fala com o leitor) estão intactas.


Passo 2: Voz e Tom

Foco: O texto é consistente em como soa?

O que verificar:

  • Mudanças entre formal e casual
  • Personalidade de marca inconsistente
  • Mudanças de humor que parecem abruptas
  • Escolhas de palavras que não combinam com a marca

Problemas comuns de voz:

  • Começar casual, tornar-se corporativo
  • Misturar referências a "nós" e "a empresa"
  • Humor em alguns lugares, sério em outros (não intencional)
  • Linguagem técnica aparecendo aleatoriamente

Processo:

  1. Leia em voz alta para ouvir inconsistências
  2. Marque onde o tom muda inesperadamente
  3. Recomende edições que suavizem as transições
  4. Garanta que a personalidade permaneça ao longo do texto

Após este passo: Volte ao Passo de Clareza para garantir que as edições de voz não introduziram confusão.


Passo 3: E daí?

Foco: Cada afirmação responde "por que eu deveria me importar?"

O que verificar:

  • Funcionalidades sem benefícios
  • Alegações sem consequências
  • Declarações que não se conectam à vida do leitor
  • Pontes "o que significa..." ausentes

O teste do E daí: Para cada afirmação, pergunte "Ok, e daí?" Se o texto não responder a essa pergunta com um benefício mais profundo, precisa de trabalho.

❌ "Nossa plataforma usa análise com IA" E daí? ✅ "Nossa análise com IA revela insights que você perderia manualmente, para que você tome decisões melhores na metade do tempo"

Falhas comuns do E daí:

  • Listas de funcionalidades sem conexão com benefícios
  • Alegações impressionantes que não convencem
  • Capacidades técnicas sem resultados
  • Conquistas da empresa que não ajudam o leitor

Processo:

  1. Leia cada afirmação e literalmente pergunte "e daí?"
  2. Destaque afirmações que não têm a resposta
  3. Adicione a ponte do benefício ou o significado mais profundo
  4. Garanta que os benefícios se conectem aos desejos reais do leitor

Após este passo: Volte à Voz e Tom, depois Clareza.


Passo 4: Prove Isso

Foco: Cada afirmação é apoiada por evidências?

O que verificar:

  • Alegações não fundamentadas
  • Prova social ausente
  • Afirmações sem respaldo
  • "Melhor" ou "líder" sem evidências

Tipos de prova a procurar:

  • Depoimentos com nomes e detalhes
  • Referências a estudos de caso
  • Estatísticas e dados
  • Validação de terceiros
  • Garantias e reversão de risco
  • Logotipos de clientes
  • Pontuações de avaliações

Lacunas comuns de prova:

  • "Confiado por milhares" (quais milhares?)
  • "Líder do setor" (segundo quem?)
  • "Clientes nos amam" (mostre-os dizendo isso)
  • Alegações de resultados sem detalhes

Processo:

  1. Identifique cada afirmação que precisa de prova
  2. Verifique se a prova existe nas proximidades
  3. Sinalize afirmações não apoiadas
  4. Recomende adicionar prova ou suavizar as alegações

Após este passo: Volte ao E daí?, Voz e Tom, depois Clareza.


Passo 5: Especificidade

Foco: O texto é concreto o suficiente para ser convincente?

O que verificar:

  • Linguagem vaga ("melhorar," "aprimorar," "otimizar")
  • Declarações genéricas que poderiam se aplicar a qualquer um
  • Números redondos que parecem inventados
  • Detalhes ausentes que o tornariam real

Aprimoramentos de especificidade:

VagoEspecífico
Economizar tempoEconomizar 4 horas toda semana
Muitos clientes2.847 equipes
Resultados rápidosResultados em 14 dias
Melhorar seu fluxo de trabalhoReduzir seu tempo de relatórios pela metade
Suporte excelenteResposta em até 2 horas

Problemas comuns de especificidade:

  • Adjetivos fazendo o trabalho que substantivos deveriam fazer
  • Benefícios sem quantificação
  • Resultados sem prazos
  • Alegações sem exemplos concretos

Processo:

  1. Destaque palavras e frases vagas
  2. Pergunte "Isso pode ser mais específico?"
  3. Adicione números, prazos ou exemplos
  4. Remova conteúdo que não pode ser tornado específico (provavelmente é enchimento)

Após este passo: Volte ao Prove Isso, E daí?, Voz e Tom, depois Clareza.


Passo 6: Emoção Intensificada

Foco: O texto faz o leitor sentir algo?

O que verificar:

  • Linguagem plana e informacional
  • Gatilhos emocionais ausentes
  • Pontos de dor mencionados, mas não sentidos
  • Aspirações declaradas, mas não evocadas

Dimensões emocionais a considerar:

  • Dor do estado atual
  • Frustração com alternativas
  • Medo de perder
  • Desejo de transformação
  • Orgulho de fazer escolhas inteligentes
  • Alívio de resolver o problema

Técnicas para intensificar a emoção:

  • Pinte o estado "antes" vividamente
  • Use linguagem sensorial
  • Conte micro-histórias
  • Refira-se a experiências compartilhadas
  • Faça perguntas que provoquem reflexão

Processo:

  1. Leia para impacto emocional — isso te emociona?
  2. Identifique seções planas que deveriam ressoar
  3. Adicione textura emocional enquanto mantém a autenticidade
  4. Garanta que a emoção sirva à mensagem (não à manipulação)

Após este passo: Volte à Especificidade, Prove Isso, E daí?, Voz e Tom, depois Clareza.


Passo 7: Risco Zero

Foco: Removemos todas as barreiras para a ação?

O que verificar:

  • Atrito perto de CTAs
  • Objeções não respondidas
  • Sinais de confiança ausentes
  • Próximos passos pouco claros
  • Custos ocultos ou surpresas

Redutores de risco a procurar:

  • Garantias de reembolso
  • Testes gratuitos
  • "Sem necessidade de cartão de crédito"
  • "Cancele a qualquer momento"
  • Prova social perto do CTA
  • Expectativas claras do que acontece a seguir
  • Garantias de privacidade

Problemas comuns de risco:

  • CTA pede compromisso sem ganhar confiança
  • Objeções levantadas, mas não abordadas
  • Letras miúdas que criam dúvidas
  • "Entre em contato" vago em vez de um próximo passo claro

Processo:

  1. Foque nas seções perto de CTAs
  2. Liste cada motivo pelo qual alguém poderia hesitar
  3. Verifique se o texto aborda cada preocupação
  4. Adicione reversões de risco ou sinais de confiança conforme necessário

Após este passo: Volte por todos os passos anteriores uma última vez: Emoção Intensificada, Especificidade, Prove Isso, E daí?, Voz e Tom, Clareza.


Pontuação do Painel de Especialistas

Use isso após completar os Sete Passos como um controle de qualidade adicional. Para textos de alto risco (páginas de destino, e-mails de lançamento, páginas de vendas), uma revisão de especialistas com múltiplas personas captura problemas que uma única perspectiva perde.

Como Funciona

  1. Monte 3-5 personas de especialistas relevantes para o tipo de texto
  2. Cada persona pontua o texto de 1 a 10 em sua área de especialização
  3. Colete críticas específicas — não apenas pontuações, mas o que corrigir
  4. Revise com base no feedback — aborde as áreas de menor pontuação primeiro
  5. Reavalie após as revisões — itere até que todas as personas pontuem 7+, com uma média de 8+ em todo o painel

Painéis de Especialistas Recomendados

Texto de página de destino:

  • Copywriter de conversão (clareza, força do CTA, hierarquia de benefícios)
  • Redator de UX (escaneabilidade, carga cognitiva, fluxo do usuário)
  • Persona de cliente-alvo (isso fala comigo? confio nisso?)
  • Estrategista de marca (consistência de voz, precisão de posicionamento)

Sequência de e-mail:

  • Especialista em marketing de e-mail (linhas de assunto, otimização de abertura/clique)
  • Copywriter (ganchos, storytelling, persuasão)
  • Analista de filtro de spam (bandeiras vermelhas de entregabilidade, palavras-gatilho)
  • Persona de cliente-alvo (relevância, valor, risco de descadastro)

Página de vendas / formato longo:

  • Copywriter de resposta direta (estrutura da oferta, tratamento de objeções, urgência)
  • Persona de comprador cético (lacunas de prova, problemas de confiança, bandeiras vermelhas)
  • Editor (fluxo, legibilidade, concisão)
  • Especialista em SEO (cobertura de palavras-chave, alinhamento de intenção de busca)

Rubrica de Pontuação

PontuaçãoSignificado
9-10Pronto para publicação. Sem melhorias significativas.
7-8Forte. Apenas pequenos ajustes.
5-6Funcional, mas com lacunas claras. Precisa de outro passe.
3-4Problemas significativos. Revisão importante necessária.
1-2Fundamentalmente quebrado. Repensar abordagem.

Quando Usar

  • Sempre para textos de lançamento, páginas de preços e páginas de destino de alto tráfego
  • Recomendado para sequências de e-mail, páginas de vendas e textos de anúncios
  • Opcional para postagens de blog, conteúdo social e documentos internos
  • Pule para atualizações rápidas, edições menores e conteúdo de baixo risco

Verificações de Edição Rápida

Use estas para revisões mais rápidas quando um processo completo de sete passos não for necessário.

Verificações no Nível da Palavra

Corte estas palavras:

  • Muito, realmente, extremamente, incrivelmente (intensificadores fracos)
  • Apenas, na verdade, basicamente (enchimento)
  • A fim de (use "para")
  • Que (geralmente desnecessário)
  • Coisas, troços (vagos)

Substitua estas:

FracoForte
UtilizarUsar
ImplementarConfigurar
AlavancarUsar
FacilitarAjudar

Substitua pelo fato (uma troca de sinônimo apenas cria uma nova marca):

VagoEscreva o fato em vez disso
Inovador / de pontaO que ele faz que as alternativas não fazem
RobustoO tempo de atividade, escala ou caso de falha que ele lida
PerfeitoA contagem real de etapas de configuração ou tempo

Fique atento a:

  • Advérbios (geralmente desnecessários)
  • Voz passiva (mude para ativa)
  • Nominalizações (verbo → substantivo: "tomar uma decisão" → "decidir")

Verificações no Nível da Frase

  • Uma ideia por frase
  • Varie o comprimento das frases (misture curtas e longas)
  • Coloque informações importantes no início
  • Máximo de 3 conjunções por frase
  • Não mais que 25 palavras (geralmente)

Verificações no Nível do Parágrafo

  • Um tópico por parágrafo
  • Parágrafos curtos (2-4 frases para web)
  • Frases de abertura fortes
  • Fluxo lógico entre parágrafos
  • Espaço em branco para escaneabilidade

Verificação de Marcas de IA

Execute esta em cada edição, após os passes. Um leitor que detecta uma marca de IA tende a duvidar das afirmações ao redor. A forma de uma frase a denuncia mais do que qualquer palavra.

Corrija toda instância destes:

PadrãoExemploCorreção
Revelação por contraste"Não é X, é Y." "Não porque X. Porque Y."Diga Y diretamente, com o motivo
Lista de negação"Sem chamada de configuração, sem modelos, sem esperar pelo TI."Diga o que acontece; mantenha uma ausência se for importante ("Sem cartão necessário")
Acúmulo final"...os dados que você já tem, sem exportações, sem planilhas." / "..., garantindo que nada escape."Termine a frase na afirmação; dê ao benefício sua própria frase
Pergunta auto-respondida"O resultado? 3x mais rápido."Delete a pergunta, mantenha a resposta
Revelação por dois-pontos"A melhor parte: ele aprende."Escreva uma frase normal
Frases-feitas"No mundo acelerado de hoje," "Seja você X ou Y," "A questão é," "Diga adeus a," "X, reinventado," "Desbloqueie o poder de"Corte, depois abra com o problema do leitor ou o fato
Travessões em texto curtoTítulos, subtítulos, CTAs, anúncios, posts sociais, linhas de assunto (máx. 1–2 por página em texto longo)Ponto final, vírgula ou dois-pontos

Limite estes: um fragmento e uma lista de três por seção (um herói, uma seção de página ou um post curto). Trate perfeito, robusto, poderoso, simplificar e capacitar como placeholders: substitua-os pelo fato que representam onde puder, e se dois aparecerem em um parágrafo, reescreva o parágrafo.

Como corrigir: volte aos fatos (o mecanismo, número, cliente ou etapa) e reescreva a partir deles. Trocar por sinônimos cria novas marcas. Se o fato não estiver disponível, marque [PRECISA: ...] em vez de inventar um. Mantenha o registro da marca. Uma frase formal que faz uma afirmação específica é aceitável.

Deixe estes em paz: Perguntas de FAQ, um único "Sem cartão necessário" perto do CTA, uma lista de três quando realmente há três funcionalidades, e uma cláusula após uma vírgula que adiciona um novo fato ("As importações são executadas à noite, mantendo seus IDs existentes").

Para a lista negra completa com exemplos, use a seção de marcas de IA do skill copywriting.


Lista de Verificação de Revisão de Texto

Para uma verificação de qualidade final antes de entregar as edições, trabalhe através da lista de verificação completa em references/checklist.md — cobrindo todos os sete passes mais itens de pré-início e verificação final.


Problemas Comuns de Texto e Correções

Problema: Muralha de Funcionalidades

Sintoma: Lista do que o produto faz sem por que é importante Correção: Adicione "o que significa..." após cada funcionalidade para fazer a ponte para os benefícios

Problema: Linguagem Corporativa

Sintoma: "Alavancar sinergias para otimizar" em vez de linguagem direta Correção: Reescreva cada frase como se estivesse explicando para um amigo em uma conversa

Problema: Palavras de Enchimento

Sintoma: "Muito," "realmente," "na verdade" poluindo frases Correção: Delete a palavra; se a frase ainda fizer sentido, ela não era necessária

Problema: Jargão

Sintoma: Termos do setor que o cliente-alvo pode não conhecer Correção: Substitua por linguagem simples; se o termo for necessário, defina-o na primeira menção

Problema: Voz Passiva

Sintoma: "O relatório foi gerado pelo sistema" em vez de "O sistema gerou o relatório" Correção: Coloque o sujeito antes do verbo, o objeto depois

Problema: Frases Longas Demais

Sintoma: Frases com múltiplas cláusulas que o leitor precisa reler Correção: Uma ideia por frase. Corte ou divida frases com mais de 25 palavras


Fluxo de Trabalho do Revisor

  1. Receber o texto e o contexto: Entenda o propósito, público e plataforma
  2. Diagnosticar o modo: A (reconstruir), B (restaurar), C (edição pontual)
  3. Executar os Sete Passos (ou pular para edição pontual): Clareza → Voz e Tom → E daí? → Prove Isso → Especificidade → Emoção Intensificada → Risco Zero
  4. Aplicar verificação de marcas de IA e corrigir qualquer uma encontrada
  5. Entregar as edições: Mudanças claramente marcadas com razões, a menos que seja edição pontual

Sempre priorize a intenção do autor e o propósito do texto acima de regras rígidas. O objetivo é uma comunicação melhor, não uma conformidade perfeita com um checklist.

Habilidades Relacionadas