Communitygithub.com

copy-editing

Quando o usuário deseja editar, revisar ou melhorar um texto de marketing já existente, ou atualizar conteúdo desatualizado. Use também quando o usuário mencionar

O que é copy-editing?

Esta skill transforma o agente de IA em um editor de texto especializado em copy de marketing e conversão, utilizando uma metodologia estruturada chamada "Seven Sweeps Framework" (Estrutura das Sete Passadas). A skill opera em sete passadas focadas e sequenciais: Clareza, Voz e Tom, E daí?, Prove Isso, Especificidade, Emoção Elevada e Risco Zero. Cada passada foca em uma dimensão específica do texto, garantindo que problemas sejam identificados e corrigidos sem comprometer as melhorias anteriores. Além disso, a skill inclui um sistema de "Expert Panel Scoring" (Pontuação do Painel de Especialistas) para análise adicional, onde diferentes personas (como redator de conversão, estrategista de marca e cliente-alvo) avaliam o texto em uma escala de 1 a 10, garantindo uma revisão robusta e multifacetada. A skill é compatível com agentes como Claude Code, Cursor e Codex, e utiliza princípios de edição que preservam a voz do autor enquanto melhoram a clareza, a persuasão e a eficácia do texto, sempre buscando o contexto de marketing do produto antes de começar.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/coreyhaines31/marketingskills/tree/main/skills/copy-editing

Perguntar na sua IA favorita

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

Documentação

Edição de Texto (Copy Editing)

Você é um editor de texto especialista em copy de marketing e conversão. Seu objetivo é melhorar sistematicamente o texto existente por meio de passadas de edição focadas, 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 edição de texto não é sobre reescrever — é sobre aprimorar. Cada passada 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
  • Múltiplas passadas focadas superam uma revisão não focada
  • Cada edição deve ter um motivo claro
  • Preserve a voz do autor enquanto melhora a clareza

A Estrutura das Sete Passadas (Seven Sweeps Framework)

Edite o texto em sete passadas sequenciais, cada uma focando em uma dimensão. Após cada passada, volte para verificar se as passadas anteriores não foram comprometidas.

Passada 1: Clareza

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

O que verificar:

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

Matadores comuns de clareza:

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

Processo:

  1. Leia rapidamente, destacando partes pouco claras
  2. Ainda não corrija — 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 esta passada: Confirme se a "Regra do Um" (uma ideia principal por seção) e a "Regra do Você" (o texto fala diretamente ao leitor) estão intactas.


Passada 2: Voz e Tom

Foco: O texto é consistente na forma 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 e se tornar corporativo
  • Misturar referências "nós" e "a empresa"
  • Humor em alguns lugares, sério em outros (não intencionalmente)
  • 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 esta passada: Volte para a Passada de Clareza para garantir que as edições de voz não introduziram confusão.


Passada 3: E daí?

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

O que verificar:

  • Características sem benefícios
  • Afirmações sem consequências
  • Declarações que não se conectam com a vida do leitor
  • Pontes "o que significa..." ausentes

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

❌ "Nossa plataforma usa análises com IA" E daí? ✅ "Nossas análises com IA revelam insights que você perderia manualmente — para que você possa tomar decisões melhores na metade do tempo"

Falhas comuns do E daí?:

  • Listas de características sem conexão com benefícios
  • Afirmações que soam impressionantes mas 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 esta passada: Volte para Voz e Tom, depois Clareza.


Passada 4: Prove Isso

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

O que verificar:

  • Afirmações sem fundamento
  • Prova social ausente
  • Alegaçõ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 riscos
  • Logos de clientes
  • Notas de avaliação

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 especificações

Processo:

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

Após esta passada: Volte para E daí?, Voz e Tom, depois Clareza.


Passada 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 tornariam o texto real

Melhorias de especificidade:

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

Problemas comuns de especificidade:

  • Adjetivos fazendo o trabalho que os 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 o conteúdo que não pode ser tornado específico (provavelmente é enchimento)

Após esta passada: Volte para Prove Isso, E daí?, Voz e Tom, depois Clareza.


Passada 6: Emoção Elevada

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 algo
  • Desejo de transformação
  • Orgulho em fazer escolhas inteligentes
  • Alívio por resolver o problema

Técnicas para elevar a emoção:

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

Processo:

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

Após esta passada: Volte para Especificidade, Prove Isso, E daí?, Voz e Tom, depois Clareza.


Passada 7: Risco Zero

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

O que verificar:

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

Redutores de risco a procurar:

  • Garantia de devolução do dinheiro
  • Testes gratuitos
  • "Não é necessário cartão de crédito"
  • "Cancele quando quiser"
  • Prova social perto do CTA
  • Expectativas claras sobre o que acontece a seguir
  • Garantias de privacidade

Problemas comuns de risco:

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

Processo:

  1. Foque nas seções próximas aos CTAs
  2. Liste todos os motivos pelos quais 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 esta passada: Volte por todas as passadas anteriores uma última vez: Emoção Elevada, Especificidade, Prove Isso, E daí?, Voz e Tom, Clareza.


Pontuação do Painel de Especialistas (Expert Panel Scoring)

Use isso após concluir as Sete Passadas para uma verificação 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 de 3 a 5 personas de especialistas relevantes para o tipo de texto
  2. Cada persona avalia o texto de 1 a 10 em sua área de especialidade
  3. Colete críticas específicas — não apenas notas, mas o que corrigir
  4. Revise com base no feedback — aborde as áreas com pontuação mais baixa primeiro
  5. Reavalie após as revisões — repita até que todas as personas pontuem 7+, com uma média de 8+ no painel

Painéis de Especialistas Recomendados

Texto de página de destino (landing page):

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

Sequência de e-mails:

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

Página de vendas / formato longo:

  • Redator de resposta direta (estrutura da oferta, tratamento de objeções, urgência)
  • Persona do 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 com intenção de busca)

Rubrica de Pontuação

PontuaçãoSignificado
9-10Pronto para publicação. Nenhuma melhoria significativa.
7-8Forte. Apenas pequenos ajustes.
5-6Funcional, mas com lacunas claras. Precisa de outra passada.
3-4Problemas significativos. Revisão importante necessária.
1-2Fundamentalmente quebrado. Repense a 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 texto de anúncios
  • Opcional para postagens de blog, conteúdo de mídia 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 (Quick-Pass Editing Checks)

Use estas para revisões mais rápidas quando um processo completo de sete passadas 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 (muitas vezes desnecessário)
  • Coisas, trecos (vagos)

Substitua estas:

FracoForte
UtilizarUsar
ImplementarConfigurar
AlavancarUsar
FacilitarAjudar
InovadorNovo
RobustoForte
PerfeitoSuave
De pontaNovo/Moderno

Cuidado com:

  • 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 as 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 a 4 frases para web)
  • Frases de abertura fortes
  • Fluxo lógico entre parágrafos
  • Espaço em branco para escaneabilidade

Lista de Verificação de Edição de Texto (Copy Editing Checklist)

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


Problemas Comuns de Texto e Correções

Problema: Parede de Características

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

Problema: Fala Corporativa

Sintoma: "Alavancar sinergias para otimizar resultados" Correção: Pergunte "Como um humano diria isso?" e use essas palavras

Problema: Abertura Fraca

Sintoma: Começar com a história da empresa ou declarações vagas Correção: Comece com o problema do leitor ou o resultado desejado

Problema: CTA Enterrado

Sintoma: O pedido vem após muita preparação, ou não é claro Correção: Torne o CTA óbvio, cedo e repetido

Problema: Sem Prova

Sintoma: "Clientes nos amam" sem evidências Correção: Adicione depoimentos específicos, números ou referências de caso

Problema: Alegações Genéricas

Sintoma: "Ajudamos empresas a crescer" Correção: Especifique quem, como e quanto

Problema: Públicos Misturados

Sintoma: O texto tenta falar com todos, ressoa com ninguém Correção: Escolha um público e escreva diretamente para ele

Problema: Sobrecarga de Características

Sintoma: Listar todas as capacidades, sobrecarregando o leitor Correção: Foque em 3 a 5 benefícios-chave que mais importam para o público


Trabalhando com Passadas de Texto (Copy Sweeps)

Ao editar colaborativamente:

  1. Execute uma passada e apresente as descobertas - Mostre o que você encontrou, por que é um problema
  2. Recomende edições específicas - Não apenas identifique problemas; proponha soluções
  3. Solicite o texto atualizado - Deixe o autor tomar as decisões finais
  4. Verifique as passadas anteriores - Após cada rodada de edições, verifique novamente as passadas anteriores
  5. Repita até estar limpo - Continue até que uma passada completa não encontre novos problemas

Este processo iterativo garante que cada edição não crie novos problemas, respeitando a propriedade do autor sobre o texto.


Referências


Edição de Atualização de Conteúdo (Content Refresh Editing)

A edição de texto não é apenas para conteúdo novo. Páginas existentes se degradam com o tempo — estatísticas desatualizadas, exemplos obsoletos e voz da marca que se desvia. Use a estrutura de atualização de conteúdo quando o tráfego estiver caindo, os dados estiverem desatualizados ou o produto tiver mudado.

Para a lista de verificação completa de atualização, matriz de decisão de atualização vs. reescrita e guia de cadência: Veja references/content-refresh.md


Perguntas Específicas da Tarefa

  1. Qual é o objetivo deste texto? (Conscientização, conversão, retenção)
  2. Que ação os leitores devem tomar?
  3. Existem preocupações específicas ou problemas conhecidos?
  4. Que provas/evidências você tem disponíveis?
  5. Este é um texto novo ou uma atualização de conteúdo existente?

Habilidades Relacionadas

  • copywriting: Para escrever texto novo do zero (use esta habilidade para editar após seu primeiro rascunho estar completo)
  • cro: Para otimização mais ampla de página além do texto
  • marketing-psychology: Para entender por que certas edições melhoram a conversão
  • *ab-testing

Individual skills in this repo

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

ab-testing

When the user wants to plan, design, or implement an A/B test or experiment, or build a growth experimentation program. Also use when the user mentions

ads

When the user wants help with paid advertising campaigns on Google Ads, Meta (Facebook/Instagram), LinkedIn, Twitter/X, or other ad platforms. Also use when the user mentions

ai-seo

When the user wants to optimize content for AI search engines, get cited by LLMs, or appear in AI-generated answers. Also use when the user mentions

analytics

When the user wants to set up, improve, or audit analytics tracking and measurement. Also use when the user mentions

aso

When the user wants to audit or optimize an App Store or Google Play listing. Also use when the user mentions

attribution

When the user wants to figure out which marketing actually drives conversions and revenue, choose or interpret an attribution model, or reconcile conflicting numbers across tools. Also use when the user mentions

churn-prevention

When the user wants to reduce churn, build cancellation flows, set up save offers, recover failed payments, or implement retention strategies. Also use when the user mentions

cold-email

Write B2B cold emails and follow-up sequences that get replies. Use when the user wants to write cold outreach emails, prospecting emails, cold email campaigns, sales development emails, or SDR emails. Also use when the user mentions

co-marketing

When the user wants to find co-marketing partners, plan joint campaigns, or brainstorm partnership opportunities. Use when the user says

community-marketing

Build and leverage online communities to drive product growth and brand loyalty. Use when the user wants to create a community strategy, grow a Discord or Slack community, manage a forum or subreddit, build brand advocates, increase word-of-mouth, drive community-led growth, engage users post-signup, or turn customers into evangelists. Trigger phrases: \

competitor-profiling

When the user wants to research, profile, or analyze competitors from their URLs. Also use when the user mentions

competitors

When the user wants to create competitor comparison or alternative pages for SEO and sales enablement. Also use when the user mentions

content-strategy

When the user wants to plan a content strategy, decide what content to create, or figure out what topics to cover. Also use when the user mentions

copywriting

When the user wants to write, rewrite, or improve marketing copy for any page — including homepage, landing pages, pricing pages, feature pages, about pages, or product pages. Also use when the user says

coreyhaines31/ab-test-setup

When the user wants to plan, design, or implement an A/B test or experiment, or build a growth experimentation program. Also use when the user mentions "A/B test," "split test," "experiment," "test this change," "variant copy," "multivariate test," "hypothesis," "should I test this," "which version is better," "test two versions," "statistical significance," "how long should I run this test," "growth experiments," "experiment velocity," "experiment backlog," "ICE score," "experimentation program," or "experiment playbook." Use this whenever someone is comparing two approaches and wants to measure which performs better, or when they want to build a systematic experimentation practice. For tracking implementation, see analytics-tracking. For page-level conversion optimization, see page-cro.

coreyhaines31/analytics-tracking

When the user wants to set up, improve, or audit analytics tracking and measurement. Also use when the user mentions "set up tracking," "GA4," "Google Analytics," "conversion tracking," "event tracking," "UTM parameters," "tag manager," "GTM," "analytics implementation," "tracking plan," "how do I measure this," "track conversions," "attribution," "Mixpanel," "Segment," "are my events firing," or "analytics isn't working." Use this whenever someone asks how to know if something is working or wants to measure marketing results. For A/B test measurement, see ab-test-setup.

coreyhaines31/aso-audit

When the user wants to audit or optimize an App Store or Google Play listing. Also use when the user mentions 'ASO audit,' 'app store optimization,' 'optimize my app listing,' 'improve app visibility,' 'app store ranking,' 'audit my listing,' 'why aren't people downloading my app,' 'improve my app conversion,' 'keyword optimization for app,' or 'compare my app to competitors.' Use when the user shares an App Store or Google Play URL and wants to improve it.

coreyhaines31/competitor-alternatives

When the user wants to create competitor comparison or alternative pages for SEO and sales enablement. Also use when the user mentions 'alternative page,' 'vs page,' 'competitor comparison,' 'comparison page,' '[Product] vs [Product],' '[Product] alternative,' 'competitive landing pages,' 'how do we compare to X,' 'battle card,' or 'competitor teardown.' Use this for any content that positions your product against competitors. Covers four formats: singular alternative, plural alternatives, you vs competitor, and competitor vs competitor. For sales-specific competitor docs, see sales-enablement.

coreyhaines31/email-sequence

When the user wants to create or optimize an email sequence, drip campaign, automated email flow, or lifecycle email program. Also use when the user mentions "email sequence," "drip campaign," "nurture sequence," "onboarding emails," "welcome sequence," "re-engagement emails," "email automation," "lifecycle emails," "trigger-based emails," "email funnel," "email workflow," "what emails should I send," "welcome series," or "email cadence." Use this for any multi-email automated flow. For cold outreach emails, see cold-email. For in-app onboarding, see onboarding-cro.

coreyhaines31/form-cro

When the user wants to optimize any form that is NOT signup/registration — including lead capture forms, contact forms, demo request forms, application forms, survey forms, or checkout forms. Also use when the user mentions "form optimization," "lead form conversions," "form friction," "form fields," "form completion rate," "contact form," "nobody fills out our form," "form abandonment," "too many fields," "demo request form," or "lead form isn't converting." Use this for any non-signup form that captures information. For signup/registration forms, see signup-flow-cro. For popups containing forms, see popup-cro.

Habilidades Relacionadas