copy-editing

Visão geral do copy-editing skill

O que o copy-editing skill faz

O copy-editing skill é um fluxo de edição voltado para marketing, criado para melhorar textos já existentes sem substituir a mensagem original. Ele foi pensado para pedidos como “edite este texto”, “revise isto”, “deixe isso mais claro”, “avalie minha landing page” e solicitações parecidas, em que o rascunho já existe e o objetivo é chegar a uma copy mais clara, legível e persuasiva.

Diferente de um prompt genérico de reescrita, este copy-editing skill usa passagens editoriais focadas. O SKILL.md original se baseia em um framework de sete varreduras que cobre clareza, voz, tom, concisão, fluxo, persuasão e acabamento, com o lembrete de revisar novamente quando uma alteração enfraquecer outra.

Melhor uso para equipes de Copywriting e marketing

Este skill é uma boa escolha para copywriters, profissionais de marketing, founders, product marketers e equipes de conteúdo que editam landing pages, campanhas de email, anúncios, seções de site, copy de lançamento, páginas de venda ou mensagens de marketing dentro do produto. Ele é especialmente útil quando você quer feedback prático de copy antes de reescrever tudo.

O skill também verifica primeiro se há contexto de product marketing: se .claude/product-marketing-context.md existir, ele deve usar aquela linguagem de marca, posicionamento e cliente antes de editar. Isso o torna mais prático para equipes que já têm um guia de voz ou uma fonte de verdade para mensagens.

Por que ele vai além da revisão de texto

O principal diferencial é a disciplina de fazer passagens separadas. Em vez de corrigir gramática, tom e lógica de conversão ao mesmo tempo, o skill orienta o agente a analisar uma dimensão por vez e explicar por que as mudanças importam. Os arquivos de apoio acrescentam profundidade prática: references/plain-english-alternatives.md ajuda a substituir linguagem inflada, enquanto scripts/readability_scorer.py e scripts/ai_content_detector.py podem sinalizar problemas de legibilidade, enchimento, voz passiva, ritmo monótono e frases comuns com cara de IA.

Quando este skill não é a escolha certa

Não instale copy-editing se sua principal necessidade for gerar um primeiro rascunho, criar estratégia de SEO long-form, fazer revisão jurídica, estruturar documentação técnica ou construir posicionamento de marca do zero. Ele funciona melhor quando a mensagem, o público e o rascunho já estão definidos. Se esses elementos ainda não existem, você terá resultados melhores criando primeiro um briefing e depois usando este skill na etapa de edição.

Como usar o copy-editing skill

Instalação do copy-editing e caminho do repositório

Instale o skill a partir do repositório no GitHub com:

npx skills add alirezarezvani/claude-skills --skill copy-editing

O código-fonte fica em marketing-skill/skills/copy-editing, em https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/skills/copy-editing. Comece lendo SKILL.md; depois, examine os dois arquivos de referência e os dois scripts:

• references/plain-english-alternatives.md
• references/ai-detection-patterns.md
• scripts/readability_scorer.py
• scripts/ai_content_detector.py

O arquivo principal do próprio skill é o guia operacional central; os arquivos de apoio são úteis quando você quer verificações mensuráveis ou uma passagem mais forte de linguagem simples.

Entradas que melhoram o uso do copy-editing

Para obter melhores resultados, entregue ao agente o rascunho, o leitor-alvo, a oferta, o canal, a ação desejada, as restrições de tom e o que não pode mudar. Um prompt fraco seria: “Dê um polimento nesta copy.” Um prompt mais forte seria:

Use the copy-editing skill to edit this homepage hero for startup founders evaluating accounting software. Keep the core promise and product name unchanged. Improve clarity, reduce hype, make the CTA more specific, and preserve a confident but plain-spoken tone. Show the revised copy first, then list the top five edits and why they matter.

Isso dá ao skill contexto suficiente para preservar a intenção enquanto melhora a execução.

Fluxo de trabalho sugerido para sessões reais de edição

Use o guia de copy-editing em etapas. Primeiro, peça apenas um diagnóstico: o que está pouco claro, inflado, fora da voz da marca ou fraco do ponto de vista de conversão? Depois, solicite uma versão revisada usando a abordagem das sete varreduras. Em seguida, peça um registro de alterações para poder aceitar ou rejeitar edições com mais critério.

Para materiais maiores, divida o trabalho por seção: hero, provas, funcionalidades, objeções, FAQ, CTA. Isso reduz o risco de edição excessiva e ajuda o agente a preservar o papel de cada seção. Se o seu projeto tiver .claude/product-marketing-context.md, peça explicitamente que o agente leia e aplique esse arquivo antes de editar.

Uso dos scripts auxiliares

Se você trabalha localmente, os scripts podem transformar uma edição subjetiva em uma revisão mais repetível. Rode verificações de legibilidade com:

python3 scripts/readability_scorer.py --file copy.txt

Use o detector de padrões de IA como heurística, não como veredito:

python3 scripts/ai_content_detector.py copy.txt

O detector observa variação no tamanho das frases, diversidade de vocabulário e frases conhecidas com estilo típico de IA. Trate os trechos sinalizados como pontos para adicionar especificidade, ritmo, linguagem do cliente ou verbos mais fortes — não como prova de que o texto é “ruim.”

FAQ do copy-editing skill

O copy-editing serve apenas para copy de marketing?

Na maior parte, sim. A estrutura, os exemplos e as verificações do skill são orientados a marketing e copy de conversão. Ele ainda pode melhorar textos corporativos em geral, mas seu maior valor aparece em copies que precisam convencer o leitor a entender, confiar, clicar, cadastrar-se, responder ou comprar.

Qual é a diferença em relação a pedir uma reescrita?

Um prompt de reescrita costuma substituir sua voz e pode priorizar fluidez em vez de intenção. O copy-editing skill prioriza explicitamente a preservação da mensagem central, faz passagens focadas e apresenta razões para as mudanças. Isso o torna melhor quando você precisa de melhorias controladas, não de uma versão totalmente nova.

O copy-editing skill é amigável para iniciantes?

Sim, desde que você forneça contexto. Iniciantes se beneficiam ao pedir “edições com justificativa”, porque a resposta vira uma pequena aula de edição. Se você apenas colar a copy sem público, oferta ou objetivo, o agente pode fazer mudanças seguras, mas genéricas.

Quando devo evitar este skill?

Evite usá-lo quando precisar de revisão jurídica, médica, regulatória ou de comprovação de claims. Também não use este skill como substituto de pesquisa com clientes. Ele pode deixar a copy mais clara e persuasiva, mas não consegue verificar se sua promessa, seu posicionamento ou suas evidências são verdadeiros.

Como melhorar o copy-editing skill

Melhore os resultados do copy-editing com briefings melhores

O modo de falha mais comum é briefing insuficiente. Inclua o nível de consciência do leitor, dor principal, objeções, ação desejada, voz da marca, claims proibidos e exemplos de copy que você gosta. Se tiver depoimentos ou falas de clientes, inclua também. Entradas específicas ajudam o skill a substituir linguagem genérica por termos que seu público realmente reconhece.

Um formato útil de briefing é:

• Audience:
• Channel:
• Goal:
• Current draft:
• Must keep:
• Must avoid:
• Tone:
• Proof or evidence available:

Peça edições com limites, não polimento máximo

“Melhore isto” pode levar a uma copy lisa demais e sem personalidade. Instruções melhores são mais seletivas: “reduza em 20%”, “mantenha o tom direto do founder”, “remova jargões”, “torne o CTA orientado a resultado” ou “preserve todos os claims técnicos.” Restrições protegem a voz e evitam que o editor transforme uma copy distintiva em linguagem genérica de SaaS.

Itere depois da primeira versão editada

Depois da primeira passagem, pergunte quais tradeoffs a edição introduziu. Por exemplo: “A versão mais curta perdeu credibilidade?” ou “Onde a persuasão melhorou, mas a voz ficou menos distintiva?” Isso funciona bem com o modelo de sete varreduras, porque clareza, concisão, tom e persuasão podem entrar em conflito. O melhor resultado geralmente vem de duas ou três revisões direcionadas, não de uma única passagem ampla.

Use as referências para reduzir copy genérica de IA

Para limpeza de linguagem simples, peça que o agente aplique references/plain-english-alternatives.md e explique as substituições de maior impacto. Para copy com cara de IA, use references/ai-detection-patterns.md e o script detector para identificar ritmo monótono, vocabulário repetido e frases prontas. Depois, peça correções concretas: variação entre frases mais curtas e mais longas, substantivos mais específicos, verbos mais fortes, expressões reais de clientes e menos claims abstratos.