Communitygithub.com

elkl111/reels-editing-lab-beta

Configuração inicial do Reels Editing Lab. Instala o que está faltando, faz uma breve entrevista de marca, permite que o usuário escolha seu visual no próprio vídeo e o salva como seu kit. Use quando o usuário disser "me configurar", "começar", "me guiar" ou quando o arquivo brand/kit.txt ainda não existir (o Lab não foi configurado).

O que é reels-editing-lab-beta?

Esta skill automatiza a experiência de integração para o Reels Editing Lab, um conjunto de ferramentas de IA para edição de vídeos no estilo Reels. O público-alvo são criadores de conteúdo não técnicos que desejam um fluxo de trabalho de edição de vídeo personalizado, sem complicações. A skill verifica e instala dependências, conduz uma entrevista de marca de três perguntas (energia, preferências de marca, elementos a evitar), e orienta o usuário na criação de um kit de estilo visual personalizado com base em sua própria filmagem. O usuário pode escolher entre temas predefinidos ou criar um visual baseado em referências como arquivos de design, capturas de tela ou códigos de cores. A skill garante que tudo esteja pronto para a primeira edição real, com comandos como /new-reel e /update. As plataformas suportadas incluem macOS com chip Apple e as ferramentas são gerenciadas via Homebrew, Python e Playwright. O processo é descrito em etapas detalhadas, cobrindo desde a instalação até a personalização de cores, fontes e estilo de animação.

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

Perguntar na sua IA favorita

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

Documentação

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:

  1. mac / espaço: se algum falhar, pare e explique gentilmente (Mac com chip Apple necessário; cerca de 6 GB livres).
  2. 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 echo e eval; peça a ele para colar essas também. Aguarde ele dizer que terminou, então verifique novamente.
  3. 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.
  4. ffmpeg: brew install ffmpeg (use /opt/homebrew/bin/brew se brew não estiver no caminho ainda).
  5. uv: curl -LsSf https://astral.sh/uv/install.sh | sh, depois use ~/.local/bin/uv se uv não for encontrado ainda.
  6. python-tools: uv sync
  7. renderizador: uv run playwright install chromium
  8. modelo-de-fala: uv run tools/get_models.py em 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").

  1. 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).
  2. 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'."
  3. 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):

  1. uv run tools/transcribe.py "<clipe>" --name welcome-sample

  2. Leia projects/welcome-sample/lines.md. Escreva cut.json com 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). Execute uv run tools/roughcut.py projects/welcome-sample --no-open e uv 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.

  3. Escreva build.json como na skill new-reel: um gancho escrito com a skill hooks a 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 skill visuals (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".

  4. 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ós LOOKS=. Olhe a imagem você mesmo primeiro (Leia-a) e verifique se o texto é legível e nada cobre o rosto.

  5. Apresente os visuais em uma linha curta cada, na ordem impressa, usando a description de 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.

  6. 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"):

  1. Copie packs/<preset>/kit.json para packs/<primeiro-nome-em-minúsculo>/kit.json. Na cópia:

    • "name": o nome dele
    • "preset": false
    • "based_on": "<preset>"
  2. Aplique a energia dele:

    Energiaintensidadesalto zoom / socovolume_db sfxdeclarações
    calmo e ponderadolimpo1.04 / 1.08−17no máximo 1
    caloroso e conversadorassinatura1.07 / 1.13−13no máximo 1–2
    alta energiacompleto1.12 / 1.22−10até 2

    Altere rules.intensity, zoom, sfx.volume_db e a redação de rules.statement para corresponder.

    Conjunto de som (sfx.palette):

    • calmo: soft
    • caloroso: soft ou playful
    • alta energia: punchy
    • tópicos de tecnologia ou IA: considere clicky

    Mencione uma vez que ele pode ouvir cada som em sfx/sound-menu.mp4 e trocar de conjuntos perguntando ("use os sons divertidos"). Se ele disse "sem efeitos sonoros", defina "sfx": {}. Se ele disse sem maiúsculas, defina style.caption_case, style.hook_case e style.statement_case como "none".

  3. 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 colors e mantenha os papéis: cores claras vão em cartões e legendas, escuras em fundos de declaração e tinta, brilhantes em destaques e visuals.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.py confirma que existe).
  4. Escreva o nome da pasta do kit em brand/kit.txt.

  5. 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 em kit.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):

  1. Obtenha o arquivo. Peça a ele para arrastá-lo para o chat ou soltá-lo em brand/, então salve uma cópia como brand/design.md (ou mantenha o PDF) como a fonte da verdade para o visual dele.

  2. Mapeie para o kit dele:

    No arquivo de designNo kit.json
    paleta de cores (códigos hex e para que servem)colors, mais roles: fundos → hook_card e label_bg; cor do texto → ink e hook_text; o bloco "declaração" ou escuro → statement_bg; cores de destaque → highlight_blocks; acentos → accent_pill, visuals.rotate
    regras do tipo "nunca preto ou branco puro"use a cor de marca mais escura dele como tinta
    fonte de título e exibiçãofonts.display / poster, seu itálico como fonts.italic, uma sans para label e legendas
    movimentos característicos (mistura de itálico, blocos de destaque atrás de palavras, inclinação, adesivos, maiúsculas)moves e style (hook_case, statement_case, radius)
    clima ("calmo", "divertido", "luxuoso")visuals.motion, visuals.density, sfx.palette
    estilo 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)
  3. 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."

  4. Mostre: renderize --looks <kit-dele> e construa sample-mine. Diga quais partes vieram diretamente do arquivo dele e quais você interpretou.

  5. Mantenha sincronizado: se ele atualizar o arquivo de design depois ("Mudei as cores da minha marca"), releia brand/design.md e 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:

  1. 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 é
  2. 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": true para um itálico). Confirme se cada uma baixa com uv run tools/fonts.py "<família>" --weight N. Se ele possui uma fonte paga, ele pode colocar o arquivo em fonts/private/ e usar {"family": "...", "file": "fonts/private/<arquivo>", "weight": N}.
  3. Não copie as fontes e cores exatas de outro criador. Pegue a sensação, não o visual registrado.
  4. Renderize --looks <kit-dele> para verificar, então construa sample-mine como 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 em brand/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 sombra
  • caption_case: "none" / "uppercase"
  • hook: "card" / "bare" (sem cartão, texto com contorno)
  • hook_size
  • hook_case
  • statement_case
  • label: "ticket" / "pill"
  • label_mark: o símbolo entre nome e tópico
  • radius
  • shadow / shadow_soft: cores rgba

"captions":

  • mode: "karaoke" (palavras acendem), "phrase" (frase inteira), "word" (uma palavra grande de cada vez)
  • size
  • max_words
  • position_y

"moves":

  • tilt_degrees
  • highlighter_blocks

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

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.

elkl111/reels-editing-lab-beta

The visual director. Plans the pop-up explainer graphics (chips, numbers, chat windows, checklists, diagrams…) that illustrate what the speaker says, beat by beat, in their kit's style. Use in the new-reel build step, when the user asks for more or fewer graphics ("more pop-ups", "illustrate this part", "a checklist here"), or asks what graphics exist ("what can you add?", "show me the options").

Habilidades Relacionadas