copywriting

Visão geral

O que a skill copywriting faz

A skill copywriting transforma sua IA em um copywriter especializado em conversão. Ela foi criada especificamente para escrever, reescrever e melhorar textos de marketing para:

• Homepages
• Landing pages
• Páginas de preços
• Páginas de recursos (features)
• Páginas "Sobre" (about)
• Páginas de produto / serviço

A skill é focada em textos claros, envolventes e orientados à ação. Ela ajuda a estruturar páginas, refinar propostas de valor, fortalecer headlines e CTAs e tratar objeções para que visitantes tenham mais chance de converter.

Para outros formatos, use as skills dedicadas:

• Para fluxos de email: email-sequence
• Para textos de popups e experimentos on-site: popup-cro
• Para edição e polimento puro: copy-editing

Para quem é essa skill

Use a skill copywriting se você é:

• Founder ou PM ajustando o posicionamento do produto e a copy do site
• Gerente de marketing ou growth lead construindo ou otimizando landing pages
• Copywriter que quer suporte estruturado, frameworks e templates de páginas
• Designer ou no-code builder que precisa de uma copy forte para novas páginas

Se o seu principal objetivo é convencer visitantes, deixar sua oferta mais clara e aumentar cadastros, demos ou compras, essa skill é uma ótima escolha.

Problemas que a skill copywriting resolve

O repositório é baseado em copywriting prático focado em conversão. A skill ajuda você a:

• Começar por um objetivo claro de página em vez de parágrafos soltos
• Fazer as perguntas certas sobre público, problemas e objeções
• Transformar detalhes de produto em benefícios e resultados
• Usar fórmulas de headline e estruturas de página já testadas
• Organizar páginas em seções como Problema, Solução/Benefícios, Como Funciona, Prova Social e Tratamento de Objeções
• Escrever transições naturais entre seções, deixando a página fluida e fácil de ler

Como a skill inclui prompts de avaliação estruturados (evals/evals.json), ela estimula saídas consistentes e de alta qualidade, como:

• Headlines e subheadlines claras
• CTAs fortes e orientados à ação
• Ordem lógica de seções em landing pages
• Anotações e justificativas quando fizer sentido

Quando esta skill não é a melhor opção

A skill copywriting não é otimizada para:

• Posts de blog longos e editoriais (use uma skill focada em conteúdo/blog)
• Documentação técnica ou referências de API
• Escrita acadêmica ou jurídica
• Estratégias complexas de automação de email (use email-sequence)
• Experimentos com popups e microcopy (use popup-cro)

Você ainda pode adaptá-la nesses casos, mas o maior valor está em textos de site e landing pages focados em conversão.

---

Como usar

1. Instalação e configuração

Instale a skill copywriting a partir do repositório coreyhaines31/marketingskills:

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

Após a instalação:

1. Abra o diretório skills/copywriting/ no seu ambiente.
2. Revise o arquivo SKILL.md para entender o comportamento principal e as expectativas.
3. Passe os olhos nos arquivos de apoio como material de referência:
   • evals/evals.json
   • references/copy-frameworks.md
   • references/natural-transitions.md

Você não precisa modificar esses arquivos para começar a usar a skill, mas saber o que há dentro deles vai tornar seus prompts mais eficazes.

2. Fluxo principal: antes de escrever qualquer copy

A skill copywriting foi projetada para coletar contexto essencial antes de gerar a copy. Ela segue a seção “Before Writing” em SKILL.md.

Primeiro, a skill verifica se há contexto de product marketing:

• Se o arquivo .agents/product-marketing-context.md existir (ou .claude/product-marketing-context.md em setups mais antigos), ela vai ler e usar essas informações.
• Se algo estiver faltando, fará perguntas pontuais de follow-up.

Os principais insumos que ela busca são:

Objetivo da página

• Que tipo de página é esta? (homepage, landing page, pricing, feature, about, product page)
• Qual é a uma ação principal que você quer que o visitante faça? (por exemplo, “Start free trial”, “Book a demo”, “Join waitlist.”)

Público

• Quem é o cliente ideal?
• Que problema ele está tentando resolver?
• Que objeções ou hesitações ele tem?
• Que linguagem ele usa para descrever esse problema?

Produto / Oferta

• O que você está vendendo?
• O que torna isso diferente ou melhor?
• Que provas ou resultados você pode compartilhar (métricas, estudos de caso, depoimentos)?

Fornecer isso logo no início deixa a copy muito mais forte e reduz a quantidade de revisões.

3. Usando a skill copywriting nos prompts

Depois de instalar a skill, você pode deixar claro no prompt que quer usar copywriting. Exemplos:

• "Use the copywriting skill to rewrite this weak homepage copy for better conversions. Primary CTA is 'Start free trial.'"
• "Using copywriting, write a landing page for our new analytics feature targeting e-commerce founders."
• "Apply the copywriting skill to tighten this pricing page and address objections about cost and migration."

Para melhores resultados:

1. Especifique o tipo de página e o objetivo principal.
2. Descreva seu público e o principal problema.
3. Compartilhe qualquer copy existente ou documentos de posicionamento.
4. Mencione se houver seções obrigatórias (por exemplo, "Include testimonials and a FAQ section.").

A skill então aplica os frameworks e estruturas do repositório para gerar uma copy organizada e focada em conversão.

4. Estrutura de página e tipos de seção

O arquivo references/copy-frameworks.md apresenta padrões práticos de estrutura de página e fórmulas de headlines. Você não precisa abri-lo sempre, mas é útil saber em que a skill se baseia.

Alguns tipos de seção comuns que a skill pode gerar:

• Headline / Hero: Proposta de valor clara e CTA principal
• Subheadline: Explicação breve que amplia a promessa
• Primary CTA: Ação direta (por exemplo, Start Free Trial, Book a Demo)
• Social Proof: Logos, depoimentos, números
• Problem / Pain: O principal problema que o público enfrenta
• Solution / Benefits: Como o produto resolve o problema e quais resultados entrega
• How It Works: Explicação simples passo a passo
• Objection Handling: Tratamento de objeções comuns, como custo, complexidade ou risco de migração
• Secondary CTA / Final CTA: Chamada final para ação

Você pode pedir estruturas como:

• "Use a full SaaS homepage layout: hero, social proof, problem, solution, how it works, objections, final CTA."
• "Create a compact landing page structure focusing on headline, benefits, and CTA only."

5. Frameworks de headline e orientação para CTA

A skill copywriting se baseia em templates de references/copy-frameworks.md, como:

• Headlines focadas em resultado: “Achieve [outcome] without [pain].”
• Headlines focadas em problema: “Never [unpleasant event] again.”
• Headlines focadas em público: “[Product type] for [audience] to [job].”

Você pode solicitar esses formatos explicitamente:

• "Using the copywriting skill, propose 3 outcome-focused headlines and explain which you recommend for the hero section."
• "Give me a problem-focused headline and 2 variations for my pricing page."

Para CTAs, as avaliações em evals/evals.json enfatizam:

• Linguagem orientada à ação (por exemplo, Start Free Trial, Schedule a Demo, e não Submit).
• Clareza sobre o que acontece em seguida.

Você pode pedir: "List 3 CTA options following the copywriting skill’s guidance—short, specific, and action-oriented."

6. Transições e fluidez entre seções

O arquivo references/natural-transitions.md reúne frases de transição e padrões de sinalização usados para manter as páginas legíveis e amigáveis para busca. A skill consegue:

• Conduzir de forma suave a seção de problema para a de solução
• Introduzir exemplos ou estudos de caso
• Resumir seções antes do CTA final

Alguns prompts possíveis:

• "Rewrite this landing page using the copywriting skill and add natural transitions between each section."
• "The content is fine but choppy. Use the transitions reference from the copywriting skill to make it flow better."

7. Revisão e iteração com evals

O arquivo evals/evals.json traz tarefas de exemplo e expectativas (por exemplo, uma homepage de onboarding de SaaS com seções e métricas específicas). Eles mostram como deve ser um output de alta qualidade:

• Página completa organizada por seções
• Alternativas de headlines com justificativa
• Uso de prova específica (como "from 2 weeks to 2 days")
• Meta title e meta description para SEO

Você pode espelhar esses padrões nos seus prompts:

• "Using the copywriting skill, create full homepage copy with sections: Headline, Subheadline, CTA, Social Proof, Problem, Solution/Benefits, How It Works, Objections, Final CTA. Include SEO title and meta description."
• "Provide 2–3 headline options and explain your reasoning for each."

8. Integração com seu fluxo de trabalho

Formas comuns de times integrarem a skill copywriting:

• Early-stage: Rascunhar a mensagem inicial e a estrutura de uma nova página de produto
• Otimização: Reescrever páginas com baixa performance usando melhor estrutura e benefícios mais claros
• Variantes: Gerar versões para testes A/B de headlines, CTAs ou seções de hero
• Preparação para localização: Criar uma versão master forte em inglês antes de localizar para outros idiomas

Se você mantém um documento central de product marketing (por exemplo, .agents/product-marketing-context.md), deixe-o sempre atualizado para que a skill tenha o posicionamento e as provas mais recentes.

---

FAQ

A skill copywriting é adequada para páginas focadas em SEO?

Sim, a skill copywriting funciona bem para landing pages e páginas de marketing focadas em SEO, desde que conversão seja o objetivo principal. Ela não é uma ferramenta de otimização técnica de SEO, mas o foco em clareza, boa estrutura e transições naturais ajuda no desempenho em busca ao melhorar legibilidade e alinhamento com a intenção de busca. Você também pode pedir para incluir um SEO page title e uma meta description, como mostrado nos exemplos de evals/evals.json.

Em que a skill copywriting é diferente de uma skill geral de escrita?

A skill copywriting foi criada especificamente para copy de conversão. Ela:

• Coloca o foco no objetivo da página e em uma ação principal
• Usa estruturas de landing page e fórmulas de headlines já validadas
• Incentiva mensagens guiadas por benefícios e resultados
• Inclui orientações para CTAs, objeções e prova social

Uma skill geral de escrita pode gerar um texto “bonito”; a copywriting é ajustada para produzir páginas com maior chance de persuadir e converter.

Posso usar a copywriting para emails ou popups?

Você pode, mas não é o melhor encaixe. O próprio repositório recomenda:

• Usar email-sequence para campanhas de email e fluxos automatizados.
• Usar popup-cro para textos de popup e experimentos de conversão no site.

A skill copywriting é otimizada para páginas completas—homepages, landing pages, páginas de preços, recursos, sobre e páginas de produto.

Que informações devo fornecer para ter os melhores resultados?

Para obter um output forte da skill copywriting, inclua:

• Tipo de página e objetivo principal (por exemplo, "feature landing page to get demo requests")
• Descrição do público e o problema principal
• Principais diferenciais e provas (por exemplo, métricas, estudos de caso)
• Qualquer copy existente, guidelines de marca ou preferências de tom

Se você mantém .agents/product-marketing-context.md, a skill vai ler esse arquivo primeiro e só perguntar o que estiver faltando.

A skill impõe um tom específico de marca?

Por padrão, a skill copywriting prioriza clareza em vez de “esperteza” e uma linguagem persuasiva, porém direta. Mas você pode definir o tom no seu prompt—formal, descontraído, enterprise, minimalista etc.—e a skill vai se adaptar mantendo a estrutura focada em conversão.

Posso ver exemplos de como é um output “bom”?

Sim. Abra:

• evals/evals.json para ver tarefas de exemplo e comportamentos esperados.
• references/copy-frameworks.md para fórmulas de headline e estruturas de página.

Esses arquivos mostram como a skill deve atuar em tarefas reais de homepage e landing pages.

Como adapto a skill copywriting à estrutura do meu projeto?

Você pode:

• Manter seu posicionamento e mensagens principais em .agents/product-marketing-context.md para que a skill sempre parta da mesma fonte de verdade.
• Referenciar seus próprios arquivos (por exemplo, briefs, personas, docs de features) nos prompts.
• Usar os templates de seção de references/copy-frameworks.md e pedir para a skill aplicá-los ao seu produto.

Você não precisa alterar os arquivos centrais da skill para se beneficiar; basta sobrepor o seu contexto em cima.

E se a minha página for muito curta ou muito longa?

A skill copywriting é flexível:

• Para páginas curtas (opt-in simples ou lista de espera), peça uma estrutura compacta—hero, benefícios e CTA.
• Para páginas de vendas mais longas, peça seções adicionais como FAQs, provas mais detalhadas e tratamento mais profundo de objeções.

Basta descrever o escopo no seu prompt e a skill vai adaptar os frameworks de referência ao que você precisa.

Onde encontro todos os materiais de apoio?

No diretório skills/copywriting/ do repositório coreyhaines31/marketingskills, os arquivos principais incluem:

• SKILL.md – descrição e comportamento principal
• evals/evals.json – tarefas de exemplo e expectativas
• references/copy-frameworks.md – fórmulas de headline e templates de estrutura de página
• references/natural-transitions.md – frases de transição e sinalização

Use esses arquivos como biblioteca de referência para extrair o máximo da skill copywriting ao planejar e refinar suas páginas de marketing.