Escreva Cópia (ganchos · roteiro · legenda)
O gargalo criativo não é gerar mídia — é saber o que dizer. Este skill gera ganchos, roteiros e legendas usando frameworks comprovados de resposta direta e, em seguida, permite que o usuário escolha e refine. Comandos de fluxo de trabalho — chame a CLI, não escreva um script:
node workflows/cli.cjs generateHooks '<json-args>' # também: generateScript, generateCaption
As assinaturas de chamada TypeScript mostradas abaixo documentam os argumentos de cada comando — traduza-os em node workflows/cli.cjs <comando> '<json-args>', não os cole em um novo arquivo.
Primeiro, extraia o contexto do projeto quando ele existir (project.md público/pontos de dor/oferta; brand.md tom/restrições) para que a cópia esteja alinhada à marca e nunca viole restrictions.
PASSO 0: Verifique a cópia de referência ANTES de escrever qualquer coisa
Consistência de voz vem de exemplos, não de adjetivos. Antes de gerar ganchos, roteiros ou legendas:
- Verifique o registro em busca de exemplos de cópia salvos:
Encontrou → extraia os padrões (comprimento da frase, uso de emoji, estilo de hashtag, fraseologia de CTA, formalidade) e ESPELHE-OS em tudo que você escrever abaixo.node workflows/cli.cjs resolveAsset '["{nome}","style-copy"]' # um id style_references contendo exemplos de cópia cat projects/{nome}/assets/style/copy-examples.md 2>/dev/null cat projects/{nome}/style-samples/caption-examples/*.md 2>/dev/null # caixa de entrada do usuário - Nada salvo → pergunte uma vez:
"Você tem postagens, legendas ou roteiros anteriores que funcionaram bem — ou contas cujo estilo de cópia você gosta? Cole 1-3 exemplos (ou 'nenhum' — irei pelo brand.md)."
- Exemplos fornecidos → salve em
projects/{nome}/assets/style/copy-examples.mde registre (registerAsset '["{nome}","style_references",...]') para que peças futuras os reutilizem. - "nenhum" → prossiga a partir do tom de
brand.mde indique quais suposições de tom você fez.
- Exemplos fornecidos → salve em
- Quando existirem exemplos, anote em
prompts.txta qual referência a cópia foi associada.
PASSO 1: Ganchos (escolha o ângulo antes de escrever tudo)
Gere uma variedade de ganchos em diferentes ângulos e deixe o usuário escolher 1–2 para desenvolver.
node workflows/cli.cjs generateHooks '{"topico":"app de planejamento de estudos com IA","publico":"universitários se preparando para provas finais","pontoDeDor":"não sabem por onde começar a revisar","plataforma":"tiktok","quantidade":8}'
# h.data.hooks: [{ texto, angulo }] — ângulos: problema | curiosidade | resultado | contrário | pergunta | estatística | história
Mostre-os agrupados por ângulo e pergunte qual usar. Não escolha automaticamente — o gancho decide toda a peça.
PASSO 2: Roteiro (orientado por framework, dimensionado para duração)
Uma vez escolhido o gancho, escreva o roteiro com um framework que se adapte ao objetivo:
| Framework | Melhor para |
|---|---|
hook-reter-recompensa | vídeo curto (TikTok/Reels/Shorts) — padrão |
PAS (Problema-Agitação-Solução) | anúncios orientados por dor |
AIDA (Atenção-Interesse-Desejo-Ação) | resposta direta clássica |
BAB (Antes-Depois-Ponte) | transformação / resultados |
história-personagem-solução | depoimentos / história do fundador |
# gancho: passe o texto do gancho escolhido do generateHooks
node workflows/cli.cjs generateScript '{"brief":"app de planejamento de estudos com IA que cria um cronograma de revisão em 60 segundos","framework":"PAS","plataforma":"tiktok","duracaoSegundos":30,"gancho":"<texto do gancho escolhido>","cta":"Teste grátis — link na bio"}'
# s.data: { framework, secoes:[{rotulo, voz, visual}], contagemPalavras, duracaoEstimadaSegundos }
Mostre o roteiro como seções rotuladas (indicação de voz + dica visual) e a duração estimada. Sinalize se duracaoEstimadaSegundos estiver longe do alvo para que o usuário possa cortar/expandir. Este texto de voz alimenta diretamente generateVoiceover() e as dicas visuais por cena visual alimentam generateStoryboard() / o skill de vídeo.
PASSO 3: Legenda (pronta para publicação, por plataforma)
A milha final — a cópia da postagem + hashtags que realmente acompanham o vídeo/imagem.
node workflows/cli.cjs generateCaption '{"topico":"app de planejamento de estudos com IA","plataforma":"instagram","tom":"amigável, confiante","cta":"Link na bio","quantidade":3}' # plataforma: tiktok | instagram | youtube | facebook
# c.data.captions: [{ texto, hashtags:[] }]
Gere variantes por plataforma se a peça for postada em várias (cada plataforma tem normas diferentes de comprimento e hashtag). Salve a legenda escolhida junto à saída, por exemplo, projects/{nome}/output-contents/.../caption.md.
Como se conecta
generateHooks → escolher → generateScript → { voz → generateVoiceover,
dicas visuais → generateStoryboard → video }
→ generateCaption → caption.md
Sempre sugira e confirme — apresente opções, recomende uma com um motivo, deixe o usuário editar. Nunca invente estatísticas/depoimentos (puxe apenas os reais de project.md).