Diretor visual
Um ótimo reel de "talking-head" mostra o que o palestrante está dizendo, um compasso de cada vez: uma lista se transforma em chips que aparecem conforme cada item é dito; um número é contado; "Eu digitei um prompt" se torna uma janela de chat digitando. As peças são pequenas, ficam ao redor da cabeça (nunca no rosto) e aparecem exatamente quando a palavra é falada.
Você planeja isso em build.json → "visuals": [...]. O mecanismo cuida do posicionamento, da aparência do kit, da animação e de um som por pop-up.
1. Leia o reel como compassos
Percorra as linhas bloqueadas (edl.json) com os índices das palavras:
python3 -c "import json;w=json.load(open('projects/<name>/transcript.json'))['words'];c=json.load(open('projects/<name>/cut.json'));[print(' '.join(f\"{x['i']}:{x['w']}\" for x in w[a:b+1])) for a,b in (l['words'] for l in c['lines'])]"
Marque cada compasso que tenha algo mostrável:
- uma lista de coisas
- um número
- uma ferramenta ou aplicativo
- uma ação (digitando, enviando, reservando)
- um antes/depois ou um isto-vs-aquilo
- um processo ou etapas
- um sistema
- uma pessoa ou história
- um período de tempo
- uma ideia rejeitada
- uma palavra-chave que vale a pena destacar
Preenchimentos, transições e sentimentos sem objeto não recebem nada.
2. Escolha a peça para cada compasso
| Ele(a) diz… | Peça | Exemplo |
|---|---|---|
| uma lista ("marketing, notas fiscais, e-mails") | chips, um item por palavra conforme é dito | itens com word cada |
| coisas sendo descartadas ou fechadas ("todas aquelas abas na minha cabeça") | chips com "close": true | |
| um número ("100+ clientes", "15h", "uma equipe de 2") | number | "value": "100+", "label": "clientes" |
| a palavra-chave ou o impacto de uma linha | word ("style": "type" para um pensamento ou pergunta) | "text": "*apoio* real" |
| algo que rejeita ("não 50 passos", "não outro app") | strike | "pre": "Não", "text": "50 passos", "strike_word": i |
| digitando um prompt, perguntando à IA, enviando um DM | chat | "prompt": "...", "reply": "..." (opcional) |
| uma venda, uma mensagem, uma reserva, uma notificação | notify | "app": "Stripe", "title": "Novo pagamento: €497" |
| passos concluídos, uma lista de tarefas, vitórias | checklist | itens com word cada |
| "passo 1 / a primeira coisa / parte dois" | step | "n": 1, "text": "*treine*-a" |
| uma mudança ou processo (A → B → C) | flow | itens com icon e text |
| um sistema, ferramentas conectadas, "tudo em um lugar" | hub | center mais nodes com ícones |
| um período ou intervalo de tempo ("em um mês… em 3 anos") | scale | marks, from, to, move_word |
| um cliente, uma pessoa, uma história sobre alguém | person | "name": "Abby", "note": "coach", "meter": 3 |
| isto vs aquilo, caminho antigo vs caminho novo | versus | left (o ✗) / right (o ✓), right_word |
| um meme ou GIF, apenas quando o usuário pedir um | gif | "file": "projects/<name>/memes/3.mp4", "caption": "eu lendo minhas *legendas* antigas" |
| o perfil deles, uma captura de tela, um aplicativo | phone | "image": "assets/profile.png" (apenas imagens que o usuário deu) |
Texto nas peças:
- 1–3 palavras por chip, nó ou rótulo
- use as palavras deles
- título com iniciais maiúsculas é aceitável, mas sem frases completas, exceto em
chatenotify
Ícones: encontre nomes reais com uv run tools/icons.py calendar money email e nunca adivinhe um nome. A build para em um ícone desconhecido.
Peças de assinatura (precisam do material do próprio usuário)
- Os reels deles orbitando:
{"type": "orbit", "word": i, "until_word": j}emevents(não em visuals).- Use em uma linha sobre o conteúdo ou o trabalho deles ("Eu fiz 300 destes").
- Precisa de
brand/reels/. Preencha comuv run tools/reels.py add <arquivos dos reels deles ou uma pasta>: os próprios reels exportados por eles, ou baixados do perfil deles com Apify, se estiver conectado. - Os reels deles passam atrás e na frente deles. No máximo uma vez por reel.
- Seguir perfil do Instagram para uma chamada para ação ("me siga", "comente CÉREBRO"):
{"kind": "profile", "word": i, "until_word": j, "keyword": "CÉREBRO"};keywordé opcional e digita em uma folha de comentários.- Os números vêm apenas de
brand/instagram.json(name, handle, posts, followers, following, bio, avatar). Se estiver faltando, peça os números reais para eles (ou puxe do próprio perfil deles com Apify). Nunca estime ou invente. - A grade usa
brand/reels/. Recebe um som de toque em Seguir (e em Post).
- O reel de outro criador como um card: um
gifcom"handle": "creatorname". O @handle aparece abaixo dele.- Sempre dê crédito, e use apenas clipes que o usuário indicar.
- Insert personalizado (quando nenhuma peça se encaixa, por exemplo, uma recriação de um aplicativo que usam, ou um arquivo rolando): construa com um subagente. Veja "Inserts personalizados" abaixo.
Movimento
O visuals.motion do kit: gentle / snappy / bouncy / blur (um pop borrado que se nitifica no lugar) / rise (editorial calmo).
"style": "rise"em um popwordfaz cada letra surgir de sua linha, uma após a outra. É ótimo para palavras de impacto em serifa. Um kit pode torná-lo o padrão comvisuals.word_style: "rise".- As legendas podem aparecer com pop borrado usando
captions.pop: "blur".
Inserts personalizados (subagentes paralelos)
- Trave o tempo primeiro: os tempos das palavras que deve atingir, convertidos para o relógio do próprio insert (t = 0 quando aparece).
- Inicie um subagente por insert, em segundo plano e em paralelo (ferramenta Agent), enquanto você continua construindo. Instrua-o com:
- O que mostra, e a linha sobre a qual toca. Use dados reais do usuário apenas; qualquer outra coisa é um placeholder genérico. Nenhuma pessoa real e nenhum logotipo copiado.
- Onde trabalhar:
projects/<name>/inserts/<insert-name>/index.html. Não toque em mais nada. - Tamanho e duração: por exemplo, 900×700 px e 2,6 s. O fundo permanece transparente fora do card ou janela que desenha.
- O contrato:
window.renderAt(t)desenha o estado exato em t segundos. Sem timers, transições CSS ou animações, porque os quadros são capturados um por um.- Apenas fontes locais (copie de
fonts/free/). - Texto de pelo menos 24 px, usando as cores do kit do usuário.
- Texto digitado: um caractere por etapa de t.
- Apenas fontes locais (copie de
- Compassos, com tempos travados na voz.
- Renderize com
uv run tools/insert.py <index.html> --dur <s> --w <w> --h <h>→insert.mov, com alpha. Veja alguns quadros antes de relatar. - Relate: o caminho, a duração exata e os tempos dos compassos (para sons). Sinalize qualquer coisa que pareça errada.
- Posicione-o com
{"kind": "insert", "file": "…/insert.mov", "word": i, "width": 640}. Adicionesfx_extracliques em seus compassos.
Memes e GIFs (apenas sob solicitação)
-
Nunca adicione um meme sem ser solicitado. Memes são uma questão de gosto. Você pode sugerir um em seu relatório ("um 'ew' da David Rose cairia bem na linha 5"), e adicioná-lo apenas se eles disserem sim.
-
Pesquise:
uv run tools/memes.py search "<série> <personagem> <emoção ou palavras>" --project projects/<name>. Por exemplo "schitts creek david ew" ou "the office michael no god please no".- Baixa até 6 clipes e imprime
SHEET=…/memes/sheet.png. Leia a folha e escolha o quadro que corresponde ao que descreveram (o personagem certo, a expressão certa), não apenas o primeiro. - Os quadros são numerados de 1 a 6, da esquerda para a direita, de cima para baixo.
- Baixa até 6 clipes e imprime
-
Arquivo próprio deles ("use este GIF"):
uv run tools/memes.py add "<arquivo>" --project projects/<name>geramemes/own-1.mp4. Imagens também funcionam. -
Posicione-o:
{"kind": "gif", "file": "projects/<name>/memes/<n>.mp4", "word": i, "caption": "<texto deles>"}- A legenda é opcional, nas palavras deles, com um
*ênfase*. A duração padrão é de cerca de 2,6s, ou defina"until_word". - Clipes largos ficam acima da cabeça; os altos ficam abaixo do queixo.
"at": "full"faz um corte de 1,6s em tela cheia com a legenda sobreposta.
-
No relatório: diga qual você usou e abra a folha (
open …/sheet.png) para que eles possam dizer "meme 3". Os outros clipes já estão baixados, então trocar significa apenas alterarfilee reconstruir. -
Sem chave (
MEMES=sem-chave): ofereça a configuração gratuita de 3 minutos:- Eles vão em developers.giphy.com, se cadastram, criam um aplicativo API (não SDK) e copiam a chave.
- Eles colam a chave no chat.
- Você a salva em
brand/keys.jsoncomo{"giphy": "<chave>"}.
Nunca peça para eles editarem arquivos sozinhos. Até lá, os arquivos GIF deles ainda funcionam.
-
Mencione uma vez, na primeira vez que usarem um meme de TV ou filme: esses clipes pertencem aos estúdios. GIFs de reação curtos e silenciosos são usados em todo lugar no Instagram, mas há um pequeno risco. Os clipes deles próprios não têm nenhum.
3. Tempo (índices das palavras da transcrição)
"word": ifaz a peça aparecer conforme a palavra i é falada. Use a primeira palavra do compasso, não o início da linha.- Os itens recebem seu próprio
"word", para que cada chip, check ou nó apareça conforme é dito. É isso que o faz parecer editado. - Finalizando uma peça:
"until_word": jtermina após a palavra j- caso contrário, mantém-se por cerca de 2–3s, ou até 1,4s após seu último item
"dur": 2.5define a duração diretamente
- Outros momentos também podem ser cronometrados por palavras:
strike_word,reply_word(chat),right_word(versus),move_word/move_end_word(scale),meter_word(person),close_word(fechando chips).
4. Densidade do kit (kit.json → visuals.density)
| densidade | frequência | sensação |
|---|---|---|
calm | uma peça a cada 8–10s | um explicador especialista limpo |
steady | a cada 4–6s | a maioria dos reels |
busy | a cada 2–4s, quase contínuo | o estilo rápido de "explicador" |
Regras em todas as densidades:
- Uma peça de cada vez. Duas podem se sobrepor apenas se estiverem em zonas diferentes e pertencerem ao mesmo compasso.
- Nunca durante o gancho (primeiros ~3s) ou uma declaração. Peças podem substituir declarações: em
busy, use no máximo 1 declaração. - Não use o mesmo tipo duas vezes seguidas, a menos que seja a mesma lista continuando.
- Um pop
worddeve condensar ou reformular, não espelhar a legenda. Quando mostra as mesmas palavras, o mecanismo esconde a legenda enquanto está ativo. Isso funciona, mas um pop como "o negócio todo" em "visão geral abrangente do seu negócio" adiciona mais do que repetir "não negociáveis". - Não coloque um destaque (
highlight_words) em uma palavra que também recebe um pop-up. chatconta uma pequena história por si só: digita o prompt (com cliques de tecla), envia (som de deslizar), mostra a IA "pensando", e então oreplyse fornecido. Dê cerca de 1,5s após o término da digitação para que possa enviar. Umreplycurto nas palavras deles (o resultado que descrevem) faz com que funcione.- Deixe pequenas pausas para respirar (≥0,4s) entre as peças.
"at"substitui a zona (top,left,right,chest) apenas quando o padrão colide com algo.
5. Construa e verifique
uv run tools/build.py projects/<name>. A build imprime CHECK=…/check.png: um quadro por momento e pop-up. Leia-o e corrija qualquer coisa que esteja:
- ilegível
- fora da tela
- cobrindo o rosto
- colidindo com uma legenda
- ilustrando a palavra errada
- listada em uma linha
SAFE ZONE:(fica sob o nome de usuário, legenda ou botões de curtir / comentar / compartilhar do Instagram). Corrija cada um: mova a peça ("at"), encurte seu texto ou termine-a mais cedo, então reconstrua até que não haja nenhum.
O que vai na tela:
- Sem travessões em pop-up, gancho ou texto de declaração. Use uma vírgula, um ponto final ou uma quebra de linha.
- Apenas números reais quando são do próprio usuário e ele os disse. Janelas de chat, comentários e DMs usam placeholders genéricos, nunca o nome de uma pessoa real ou um resultado inventado mostrado como prova.
- A postagem ou reel de outro criador na tela recebe o @handle dele.
Em seguida, retorne como na skill de novo reel, adicionando uma linha como: "12 pop-ups: chips para suas 4 tarefas, uma janela de chat em 'prompt', um hub para seu sistema de IA…".
Quando o usuário perguntar
-
"Quais gráficos você pode adicionar?" / "mostre as opções": abra o vídeo catálogo se existir um para o kit deles (
projects/*/catalog-<kit>.mp4). Caso contrário, renderize um no reel mais recente deles:uv run tools/build.py projects/<name> --catalog. Mostra cada peça uma vez, na aparência deles, rotulada. Nunca descreva peças extensivamente no lugar. -
"Mais / menos pop-ups": altere a densidade para este reel; salve-a no
visuals.densitydo kit se eles disserem "sempre". -
"Um checklist aqui" / "mostre meu perfil quando eu disser seguir": adicione exatamente essa peça naquela palavra.
-
Estilo ("cards contornados", "animações mais calmas", "ícones mais grossos"): o bloco
"visuals"do kit:card:solid/outline/glassmotion:gentle/snappy/bouncyicon_stroke: 1,5–2,5radius- cores:
accent,strong,alert,word,card_color; nomes de cores do kit ou valores hexadecimais
Altere o kit deles, nunca uma predefinição.