Communitygithub.com

elkl111/reels-editing-lab-beta

O diretor visual. Planeja os gráficos explicativos pop-up (chips, números, janelas de chat, checklists, diagramas…) que ilustram o que o palestrante diz, compasso por compasso, no estilo do kit. Use na etapa de construção do novo reel, quando o usuário pedir mais ou menos gráficos ("mais pop-ups", "ilustre esta parte", "um checklist aqui"), ou perguntar quais gráficos existem ("o que você pode adicionar?", "mostre as opções").

O que é reels-editing-lab-beta?

Esta skill (Visual Director) atua como o diretor visual de reels do tipo "talking-head", planejando e coordenando a inserção de elementos gráficos pop-up que ilustram a fala do apresentador. Sua principal função é traduzir o roteiro (arquivo `edl.json`) em uma sequência de "peças" visuais — como chips, números, janelas de chat, checklists, fluxos, etc. — sincronizadas palavra por palavra com a transcrição (`transcript.json`). A skill lê os compassos do discurso, identifica aqueles com conteúdo "mostrável" (listas, números, ações, processos, etc.), escolhe o tipo de peça adequado (baseado em uma tabela de mapeamento), define sua posição e duração (`word` e `until_word`), e monta a lista de visuais em `build.json`. Ela também gerencia a densidade dos pop-ups (de `calm` a `busy`), integra peças especiais como memes (somente sob demanda), inserts personalizados (via subagentes paralelos) e elementos do perfil do Instagram do usuário. Após o planejamento, executa a build com `uv run tools/build.py` e gera uma imagem de verificação (`check.png`) para que o agente (ou o usuário) possa validar e corrigir problemas de legibilidade, colisão ou posicionamento. A skill é projetada para uso na etapa de construção de um novo reel, e também responde a comandos como "mais pop-ups", "mostre as opções" (renderizando um catálogo visual), "adicione um checklist aqui", ou alterações de estilo (sólido, outline, etc.). Ela depende das ferramentas Python do projeto (como `tools/insert.py`, `tools/memes.py`, `tools/build.py`) e de arquivos do kit (`kit.json`, `brand/instagram.json`, `brand/keys.json`, `brand/reels/`).

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/elkl111/reels-editing-lab-beta/tree/HEAD/.claude/skills/visuals

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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çaExemplo
uma lista ("marketing, notas fiscais, e-mails")chips, um item por palavra conforme é ditoitens 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 linhaword ("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 DMchat"prompt": "...", "reply": "..." (opcional)
uma venda, uma mensagem, uma reserva, uma notificaçãonotify"app": "Stripe", "title": "Novo pagamento: €497"
passos concluídos, uma lista de tarefas, vitóriaschecklistitens com word cada
"passo 1 / a primeira coisa / parte dois"step"n": 1, "text": "*treine*-a"
uma mudança ou processo (A → B → C)flowitens com icon e text
um sistema, ferramentas conectadas, "tudo em um lugar"hubcenter mais nodes com ícones
um período ou intervalo de tempo ("em um mês… em 3 anos")scalemarks, from, to, move_word
um cliente, uma pessoa, uma história sobre alguémperson"name": "Abby", "note": "coach", "meter": 3
isto vs aquilo, caminho antigo vs caminho novoversusleft (o ✗) / right (o ✓), right_word
um meme ou GIF, apenas quando o usuário pedir umgif"file": "projects/<name>/memes/3.mp4", "caption": "eu lendo minhas *legendas* antigas"
o perfil deles, uma captura de tela, um aplicativophone"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 chat e notify

Í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} em events (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 com uv 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 gif com "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 pop word faz 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 com visuals.word_style: "rise".
  • As legendas podem aparecer com pop borrado usando captions.pop: "blur".

Inserts personalizados (subagentes paralelos)

  1. Trave o tempo primeiro: os tempos das palavras que deve atingir, convertidos para o relógio do próprio insert (t = 0 quando aparece).
  2. 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.
    • 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.
  3. Posicione-o com {"kind": "insert", "file": "…/insert.mov", "word": i, "width": 640}. Adicione sfx_extra cliques 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.
  • Arquivo próprio deles ("use este GIF"): uv run tools/memes.py add "<arquivo>" --project projects/<name> gera memes/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 alterar file e reconstruir.

  • Sem chave (MEMES=sem-chave): ofereça a configuração gratuita de 3 minutos:

    1. Eles vão em developers.giphy.com, se cadastram, criam um aplicativo API (não SDK) e copiam a chave.
    2. Eles colam a chave no chat.
    3. Você a salva em brand/keys.json como {"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": i faz 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": j termina 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.5 define 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)

densidadefrequênciasensação
calmuma peça a cada 8–10sum explicador especialista limpo
steadya cada 4–6sa maioria dos reels
busya cada 2–4s, quase contínuoo 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 word deve 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.
  • chat conta 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 o reply se fornecido. Dê cerca de 1,5s após o término da digitação para que possa enviar. Um reply curto 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.density do 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 / glass
    • motion: gentle / snappy / bouncy
    • icon_stroke: 1,5–2,5
    • radius
    • cores: accent, strong, alert, word, card_color; nomes de cores do kit ou valores hexadecimais

    Altere o kit deles, nunca uma predefinição.

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

elkl111/reels-editing-lab-beta

Write hooks for a reel that are curious but human, true to the reel and specific to it. Use in the new-reel flow (opening check after the rough cut; on-screen hook and cover title in the build), when the user asks to change the hook ("hook 2", "different hook", "punchier hook"), or before filming ("give me hooks for a reel about X", "how should I open this?").

elkl111/reels-editing-lab-beta

Edit a talking-head reel from a raw clip. Use whenever the user says "I have a new reel", "edit this reel", "new clip", drags a video into the chat or drops one in inbox/, or gives edits to a rough cut ("drop line 3", "end line 9 at…", "good, move on"). Covers transcription, the rough cut and the review, all in the chat.

elkl111/reels-editing-lab-beta

Bundle a problem report for the Lab's maker. Use when the user says something is broken, wrong or confusing and wants to report it ("report a problem", "this isn't working, tell Elena", "send feedback"), or when a tool keeps failing after you've tried to fix it.

elkl111/reels-editing-lab-beta

First-time onboarding for the Reels Editing Lab. Installs what's missing, runs a short brand interview, lets the user pick their look on their own footage, and saves it as their kit. Use when the user says "set me up", "get started", "onboard me", or when brand/kit.txt doesn't exist yet (the Lab hasn't been set up).

elkl111/reels-editing-lab-beta

Update the Reels Editing Lab to the newest version. Use when the user says "update", "update the Lab", "is there a new version?", or was told a new version is out.

Habilidades Relacionadas