copy-editing

Visão geral da skill copy-editing

O que a skill copy-editing faz

A skill copy-editing foi feita para melhorar copy de marketing que já existe, não para gerar mensagens do zero em uma primeira versão. Ela funciona bem em casos como revisão, enxugamento de texto de landing page, ajuste de frases truncadas, fortalecimento de claims e aumento do poder persuasivo da copy sem mudar a mensagem central.

Quem deve instalar esta skill copy-editing

Esta skill copy-editing é uma boa escolha para marketers, founders, PMMs, agências e usuários de IA que já têm um rascunho de copy e querem um fluxo de edição mais confiável do que um prompt solto do tipo “melhore isso”. Ela é especialmente útil para copy-editing for Proofreading quando você quer edições que preservem a intenção original, em vez de substituir o texto inteiro.

O trabalho real que ela resolve

A maioria dos usuários não precisa de uma reescrita completa. Precisa:

• remover linguagem vaga
• melhorar clareza e fluidez
• manter a voz da marca
• identificar claims fracos e promessas sem sustentação
• fazer a copy de conversão soar mais específica e crível

Esta skill atende a esse trabalho com um método de edição estruturado, em vez de sugestões avulsas.

O que diferencia esta skill de um prompt genérico de edição

O principal diferencial está no framework Seven Sweeps: passagens sequenciais por clareza, voz e tom, valor, prova, especificidade, emoção e redução de risco. Essa estrutura é o verdadeiro motivo para usar a skill. Ela reduz um erro comum, em que a IA “melhora” a gramática, mas deixa passar problemas de posicionamento, falta de prova ou linguagem de marketing genérica.

Tipos de conteúdo em que ela encaixa melhor

Use a skill copy-editing para:

• copy de homepage e landing page
• seções de páginas de produto
• rascunhos de email
• copy de anúncios ou campanhas
• mensagens curtas de vendas
• revisão de texto de marketing existente antes da publicação

Ela é menos indicada para developmental editing de conteúdo longo ou trabalho estratégico criado do zero.

Nota mais importante para adoção

Antes de editar, a skill dá preferência explícita a contexto de product marketing, se estiver disponível, especialmente .agents/product-marketing-context.md ou .claude/product-marketing-context.md. Se a sua equipe tiver documentos de voz de marca, ICP ou posicionamento, a qualidade desta skill melhora de forma perceptível quando esse contexto é fornecido logo no início.

Como usar a skill copy-editing

Instalação e contexto da skill copy-editing

Instale a skill a partir do repositório com:

npx skills add https://github.com/coreyhaines31/marketingskills --skill copy-editing

Se o seu ambiente usa outro executor de skills, mantenha o mesmo repositório e o mesmo slug da skill: copy-editing.

Leia estes arquivos primeiro

Para uma avaliação rápida, comece por aqui:

1. skills/copy-editing/SKILL.md
2. skills/copy-editing/evals/evals.json
3. skills/copy-editing/references/plain-english-alternatives.md

Por que nessa ordem:

• SKILL.md mostra o fluxo real e em que condições a skill deve ser acionada
• evals/evals.json revela, na prática, o que é considerado “bom uso”
• a referência de plain English ajuda a entender como a skill simplifica redação inflada

Que tipo de input a skill precisa

A skill copy-editing funciona melhor quando você fornece:

• o texto exato do rascunho
• o tipo de peça: homepage, email, anúncio, CTA etc.
• público e nível de awareness
• tom desejado
• contexto de marca ou produto
• restrições como limite de palavras, sensibilidade jurídica ou claims que precisam ser mantidos

Sem esses inputs, o modelo ainda consegue editar, mas aumenta a chance de generalizar demais ou achatar a sua voz.

Melhor formato de prompt para usar copy-editing

Um pedido fraco seria:

“Proofread this and improve it.”

Um pedido mais forte seria:

“Use the copy-editing skill on this homepage hero section. Keep the core message, preserve a confident but plainspoken tone, and do not rewrite from scratch. Apply the Seven Sweeps, flag the biggest issues first, then provide a tightened version under 45 words. Audience: operations leaders at mid-market SaaS companies. Product promise: faster reporting from existing systems. Avoid hype.”

Esse prompt é melhor porque deixa claro o que a skill deve preservar, o que deve otimizar e quais restrições importam.

Fluxo recomendado de copy-editing na prática

Um fluxo prático de copy-editing usage:

1. forneça o rascunho
2. forneça contexto de marca/produto
3. peça a análise em Seven Sweeps
4. peça uma versão revisada
5. revise o que mudou e por quê
6. faça mais uma rodada no ponto de maior risco, normalmente clareza ou especificidade

Esse fluxo funciona melhor do que pedir apenas uma reescrita final, porque você consegue identificar desvios indesejados de mensagem mais cedo.

Os Seven Sweeps que você deve esperar da skill copy-editing

Com base no repositório e nos evals, a skill copy-editing deve inspecionar sistematicamente:

• clareza
• voz e tom
• “so what” ou relevância do valor
• prova e evidência
• especificidade
• carga emocional
• fricções de zero-risk ou elementos que reduzem confiança

Se a saída ignorar a maior parte disso e partir direto para uma reescrita, você não está extraindo o valor completo da skill.

Como usar copy-editing para Proofreading

Para proofreading, esta skill é mais forte quando proofreading significa mais do que só corrigir typos. Ela é útil para:

• frases truncadas ou pouco naturais
• verbosidade
• redução de jargão
• claims de benefício genéricos
• aberturas fracas
• linguagem centrada na empresa

Se você quer apenas correção ortográfica e de pontuação, esta skill pode ser mais opinativa do que o necessário. Mas, em revisão de marketing, esse julgamento editorial extra normalmente é justamente o valor.

Como evitar que a skill reescreva demais

Declare estas restrições de forma explícita:

• “Preserve the core message”
• “Keep the original structure unless a line is clearly weak”
• “Do not introduce claims we cannot prove”
• “Keep the tone close to the draft”
• “Show edits with reasons”

Essas instruções estão alinhadas com a filosofia da skill e reduzem a chance de uma reescrita nova aparecer disfarçada de edição.

Dica prática da pasta references

O arquivo references/plain-english-alternatives.md é útil quando o seu rascunho soa formal demais, inflado ou genérico no estilo enterprise. Se a sua copy tiver termos como “optimize”, “leverage”, “seamlessly” ou “meaningful results”, peça ao modelo que prefira substituições em plain English e elimine frases vazias sempre que possível.

Como deve ser uma boa saída

Um resultado forte da skill copy-editing normalmente inclui:

• um diagnóstico breve por sweep ou tipo de problema
• exemplos concretos de trechos fracos
• explicação das edições mais importantes
• uma versão revisada mais curta, mais clara e mais específica
• mínimo desvio em relação à sua mensagem original e ao público-alvo

Quando este guia de copy-editing mais importa

Este guia de copy-editing é mais útil quando o rascunho já está razoável, mas performa abaixo do esperado. Se o problema for posicionamento confuso ou ausência de uma oferta real, só editar vai ajudar até certo ponto. Nesse caso, use primeiro o contexto de product marketing e depois edite.

FAQ da skill copy-editing

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

Sim. Ela é mais fácil de usar do que muitas skills carregadas de estratégia, porque a tarefa é concreta: melhorar uma copy existente. Ainda assim, iniciantes obtêm resultados melhores quando especificam público, canal e tom, em vez de apenas colar um texto cru sem contexto.

Em que ela difere de prompting comum

Prompts comuns costumam gerar polimento superficial. Esta skill copy-editing força uma sequência de revisão mais completa: clareza, voz, valor, prova, especificidade, emoção e confiança. Essa estrutura é a principal vantagem em relação a um simples “please improve this paragraph”.

Devo usar isso para reescrever do zero?

Não. O repositório deixa claro que o foco é editar copy existente. Se você precisa de uma primeira versão, de um ângulo de mensagem ou da arquitetura da mensagem, este não é o melhor encaixe. Primeiro use um fluxo orientado a copywriting e depois aplique copy-editing.

A skill serve só para copy de marketing?

Em grande parte, sim. A linguagem e os exemplos de avaliação estão centrados em marketing e copy de conversão. Dá para adaptar a outros textos persuasivos, mas o encaixe mais forte continua sendo mensagem voltada ao cliente.

A instalação de copy-editing inclui ferramentas ou scripts extras?

Não há aqui nenhuma dependência relevante de scripts. O valor está no framework de edição, nos exemplos de eval e no material de referência, não em código de automação.

O que mais costuma bloquear bons resultados?

Os principais bloqueios são:

• ausência de contexto de produto
• pedir edição quando a mensagem em si é fraca
• não informar público nem canal
• querer proofreading quando, na prática, precisa de reescrita estratégica
• não dizer ao modelo o que precisa permanecer inalterado

Quando eu não devo usar copy-editing?

Evite esta skill quando:

• você precisa de mensagens totalmente novas
• a copy tem restrições legais/compliance que exigem revisão exclusivamente humana
• você quer developmental editing profundo para conteúdo longo
• o problema principal é posicionamento de produto, não redação

Como melhorar a skill copy-editing

Forneça material de origem mais forte

A forma mais rápida de melhorar a saída de copy-editing é fornecer o rascunho real, não uma paráfrase. Inclua linhas vizinhas, texto de CTA, pares de headline/subhead ou a seção ao redor, para que o modelo consiga preservar fluxo e hierarquia.

Forneça primeiro o contexto de product marketing

Se você tiver .agents/product-marketing-context.md ou .claude/product-marketing-context.md, use. Se não tiver, cole um equivalente compacto:

• para quem é o produto
• principal dor
• valor diferenciado
• proof points
• voz preferida
• frases proibidas

Esta é a melhoria de maior alavancagem para esta skill copy-editing.

Peça análise antes da reescrita

Para tomar decisões melhores, peça:

1. principais problemas por sweep
2. o menor conjunto de edições que teria maior impacto
3. a copy revisada

Isso evita mudanças desnecessárias e ajuda você a avaliar se as edições estão indo na direção certa.

Seja explícito sobre o que não pode mudar

Se preservar a mensagem é importante, diga isso claramente. Bons exemplos:

• “Do not change the core promise”
• “Keep the CTA concept”
• “Retain the technical meaning”
• “Do not add proof we do not have”

Isso importa porque ferramentas de edição muitas vezes melhoram a fluidez inventando certeza ou simplificando nuances em excesso.

Force mais especificidade quando a copy soar genérica

Se o primeiro resultado ainda parecer copy genérica de SaaS, faça perguntas de follow-up como:

• “Which phrases still feel interchangeable with competitors?”
• “Where are we making claims without proof?”
• “What wording is too abstract for a skeptical buyer?”
• “Which lines should become more concrete?”

Esse tipo de follow-up usa a skill como ela foi pensada: um sistema deliberado de passagens editoriais.

Use a referência de plain-English de forma intencional

Quando o problema for jargão, diga ao modelo para seguir a abordagem de alternativas em plain-English e trocar linguagem pomposa por redação direta. Isso é especialmente eficaz em frases de benefício, descrições de funcionalidades e copy enterprise antiga.

Fique atento aos modos de falha mais comuns

Falhas comuns em copy-editing usage incluem:

• polir uma estratégia fraca em vez de sinalizá-la
• trocar a voz da marca por uma voz de IA sem graça
• remover nuance para ganhar brevidade
• adicionar claims mais fortes do que a evidência sustenta
• melhorar frases individualmente enquanto a clareza de valor continua fraca

Se você notar esses sinais, peça uma segunda rodada mais estreita, focada justamente na dimensão que ficou de fora.

Melhore a segunda iteração, não só a primeira

Depois da primeira saída, não peça apenas “another version”. Em vez disso, peça uma revisão direcionada:

• “Make the proof problem explicit”
• “Keep this voice but reduce hype”
• “Cut 20% without losing specificity”
• “Give me three headline options that preserve the edited body copy”

Iterações focadas ampliam melhor o valor do Seven Sweeps do que reescritas genéricas repetidas.

Valide contra os evals

Vale a pena ler evals/evals.json, porque ele mostra o que o repositório considera comportamento bem-sucedido. Se a saída do seu modelo não estiver buscando contexto, não estiver identificando linguagem vaga ou não estiver questionando claims sem sustentação, deixe o prompt mais preciso até o comportamento se aproximar do esperado nos evals.

Saiba quando o rascunho precisa de estratégia, não de copy-editing

Às vezes, a melhor melhoria é parar de editar. Se o rascunho não tem público claro, oferta definida ou diferencial, copy-editing só vai deixar uma mensagem fraca mais limpa. Nesses casos, ajuste primeiro o posicionamento e depois volte para a skill copy-editing para o refinamento final.