Communitygithub.com

style-lab

Aprende um estilo de edição de vídeo a partir de vídeos de referência ou de uma descrição e edita seu material com um plano de edição e rodadas de revisão. Gatilhos: editing style, style-lab, סגנון.

O que é style-lab?

O style-lab é um skill avançado para Claude Code projetado para treinar e aplicar estilos de edição de vídeo. Ele permite que o usuário ensine ao Claude um estilo visual específico — seja copiado de vídeos de referência ou definido por uma descrição textual — e, em seguida, edite novos clipes seguindo esse estilo, com supervisão humana em pontos críticos. O processo é dividido em duas fases principais: a Fase A (treinamento), onde o skill analisa referências, cria um quadro de estilo (style board) detalhado, documenta cada animação e gera um pacote de estilo com regras mensuráveis; e a Fase B (edição), onde o usuário seleciona um estilo pronto, o Claude transcreve e corta o áudio, elabora um plano de edição visual e constrói o vídeo final com o mecanismo HyperFrames. O skill enfatiza a rastreabilidade de cada decisão, o uso de regras numeradas e a colaboração humana em três checkpoints: o quadro de estilo, o plano de edição e as rodadas de revisão. Ele suporta hebraico e inglês, opera com ferramentas locais como ffmpeg e Python, e é distribuído sob licença Apache-2.0 como parte do curso 'וידאו עם AI' (Vídeo com IA) de Gabriel Gelman.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Malik-rgb43/style-lab-skill/tree/HEAD

Perguntar na sua IA favorita

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

Documentação


name: style-lab description: Aprende um estilo de edição de vídeo a partir de vídeos de referência ou de uma descrição e edita seu material com um plano de edição e rodadas de revisão. Gatilhos: editing style, style-lab, סגנון.

O que style-lab faz?

Quando usar (lista completa de gatilhos)

Use quando o usuário quiser criar, definir, copiar, aprender ou treinar um estilo ou aparência de edição a partir de vídeos de referência (links ou arquivos) ou de uma descrição escrita; construir um quadro de estilo ou guia de estilo; transformar reels de referência em um estilo reutilizável; ou editar um clipe de cabeça falante ou formato curto "no estilo de" um estilo treinado e, em seguida, corrigi-lo em rodadas de revisão. Também para: "deixar meus vídeos com a aparência deste criador", "salvar esta aparência para que todo vídeo corresponda", "a edição parece genérica / de IA". Hebraico: סגנון עריכה, ליצור סגנון, ללמד את Claude סגנון, בורד סגנון, לוח השראה, ריפרנסים, תערוך בסגנון, תוכנית עריכה, סבב הערות, סטייל לסרטונים.

סקיל = הוראות קבועות ל־Claude. Este skill faz parte dos skills do curso "וידאו עם AI" (Vídeo com IA) por Gabriel Gelman (Apache-2.0). É um skill bônus avançado: pressupõe Claude Code com ffmpeg e Python, e funciona melhor com HyperFrames instalado.

Idioma: sempre fale com o usuário em hebraico, a menos que ele escreva em outro idioma. Explique cada etapa em palavras simples antes de executá-la (o que faremos, por que, o que o usuário faz agora), uma etapa de cada vez, e nomeie a etapa ("שלב A2: בורד הסגנון"). Todas as páginas que o usuário vê (board, plan, review room) seguem o design do curso: RTL hebraico, Karantina / Heebo, branco-preto-violeta.

Inspiração: o fluxo de trabalho em duas fases (treinar um estilo a partir de ~20 vídeos de referência e um board, depois editar com um plano feito por humanos) foi inspirado no vídeo de Joseph sobre edição de vídeos de cabeça falante com Claude (https://youtu.be/g9xoKm5DEeU). Nada do vídeo é copiado aqui; as páginas de board, plan e review, os scripts, as regras e o loop de revisão são nossos, reconstruídos e testados em um lote de 13 Reels.

A ideia em um parágrafo

Os vídeos de referência ensinam ao Claude a lógica por trás das animações (quando, por quanto tempo, como se movem); o board ensina o design (fontes, cores, tamanhos, por quê). Sem ambos, as edições parecem genéricas. O gosto humano aparece em três pontos de verificação: o board (fase A), o plano de edição (fase B) e as rodadas de revisão. O Claude faz o trabalho pesado entre eles. Se você não sabe o que torna um estilo bom, a IA só ajuda a fazer vídeos ruins mais rápido, então toda regra é medida e cada escolha de design recebe um "por quê".

Padrões (diga-os em uma linha no início, mude mediante solicitação)

  • Marca: a marca do curso (references/brand-defaults.md: Karantina 700 para manchetes, Heebo corpo a -0.04em, Consolas para código, branco / preto / violeta). O layout, movimento e estrutura da referência são mantidos; suas fontes e cores são trocadas pela marca. O usuário pode manter a aparência original da referência para um estilo, ou colocar sua própria marca em ~/.claude/style-lab/brand.md.
  • Mecanismo de construção: HyperFrames (HTML para vídeo). Sem ele: references/tools-and-fallbacks.md.
  • Transcrição: faster-whisper local; hebraico com um modelo ivrit-ai local. Nuvem (RunPod) somente com a aprovação do usuário, pois custa dinheiro.
  • Imagens / 3D: opcional, apenas quando uma batida as exige, e somente com a aprovação do usuário se for pago.
  • Formato: 9:16, 1080x1920, 30 fps, a menos que o usuário diga o contrário. Nunca presuma o idioma da legenda: pergunte (ou sem legendas). Verifique primeiro o que está instalado (ffmpeg, Python, faster-whisper, Node + HyperFrames, Blender, um modelo de imagem) e diga o que você usará. Uma ferramenta ausente bloqueia sua etapa: diga qual e o que instalar; nunca pule uma etapa silenciosamente, nunca baixe nada sem um sim.

Seus estilos (vários estilos nomeados lado a lado)

Cada estilo tem um nome escolhido pelo usuário (hebraico é aceitável), um slug latino, uma descrição de uma linha, seu próprio pacote de estilo e seu próprio skill de estilo style-<slug>. Todos estão listados em um registro, ~/.claude/style-lab/styles.json, gerenciado com scripts/styles.py:

python scripts/styles.py list                       # estilos que você pode escolher
python scripts/styles.py add <slug> --name "<nome>" --pack <projeto>/styles/<slug> --description "..."
python scripts/styles.py show <slug ou nome>
python scripts/styles.py set <slug> name="<novo nome>" status=ready aliases="..." theme=light
python scripts/styles.py check                      # todo pacote e skill ainda existe

Status: training durante a fase A, ready após A5 (apenas estilos prontos são oferecidos para edição), archived para ocultar um. remove exclui apenas a entrada do registro, nunca arquivos. Cada estilo também registra fonts / colors (brand ou reference) e theme (dark, light ou both; um vídeo ainda pode ser "o outro tema").

Qual fase? "new style / ליצור סגנון / ללמד סגנון" → fase A. "edit / make a video / תערוך" → fase B. "change / rename / improve style X" → styles.py set, e para mudanças de regras, edite o STYLE.md e o skill desse estilo.

Onde as coisas ficam

<projeto>/styles/<slug>/            o pacote de estilo
  refs/  sources.md                 vídeos de referência (cópias de estudo locais, nunca publicadas)
  analysis/                         transcrições por vídeo, folhas de contato, anotações
  board/  board.json  board.html  thumbs/
  library/<V01-A06 title>/          still.png  strip.jpg  clip.mp4  notes.md  (+ index.json)
  animations.json                   a decomposição (entrada para o script da biblioteca)
  STYLE.md                          regras numeradas, tokens, categorias, movimento, som, regras de revisão
  kit/                              componentes testados opcionais para o mecanismo de construção
<projeto>/edits/<clipe>/             uma pasta por edição
  raw/  words.json  edit_ready.mp4  edit_ready.words.json  plan.json  plan.html
  build/  assets/  renders/  revisions.md  SOURCES.md
~/.claude/skills/style-<slug>/SKILL.md   o skill de estilo gerado
~/.claude/style-lab/styles.json          o registro

Scripts (locais, gratuitos): styles.py, transcribe_words.py, transcribe_cloud_ivrit.py (pago, opcional), cut_silences.py, verify_cut.py, word_edges.py, build_reference_library.py. Páginas: assets/board-template.html, assets/plan-template.html, assets/review-template.html.


Fase A: treinar um estilo (construir o pacote de estilo)

A1. Coletar as referências

  • Pergunte como chamar o estilo e peça uma descrição de uma linha; registre-o imediatamente (styles.py add ..., status training). Pergunte se deve usar a aparência da marca (padrão) ou a própria da referência.
  • Pergunte onde estão as referências. Vídeos: o usuário fornece arquivos ou links que ele tem permissão para baixar; aponte para ~20 dos melhores vídeos editados exatamente neste estilo; menos de ~12 resulta em uma biblioteca enxuta (diga isso, continue se o usuário quiser). Nomeie-os V01.mp4 …, liste cada um em refs/sources.md. Eles permanecem locais: nunca publicados, enviados ou colocados em um artefato.
  • Apenas descrição (sem vídeos): entreviste o usuário (sensação, fundamentos, tipo, movimento, legendas, som, o que é proibido), transforme cada adjetivo em um número e colete algumas imagens fixas ou capturas de tela que ele goste. Pule o trabalho de quadro de A3-A4; o board mostra tokens, regras e esboços em vez de quadros de referência, e a biblioteca começa vazia e cresce a partir de edições aprovadas.

A2. O quadro de estilo (a parte mais importante do treinamento)

  1. Analise cada referência: quadros a cada 0,5 s com ffmpeg (ou uma ferramenta de análise de vídeo se instalada), folhas de contato, volume de áudio. Leia as folhas.
  2. Proponha as categorias (sistema de legendas, layout, tipos de B-roll, gráficos, transições, CTA …); as próprias categorias do estilo vencem. references/example-style-3d-paper.md mostra um exemplo finalizado.
  3. Selecione 100-150 quadros de inspiração como miniaturas 9:16 (~360 px de largura) em board/thumbs/, e um quadro herói por categoria para anotar.
  4. Preencha board.json (esquema: references/board-and-spec.md): tokens (fontes, cores com hexadecimal extraído dos quadros, texturas, formas, dimensionamento, layout) e por categoria os tiles, um quadro anotado com 3-5 chamadas mensuráveis, e respostas preliminares para as quatro perguntas "por quê" (design, cores, efeitos, animações).
  5. Construa board.html a partir de assets/board-template.html (substitua o bloco JSON) e publique-o como um artefato com as miniaturas como arquivos de suporte. O usuário reescreve as respostas "por quê" e pressiona העתקת ההערות לבורד para colá-las de volta.
  6. Ponto de verificação 1: pare e aguarde. Aplique as anotações do usuário, republique. Não inicie A3 até que o usuário diga que o board está correto; um board errado treina um estilo errado.

A3. A decomposição

Para cada referência: uma transcrição no nível da palavra (transcribe_words.py, idioma do usuário ou auto) e uma passagem quadro a quadro que encontra cada animação e registra três coisas:

  • posicionamento: quais palavras a acionam, quanto tempo após a palavra, que tipo de linha recebe que tipo de cena (anunciar vs descrever, número, pessoa, história, punchline);
  • design: fundo, textura, par de tipos e tamanhos, cor, trabalho de linha, ilustração, posição;
  • lógica: duração em quadros, distâncias, easing, movimentos de câmera. Meça em quadros; nunca adivinhe. Em seguida, reconcilie com o board (board = o quê e por quê; vídeos = quando e como se move); pergunte ao usuário onde ele discorda. Escreva cada animação em animations.json (V<nn>-A<n>, início/fim, keyframe, título, categoria, tipo de cena, palavras, notas). Um vídeo de cada vez, salvando conforme avança; com muitos vídeos, divida o trabalho entre subagentes (um vídeo cada, mesmo esquema).

A4. A biblioteca de referência

python scripts/build_reference_library.py styles/<slug>/animations.json --out styles/<slug>/library Cada animação se torna uma pasta (imagem fixa, tira de quadro rotulada, clipe, notas) mais index.json. Abra algumas tiras, corrija limites errados em animations.json, execute novamente com --force.

A5. Empacote o estilo

Escreva STYLE.md e o skill de estilo a partir de references/style-skill-template.md: regras numeradas e medidas (para que um plano ou nota possa dizer "regra 7"); tokens mapeados para a marca (mantenha os tamanhos, proporções e disciplina de cor da referência; registre seus originais); cada categoria com design, movimento, posicionamento e 2-3 referências da biblioteca; os padrões de planejamento; o perfil de som; uma seção "modo de pensar"; uma seção "Regras para rodadas de revisão" vazia. Comece cada estilo a partir das regras gerais em references/craft-rules.md e escreva apenas o que for diferente. Recomendado: construa as partes recorrentes (legendas, manchete, layout do apresentador, CTA) como um kit de componentes testados em kit/. Salve o skill em ~/.claude/skills/style-<slug>/SKILL.md, em seguida styles.py set <slug> status=ready board_url=<URL do artefato do board>. Informe ao usuário o nome do estilo e que uma nova sessão o listará.


Fase B: editar um clipe em um estilo treinado

Use o modelo e esforço mais fortes disponíveis.

B0. Escolher o estilo

styles.py list. Se o usuário nomeou um, use-o; caso contrário, pergunte, com os estilos prontos como opções (um estilo pronto: diga qual usará). Nenhum pronto: ofereça a fase A. Carregue style-<slug> e escreva a escolha em plan.json para que cada rodada use o mesmo estilo.

B1. Transcrição e corte

  1. transcribe_words.py raw.mp4 --out words.json (hebraico: --language he --model <pasta ivrit-ai>).
  2. Mostre as palavras de baixa confiança (nomes, números, marcas); corrija-as antes de planejar.
  3. Escolha takes com o usuário se houver vários (--keep keep.json), em seguida cut_silences.py raw.mp4 --words words.json --out edit_ready.mp4 --pad-ms 120 (apenas 30 ms para um estilo deliberadamente impactante). As junções recebem um fade de áudio de 15 ms.
  4. Re-escute cada junção sem VAD (transcribe_words.py edit_ready.mp4 --start .. --end .. --no-vad --no-context), verifique terminações de palavras (word_edges.py --at <t>), depois verify_cut.py. Repetições ocultas e finais cortados são encontrados aqui, não pelo proprietário. Tudo depois disso usa edit_ready.mp4 e edit_ready.words.json.

B2. O plano de edição (mostre-o sem ser perguntado)

Divida o roteiro em batidas (uma ideia ou linha cada). Para cada batida, três designs da biblioteca do estilo, colocados da maneira que as referências os colocam, uma marcada ההמלצה שלי (minha recomendação). Cada opção: título, categoria, tipo de cena (פנים + כתוביות / cabeça falante + legendas / שכבה מעל הפנים / camada sobre o rosto / סצנה מלאה / cena completa), uma descrição concreta, Ref V##-A##; cada batida: por que se encaixa (cite referências e números de regras) e uma nota de câmera. Projete cada batida com as cinco perguntas em references/craft-rules.md §1 (metáfora, a coisa real funcionando, o invisível tornado visível, uma referência para o movimento, nunca repetido). Construa plan.html a partir de assets/plan-template.html, publique com um proxy 540p como clip.mp4 e as imagens fixas das opções como thumbs/.

B3. Ponto de verificação 2: o humano planeja

O usuário escolhe um design por batida ou escreve o seu próprio, pressiona העתקת התוכנית e cola de volta. Ofereça os padrões de planejamento como conselho: abra no apresentador; o gancho é uma batida forte; anuncie no rosto, descreva com um visual; uma pessoa → uma chamada; uma história → B-roll; equilibre os tipos de cena. Se o usuário der controle total ("אתה מחליט", você decide), faça suas escolhas e diga isso.

B4. Construir

  1. Para cada design escolhido, abra sua pasta de biblioteca e anote o design exato a ser copiado.
  2. Lista de ativos com uma fonte por item (UIs reais, logotipos oficiais, clipes de showcase da própria ferramenta, arquivos do usuário, música/SFX licenciados, imagens geradas opcionais ou 3D); mostre-a; pergunte antes de baixar. Registre cada fonte em SOURCES.md.
  3. Construa no HyperFrames (carregue seu skill primeiro) ou no mecanismo alternativo: uma composição 1080x1920 com edit_ready.mp4 como trilha do apresentador; tokens do estilo; o kit do estilo primeiro. Ordem: legendas para o vídeo inteiro a partir do arquivo de palavras, depois cada batida na ordem do plano. Construa as 2 primeiras batidas primeiro, tire um instantâneo, compare com os quadros de referência do estilo, ajuste, depois o resto. Siga references/craft-rules.md e verifique references/pitfalls.md.
  4. Valide (0 erros), tire instantâneos a cada 0,5 s (0,2 s sobre batidas densas e o CTA), leia cada instantâneo, corrija. Em seguida, renderize um rascunho (baixa qualidade, com música) e abra a página de revisão. Diga claramente que um primeiro rascunho está 60-70% do caminho.

B5. Rodadas de revisão

Siga references/

... (truncado para tradução)

Habilidades Relacionadas