Me configurar
O usuário acabou de abrir o Lab pela primeira vez. Ele não é técnico. Ao final, ele terá tudo instalado, um visual escolhido ao vê-lo em seu próprio rosto e seu próprio kit salvo. Então estará pronto para seu primeiro reel.
Tom: caloroso, breve, um passo de cada vez. Diga o que está acontecendo enquanto ele espera. Nunca cole a saída bruta de ferramentas para ele. Nunca peça para ele executar um comando, exceto a linha do Homebrew se estiver faltando (veja o passo 1).
Comece com uma mensagem curta:
Bem-vindo ao Reels Editing Lab. A configuração leva cerca de 10 minutos: instalo algumas coisas, faço 3 perguntas rápidas e então você escolhe seu visual vendo-o em seu próprio vídeo. Vamos lá.
1. Instalar (≈5 min, principalmente o download do modelo de fala)
Execute python3 tools/doctor.py. Ele imprime uma lista de verificação e DOCTOR=ok ou DOCTOR=missing:<nomes>. Corrija os itens ausentes nesta ordem, executando novamente o doctor ao final:
- mac / espaço: se algum falhar, pare e explique gentilmente (Mac com chip Apple necessário; cerca de 6 GB livres).
- homebrew: você não pode instalá-lo para ele, pois precisa da senha do Mac em um Terminal real. Explique em uma linha o porquê, então forneça a linha exata da correção do doctor, dizendo a ele para abrir o aplicativo Terminal (Cmd+Espaço, digite Terminal), colar, pressionar Enter, digitar a senha do Mac (nada aparece enquanto digita; isso é normal) e seguir as instruções. Ao final, o Homebrew imprime duas linhas "Próximos passos" começando com
echoeeval; peça a ele para colar essas também. Aguarde ele dizer que terminou, então verifique novamente. - apple-tools: execute
xcode-select --install. Uma janela do Mac aparece; diga a ele para clicar em Instalar e avisar quando terminar (alguns minutos). O Homebrew geralmente já instala esses, então verifique primeiro. - ffmpeg:
brew install ffmpeg(use/opt/homebrew/bin/brewsebrewnão estiver no caminho ainda). - uv:
curl -LsSf https://astral.sh/uv/install.sh | sh, depois use~/.local/bin/uvseuvnão for encontrado ainda. - python-tools:
uv sync - renderizador:
uv run playwright install chromium - modelo-de-fala:
uv run tools/get_models.pyem segundo plano (2.3 GB). Ele retoma sozinho se a conexão cair. Inicie-o, depois prossiga para a entrevista enquanto ele baixa. Verifique-o novamente antes do passo 3 precisar dele.
Enquanto as coisas instalam, diga a ele em uma linha para que serve cada peça (as descrições do doctor são escritas para isso).
2. Entrevista de marca (3 perguntas, uma de cada vez)
Pergunte de forma conversacional, uma pergunta por mensagem. Mantenha as palavras exatas dele.
Não peça nome, slogan ou rótulo "o que você faz": o Lab não adiciona um por padrão (veja a skill new-reel, "label").
- Energia. "Como você é na câmera: calmo e ponderado, caloroso e conversador, ou de alta energia?" Isso define o quão movimentada é a edição (veja a tabela no passo 4).
- Marca. "Você tem um arquivo de marca ou design, cores de marca ou fontes? Envie seu arquivo de design (um .md ou PDF) e eu construirei seu visual a partir dele. Ou cole códigos de cores, ou arraste 3-6 capturas de tela de reels cujo visual você ama para a pasta
inspiration. Ou apenas diga 'não, mostre-me opções'." - Nunca. "Algo que você nunca quer em seus reels? Por exemplo, texto em maiúsculas, certos emojis, efeitos sonoros, palavras que você nunca diria."
Salve as respostas em brand/profile.md:
# Perfil
- Energia: caloroso e conversador
- Marca: cores #… / fontes … / capturas de tela em inspiration/ / nenhuma
- Nunca: …
Adicione também cada "nunca" a brand/preferences.md como uma regra de uma linha.
3. Ver os visuais em seu próprio rosto
Pergunte: "Agora envie qualquer clipe seu falando para a câmera, idealmente 20 segundos ou mais. Arraste-o para este chat ou para a pasta inbox. Não precisa ser uma boa tomada; é só para testar visuais."
Quando o clipe estiver lá (e o modelo de fala tiver terminado):
-
uv run tools/transcribe.py "<clipe>" --name welcome-sample -
Leia
projects/welcome-sample/lines.md. Escrevacut.jsoncom as primeiras 3-5 linhas limpas, cerca de 12-20 segundos, usando as regras de corte bruto do new-reel (última tomada limpa, sem falsos começos). Executeuv run tools/roughcut.py projects/welcome-sample --no-openeuv run tools/verify.py projects/welcome-sample, e corrija qualquer coisa que ele sinalizar. Não peça a ele para revisar este corte; é apenas uma amostra. -
Escreva
build.jsoncomo na skill new-reel: um gancho escrito com a skillhooksa partir do que ele realmente disse (esta é a primeira impressão dele do Lab, então faça algo bom), 1-2 palavras de destaque, 1 zoom e uma declaração na linha mais forte. Adicione 2-4 pop-ups com a skillvisuals(por exemplo, chips para uma lista que ele mencionou, ou uma janela de chat se ele falar sobre prompts), para que ele veja o que o Lab realmente faz. Não adicione um momento "behind". -
Folha de visuais:
uv run tools/build.py projects/welcome-sample --looks presets. Ele abre uma imagem com o clipe dele em cada visual, lado a lado, na ordem impressa apósLOOKS=. Olhe a imagem você mesmo primeiro (Leia-a) e verifique se o texto é legível e nada cobre o rosto. -
Apresente os visuais em uma linha curta cada, na ordem impressa, usando a
descriptionde cada kit (packs/<nome>/kit.json). A linha superior mostra o gancho e legendas; a linha inferior mostra os pop-ups. Então diga claramente que um visual é um ponto de partida, não uma escolha final:Escolha aquele cuja sensação você mais gostar. Tudo pode ser mudado depois: "este, mas em sálvia e creme", "use minhas cores: #…", "uma fonte mais suave", "sem rosa". Vou refazê-lo no seu clipe para que você possa ver.
Pergunte qual ele gostaria de ver em movimento.
-
Para cada um que ele escolher:
uv run tools/build.py projects/welcome-sample --kit <nome> --out sample-<nome>. Ele abre no QuickTime. Se ele escolher dois, construa ambos e abra um após o outro.
Se ele forneceu cores de marca, fontes ou capturas de tela no passo 2, também ofereça: "Ou posso fazer um visual a partir da sua marca." Veja o passo 5.
4. Salvar o kit dele
Quando ele escolher (por exemplo "Editorial, mas em sálvia e creme" ou "Divertido, mas mais calmo"):
-
Copie
packs/<preset>/kit.jsonparapacks/<primeiro-nome-em-minúsculo>/kit.json. Na cópia:"name": o nome dele"preset": false"based_on": "<preset>"
-
Aplique a energia dele:
Energia intensidade salto zoom / soco volume_db sfx declarações calmo e ponderado limpo 1.04 / 1.08 −17 no máximo 1 caloroso e conversador assinatura 1.07 / 1.13 −13 no máximo 1–2 alta energia completo 1.12 / 1.22 −10 até 2 Altere
rules.intensity,zoom,sfx.volume_dbe a redação derules.statementpara corresponder.Conjunto de som (
sfx.palette):- calmo:
soft - caloroso:
softouplayful - alta energia:
punchy - tópicos de tecnologia ou IA: considere
clicky
Mencione uma vez que ele pode ouvir cada som em
sfx/sound-menu.mp4e trocar de conjuntos perguntando ("use os sons divertidos"). Se ele disse "sem efeitos sonoros", defina"sfx": {}. Se ele disse sem maiúsculas, definastyle.caption_case,style.hook_caseestyle.statement_casecomo"none". - calmo:
-
Aplique as cores dele, seja da entrevista ou do momento em que ele pedir ("use estas cores em vez disso"):
- De códigos hex ou nomes simples: "sálvia" ou "rosa empoeirado" são aceitáveis; escolha hexes de bom gosto e informe-o.
- Troque os valores em
colorse mantenha os papéis: cores claras vão em cartões e legendas, escuras em fundos de declaração e tinta, brilhantes em destaques evisuals.rotate. - Verifique o contraste: o texto deve ser legível em seu fundo.
- Re-renderize a folha de visuais para o kit dele (
--looks <kit-dele>) para que ele veja antes da amostra completa. - Fontes funcionam da mesma forma: qualquer fonte gratuita do Google Fonts (
fonts.pyconfirma que existe).
-
Escreva o nome da pasta do kit em
brand/kit.txt. -
Construa a amostra mais uma vez no kit dele:
uv run tools/build.py projects/welcome-sample --out sample-mine. Ela abre no QuickTime. Pergunte: "Este é o seu visual. Algo que você mudaria?" Aplique as alterações ao kit dele (não ao preset) e reconstrua até que ele esteja satisfeito. Pequenas mudanças como "legendas menores", "menos amarelo" ou "sem inclinação" são edições de uma linha emkit.json.
5. Fazer um visual a partir da marca dele (quando solicitado)
A partir de um arquivo de design (a melhor maneira)
Se ele tiver um documento de marca ou design (um .md, PDF ou exportação do Google Doc, como um BRAND-DESIGN.md):
-
Obtenha o arquivo. Peça a ele para arrastá-lo para o chat ou soltá-lo em
brand/, então salve uma cópia comobrand/design.md(ou mantenha o PDF) como a fonte da verdade para o visual dele. -
Mapeie para o kit dele:
No arquivo de design No kit.jsonpaleta de cores (códigos hex e para que servem) colors, maisroles: fundos →hook_cardelabel_bg; cor do texto →inkehook_text; o bloco "declaração" ou escuro →statement_bg; cores de destaque →highlight_blocks; acentos →accent_pill,visuals.rotateregras do tipo "nunca preto ou branco puro" use a cor de marca mais escura dele como tinta fonte de título e exibição fonts.display/poster, seu itálico comofonts.italic, uma sans paralabele legendasmovimentos característicos (mistura de itálico, blocos de destaque atrás de palavras, inclinação, adesivos, maiúsculas) movesestyle(hook_case,statement_case,radius)clima ("calmo", "divertido", "luxuoso") visuals.motion,visuals.density,sfx.paletteestilo de foto ou vídeo (quente, sombrio, brilhante, cinematográfico) grade:contrast,saturation,brightness,warmth(−0.05 a 0.05),vignette(0–0.5),legibility(gradientes escuros atrás do texto, 0–0.5). Mantenha a pele natural: sem granulação de filme, sem esmagamento pesado.ícones, elementos gráficos, adesivos, botões (espessura da linha, arredondado ou quadrado, blocos de cor preenchidos) visuals.icon_stroke(fino 1.5 → negrito 2.5),visuals.radius,visuals.card(sólido / contorno / vidro),visuals.accent(cor do bloco do ícone),visuals.rotate(cores de chip e adesivo) -
Fontes pagas ou personalizadas: procure pelos arquivos de fonte. Se ele os tiver, ele os coloca em
fonts/private/e o kit usa"file". Se não, escolha a fonte gratuita do Google Fonts mais próxima: combine o contraste, a largura (alta ou condensada?) e se existe um itálico. Diga a ele o que você substituiu e por quê. Por exemplo, "sua serifa paga → Instrument Serif: mesma sensação alta e de alto contraste, tem itálico." -
Mostre: renderize
--looks <kit-dele>e construasample-mine. Diga quais partes vieram diretamente do arquivo dele e quais você interpretou. -
Mantenha sincronizado: se ele atualizar o arquivo de design depois ("Mudei as cores da minha marca"), releia
brand/design.mde atualize o kit da mesma forma.
A partir de capturas de tela ou cores coladas
Quando ele quiser seu próprio visual em vez de um preset:
- Leia as capturas de tela dele em
inspiration/, seu guia de marca ou os códigos que ele colou. Anote:- tipo: serifa ou sans, quão pesado, se é em maiúsculas, se mistura itálico
- tratamento de legenda: contorno, sombra ou caixa; frase inteira ou palavra por palavra
- formas e raio dos cartões
- 4-6 cores
- quão movimentado é
- Comece pelo preset mais próximo e mude apenas o que for diferente. As fontes devem ser fontes gratuitas do Google Fonts: escreva
{"family": "<nome da fonte Google>", "google": true, "weight": N}(adicione"italic": truepara um itálico). Confirme se cada uma baixa comuv run tools/fonts.py "<família>" --weight N. Se ele possui uma fonte paga, ele pode colocar o arquivo emfonts/private/e usar{"family": "...", "file": "fonts/private/<arquivo>", "weight": N}. - Não copie as fontes e cores exatas de outro criador. Pegue a sensação, não o visual registrado.
- Renderize
--looks <kit-dele>para verificar, então construasample-minecomo no passo 4, e itere no chat.
6. Finalizar
Em cerca de 3 linhas, diga a ele:
- o visual dele está salvo e todo reel usará automaticamente
- como editar um reel: coloque um clipe em
inbox/ou no chat e diga "edite este reel". Você corta, ele revisa as linhas no chat, e você constrói no visual dele. - que os gráficos de pop-up ilustram o que ele diz; "mostre-me os gráficos" reproduz o catálogo de todos os 14 no visual dele
- extras opcionais: coloque 6 dos próprios reels dele no chat para o efeito "reels orbitando você" e a grade de perfil (
tools/reels.py add); forneça os números reais do Instagram dele uma vez (salvo embrand/instagram.json) para a animação de seguidor - que ele pode pedir um meme ou GIF em qualquer linha ("o meme 'ew' da David Rose aqui"). A pesquisa precisa de uma chave GIPHY gratuita, que você o ajudará a obter na primeira vez; os próprios arquivos GIF dele funcionam imediatamente
- que cores e fontes nunca são fixas: "use estas cores em vez disso" funciona em qualquer reel, a qualquer momento
- que ele pode mudar qualquer coisa a qualquer momento apenas dizendo ("legendas menores", "sem sons neste", "tente o visual Loud neste reel")
- que os reels finalizados vão para a pasta Finished reels
- os comandos: /new-reel para um novo clipe (inicie um novo chat nesta pasta para cada reel), /update para obter novas versões, e /report-problem se algo quebrar
Então ofereça: "Quer editar o clipe completo que você acabou de me dar como seu primeiro reel de verdade?" Se sim, execute a skill new-reel nele, neste chat.
Alternadores de estilo do kit (para ajustes)
kit.json → "style":
caption_outline: px; 0 significa apenas uma sombracaption_case: "none" / "uppercase"hook: "card" / "bare" (sem cartão, texto com contorno)hook_sizehook_casestatement_caselabel: "ticket" / "pill"label_mark: o símbolo entre nome e tópicoradiusshadow/shadow_soft: cores rgba
"captions":
mode: "karaoke" (palavras acendem), "phrase" (frase inteira), "word" (uma palavra grande de cada vez)sizemax_wordsposition_y
"moves":
tilt_degreeshighlighter_blocks