📝 marketing-copywriting · a skill estrela
Output mais frequente do OS no dia-a-dia. Gera copy para uma plataforma específica usando brand-voice e register A/B/C auto-detetado. Devolve 1-3 variações. Passa pelo verifier obrigatoriamente.
Inputs requeridos
| Input | Exemplo | Se faltar... |
|---|---|---|
| Tema/brief | "Lançamento do curso v2" | Pergunta |
| Plataforma | LinkedIn / X / email / landing | Pergunta (muda tudo) |
| Purpose | awareness / lead-gen / oferta | Pergunta (muda tom) |
🎚️ Register auto-detection
A skill mapeia plataforma → register automaticamente:
- →Email premium / proposta = Registo A (formal)
- →LinkedIn, blog, X thread, newsletter = Registo B (divulgativo)
- →WhatsApp, DM, comentários, Stories = Registo C (próximo)
Podes forçar manualmente: "escreve em registo C". Útil quando o default está mal-calibrado.
💡 Dica
Pede sempre 2-3 variações em vez de "a melhor". Custa o mesmo em tokens e dá-te óptica para escolher. A "melhor" muda em função do contexto que só tu tens (cliente específico, evento da semana, mood).
♻️ marketing-content-repurposing (1 fonte → 5-8 peças)
Converte 1 peça fonte em 5-8 peças multiplataforma respeitando brand voice. Uma talk de 60 min vira uma semana de distribuição em 15-20 min de trabalho teu.
Fontes suportadas (v0.2)
Invoca tool-youtube-transcript ou pede transcript manual
Modo direto, mais rápido
Usa tool-firecrawl-scraper
Transcript Zoom/Fathom/Otter
Áudio local (MP3/WAV) não suportado v0.2 — pede transcript manual.
Pacote de output típico
🔗 Como compõe internamente
Para cada peça do pacote, invoca marketing-copywriting com a plataforma certa. Cada um passa pelo tool-output-verifier. Resultado: 5-8 outputs cada um passou pelo gate, não só o agregado.
📧 marketing-email-sequence (welcome, nurture, win-back)
Cria sequências multi-email automatizadas: welcome, nurture, win-back, post-purchase, event-based, educational. Define gatilhos, cadência, segmentação e métricas-alvo.
| Tipo | Cadência típica | Métrica-alvo |
|---|---|---|
| Welcome / onboarding | 5-7 emails em 14 dias | Open >40%, ativação |
| Lead nurture | 1 email/semana, indef. | CTR >3%, reply rate |
| Re-engagement (win-back) | 3 emails em 10 dias | Recuperar dormentes |
| Post-purchase | 4-6 emails em 30 dias | Onboarding + upsell |
| Event-based | 3-4 antes + 1-2 depois | Atendimento + replay |
| Educational drip | 1 email a cada 2-3 dias | Completion rate |
Avaliação inicial · o que pergunta
- Tipo de sequência (welcome / nurture / re-eng / post-purchase / event / educational)
- Audiência (segment, awareness stage, contexto da inscrição)
- Objetivo conversão (compra, demo, reply, completar onboarding)
- Tom + register (lê brand-voice se existe)
- Ferramenta de envio (Mailchimp, ConvertKit, n8n, ActiveCampaign)
- Restrições (legais, brand, frequência máxima)
⚠️ Não confundir com cold email
marketing-email-sequence é para fluxos automatizados com lista própria (opt-in). Para cold outreach (B2B prospecting), há a skill futura cold-email com regras diferentes (compliance, deliverability, sequência manual).
📐 marketing-positioning + marketing-icp (já cobertas em T3)
Cobertas a fundo em Trilha 3 Brand Context (módulos 3.2 e 3.3). Aqui revemos só o essencial para perceberes como se compõem com as outras skills marketing.
🎯 marketing-icp
Constrói perfil cliente ideal por análise de 3-5 clientes bons + 1-3 maus reais.
Reusa: linguagem literal alimenta hooks em marketing-copywriting, segmentos alimentam marketing-email-sequence.
→ Ver Módulo 3.2 para deep dive
📐 marketing-positioning
Analisa 3-5 concorrentes via Firecrawl, identifica gaps, propõe 3-5 ângulos baseados nos 4 arquétipos.
Reusa: statement alimenta hero de landing, parágrafo de bio LinkedIn, abertura de cold email.
→ Ver Módulo 3.3 para deep dive
🔁 Por que estão em T3, não T4
positioning e ICP geram artefactos de brand-context (que vivem em brand-context/positioning/ e brand-context/icp/), por isso pertencem conceptualmente à camada Brand. T4 cobre as skills que consomem brand-context para gerar outputs operacionais.
Dependência: copywriting/email-sequence/repurposing leem os ficheiros que positioning/ICP escrevem. Sem brand-context bem feito, as skills marketing produzem outputs genéricos.
📊 Quando re-invocar (rappel)
- ICP — após cada batch de 3-5 clientes novos
- Positioning — só com 3 gatilhos legítimos (mudança mercado/dor/ICP); win-rate <1 em 5 sinaliza
🔗 Padrão de skill collaboration · copywriting → verifier → humanizer
As skills não vivem isoladas. Compõem-se em pipelines. Saber o pipeline canónico ajuda-te a debugar quando uma skill "falha" — geralmente é um problema de composição, não de skill individual.
Pipeline canónica para qualquer output marketing
┌─────────────────────────┐
│ marketing-copywriting │ ← gera 1-3 variações
└────────────┬────────────┘
│
▼
┌─────────────────────────┐
│ tool-output-verifier │ ← 4 checks (humanizer, voice, length, factuality)
└────────────┬────────────┘
│
score >=8 │ │ score <8
│ │
│ ▼
│ ┌────────────────┐
│ │ tool-humanizer │ ← reescreve com sugestões
│ └───────┬────────┘
│ │
└────┐ │
▼ ▼
┌──────────────┐
│ Entrega │
└──────────────┘
📦 Contexto JSON passado entre skills
{
"text": "...",
"platform": "linkedin",
"purpose": "awareness",
"register": "B",
"source_skill": "marketing-copywriting",
"voice_loaded": true
}
Cada skill no pipeline recebe o JSON e pode adicionar campos (ex: verifier adiciona scores: {humanizer: 8, voice: 9}). Permite debugar: lê o JSON final e vês onde se partiu a cadeia.
🚧 Falhas típicas no pipeline
- Voice não carregada → verifier dá voice_score baixo → loop infinito. Causa:
brand-context/voice/voice-profile.mdvazio. - Length errado por platform → output X com 2000 caracteres em campo de 280. Causa: platform não passada no JSON.
- Humanizer impossível → score nunca chega a 8 mesmo após 3 iterações. Causa: tema demasiado técnico ou voice mal definida.
🚦 Quando NÃO ativar uma skill marketing
Skills marketing têm custo: tokens (lêem brand-context, ICP, voice profile), tempo (verifier obrigatório), e ruído. Aplicá-las a tudo é como pôr 5 cintos para descer à esquina. Override manual sempre disponível.
| Caso | Skill? | Porquê |
|---|---|---|
| Resumo 1 parágrafo só para ti | Não | Output interno, sem leitor externo |
| Brainstorm exploratório livre | Não | Skills constrangem; queres soltar |
| Email pessoal a amigo | Não | Brand voice é overhead aqui |
| Draft notas para call | Não | Não vai ser publicado |
| Post LinkedIn público | Sim | copywriting + verifier obrigatório |
| Email para lista de clientes | Sim | email-sequence ou copywriting |
| Reutilizar 1 talk em 5 peças | Sim | content-repurposing |
🎚️ Override manual · 3 frases que respeita
- "escreve sem skill, é interno"
- "prompt direto, sem voice carregada"
- "salta o verifier"
O agente respeita e marca explicitamente no output que correu sem gates.
📢 Overhead vs valor
Cada skill ativada adiciona ~500-2000 tokens (ler ficheiros) + 30-90 segundos (verifier roundtrip). Para um post LinkedIn que vai gerar 5 leads, vale a pena. Para uma frase rápida na DM, não. Regra: se o output vai ter >1 leitor externo, ativa. Se é só para ti, não.
✅ Resumo do Módulo
Próximo Módulo:
4.3 — Tools + Visualização: humanizer, verifier, firecrawl, visual-explainer. Threshold por plataforma e patterns de skill collaboration.