Communitygithub.com

storyboard-reel

Mostra ao agente como planejar, construir ou editar um 'storyboard reel', resultando em um logotipo e uma pequena folha de marca. O procedimento passa por Storyboard Reel, O formato, Entradas. Use-o quando uma nova tarefa exigir este ofício.

O que é storyboard-reel?

A habilidade **storyboard-reel** transforma um storyboard desenhado à mão, alguns renders de um personagem low-poly e o produto em um anúncio 9:16 de cerca de 28 segundos com música e efeitos sonoros — sem narração ou legendas. É uma ferramenta completa para agentes de IA e desenvolvedores que precisam produzir anúncios em vídeo de forma programática, integrando geração de imagens, edição de vídeo (ffmpeg) e organização de ativos. A skill é executada via linha de comando (`python3 scripts/storyboard_reel.py <comando> <job>`) a partir da raiz do repositório, com uma biblioteca Python modular (`sr_lib.py`, `sr_shots.py`, `sr_matte.py`, `sr_media.py`) que lida com tipos de tomadas, cronometragem, cutouts e mídia. O fluxo de trabalho guia o agente desde a criação de um novo job a partir de uma URL de produto e pasta de imagens, passando pela autoria do `job.json` (com base no storyboard), geração de cutouts e placas, até a renderização final e upload para CDN (BunnyCDN). Inclui recursos avançados como look VHS, câmera-first (com prompts detalhados para modelos de vídeo), gate de aprovação (pré-visualização e contato) e knobs de edição gratuitos (fade, flash, handheld, scan). É suportada em Windows e macOS/Linux, com dependências como `rembg` e `ffmpeg`. Ideal para equipes de marketing, criadores de conteúdo e estúdios que desejam automatizar a produção de anúncios de moda ou produtos com personagens em 3D.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/lokiverde/video-studio/tree/HEAD/skills/storyboard-reel

Perguntar na sua IA favorita

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

Documentação

Storyboard Reel

Transforma um storyboard desenhado à mão, alguns renders de um personagem low-poly e o produto em um anúncio 9:16 de cerca de 28 segundos com música e efeitos sonoros. Sem narração, sem legendas sobre a ação.

Engine: python3 scripts/storyboard_reel.py <comando> <job>, executado a partir da raiz do repositório (a pasta que contém scripts/). --help lista todos os comandos. A lógica está em scripts/sr_lib.py (tipos de tomada, padrões, cronometragem, verificações), sr_shots.py (desenho), sr_matte.py (recortes), sr_media.py (ffmpeg, rembg, servidor de mídia). No Windows use python no lugar de python3.

Ponto de partida: skills/storyboard-reel/job_template.json. new o copia para o job. Seu exemplo é um reel de figura e brilho. Um reel com foco em câmera é construído a partir de tomadas clip.

O formato

  • 9:16, cerca de 28 segundos. A faixa de música define a duração.
  • Tipos de tomada que a engine desenha: logo (sobre preto), black, dolly (aproximação em uma figura), pose (pausa), clip (um movimento imagem-para-vídeo), glow (a luz de um adereço se acumula e explode), white, shirt (camiseta branca sobre fundo branco, design aparece gradualmente, título abaixo), card (título, mockup, preço, tamanhos, cores, site), still (imagem chave em tela cheia) e scan (uma busca através de uma mira).
  • Reordene, repita ou remova tipos para seguir o storyboard. Um quadro que nenhum tipo consegue desenhar precisa de uma nova função de desenho em sr_shots.py mais um teste. Diga isso antes de construir algo em torno dele.
  • Look VHS: "vhs": 0.5 no job.json (0 desligado, 1 completo). Ele fica na seção do personagem e desaparece gradualmente através do flash branco, para que a camiseta e o card voltem limpos. Com vhs ativado, a entrega principal é final_9x16_vhs.mp4.

Entradas

  • Uma pasta com as páginas do storyboard e seus renders da figura (um por pose). Nomeie arquivos com logo, mockup ou board no nome e eles são capturados. Adicione o logotipo sobre fundo branco e um mockup do produto, se os tiver.
  • A URL da página do produto. new lê o .json do Shopify da página para obter título, preço, tamanhos e cores.
  • Para a revelação, uma foto da estampa traseira sobre um fundo claro liso. Se nenhuma for definida, a primeira imagem da loja é usada. Geralmente é um mockup cheio, então substitua por um limpo.

Fluxo de trabalho

  1. Novo job. python3 scripts/storyboard_reel.py new <url-produto> <pasta-imagens> [--word <tópico>] [--title "<título>"] Copia as imagens para src/, as imagens da loja para product/ e preenche o texto do card. --word termina o nome da pasta do job com uma palavra de tópico.
  2. Autorar job.json a partir do storyboard. Mapeie cada quadro para uma tomada, defina panel para corresponder ao storyboard, atribua cada render a uma figura e escreva o prompt da placa. Concluído quando python3 scripts/storyboard_reel.py check <job> imprime a linha do tempo sem problemas.
  3. Recortes (reels das figuras): cutouts <job>, depois abra work/cut/feet_check.jpg. O rembg pode remover osso claro sobre chão claro e manter a sombra projetada. Corrija cada pé com caixas figures.<nome>.feet em pixels de origem (add restaura pixels claros, drop remove sombra escura do chão, rebuild recalcula a caixa). Repita até que cada pé esteja completo.
  4. Placa. plate <job> --n 3 faz fundos candidatos no servidor de mídia (grátis). Veja work/bg/plates.jpg e defina plate.src para a placa adequada. Mantenha "chão largo e vazio no primeiro plano" no prompt, porque as figuras estão em look.feet_y. Você também pode definir plate.src com sua própria imagem.
  5. Folha de contato, o primeiro portão. stills <job> escreve work/contact_sheet_9x16.jpg. Verifique se os pés estão no chão, a figura ultrapassa a faixa inferior da UI e o texto do card está correto. Mostre ao usuário a folha e o custo estimado dos clipes. Pare e aguarde.
  6. Clipes, somente após o sinal verde do usuário. kling-frames <job> escreve work/kling/<tomada>_start.jpg (mais _end.jpg onde o clipe tem um quadro final) e imprime cada prompt. Envie os quadros para seu serviço imagem-para-vídeo (OpenArt: upload, cotação com openart_model_cost, depois gerar), sob uma linha AUTH em ~/video-studio/relay/auth.md. Salve o download, depois prep-clip <job> <download.mp4> --shot <id>. A duração do clipe define sua tomada.
  7. Pré-visualização, o segundo portão. preview <job> renderiza o trecho do clipe com som para work/preview_clip.mp4. Verifique o movimento quadro a quadro, execute stills novamente, depois mostre ao usuário a pré-visualização e a nova folha. Pare e aguarde.
  8. Texto de pós-produção. Escreva post no job.json: uma caption curta, depois instagram, tiktok, youtube (título e descrição), facebook, hooks, order e uma nota cover. A engine anexa o bloco de assinatura fixo de sr_post.py a cada legenda. Edite esse bloco para sua marca. Concluído quando kit <job> não imprime linhas "texto de pós não está pronto".
  9. Aprovar e renderizar. Após o sinal verde do usuário: approve <job>, depois render <job>. Isso escreve out/final_9x16_vhs.mp4 (a versão com fita, mais lenta), out/cover.jpg, out/post.txt e out/posts.md. Depois render <job> --clean escreve o out/final_9x16.mp4 limpo. Cada render também escreve um gêmeo _nomusic (efeitos sonoros, sem faixa musical). Verifique a linha logada 1080x1920 30/1 <duração>s, audio, depois extraia quadros nos cortes. --out <caminho> faz um render lateral que deixa out/ e o status do job intactos.
  10. Upload. upload <job> envia os finais, gêmeos, capa e kit de pós para seu armazenamento CDN (BunnyCDN, chaves em config.env). Ele recusa enquanto o texto de pós tiver legendas vazias ou <placeholders> restantes. Um re-upload vai para um novo nome (_v2) porque CDNs continuam servindo o arquivo antigo em um caminho reutilizado. Dê ao usuário as novas URLs e cole as legendas por plataforma de posts.md. A postagem é etapa do usuário.

O portão de pré-visualização (imposto no código)

render é bloqueado até approve, e approve funciona apenas em uma folha feita a partir do job atual. Qualquer alteração na imagem invalida a aprovação: tomadas, figuras, placa, look, recortes, um novo clipe ou qualquer caminho na parte visual do job.json. Edições de áudio e pós não a invalidam. Após uma alteração na imagem, faça uma nova folha e mostre-a novamente. render --no-preview é apenas para a renúncia explícita do usuário naquele job específico.

Movimento com foco em câmera

As tomadas de movimento são clipes imagem-para-vídeo com foco em câmera, escritos como tomadas de filmagem real: um rig de câmera e lente, um movimento de câmera com "sem zoom, sem corte", depois a ação. Comece com o nível de baixa resolução. Stills mantidos com zooms lentos parecem um slideshow.

  • Apenas quadro inicial: a câmera está livre (dolly, arco, avanço).
  • Uma aproximação que deve pousar em uma pose: adicione um quadro final, um recorte da pose final em cerca de 1.12x. A aproximação então pousa exatamente ali. Um close-up só com início pode cortar a cabeça.
  • Um clipe estático (clip com caminhos de imagem start e end) deve seguir um still cujo src é seu quadro inicial.
  • "in": 1.0 pula o primeiro segundo de um clipe. dur: "clip" usa a duração real do clipe, e a tomada fill absorve a diferença.
  • "gain" escurece um clipe. "lights_out": {"at": 2.8, "flicker": 0.7, "floor": 0.04} faz a luz falhar e cair para quase preto, feito na edição sem custo. Combine com um efeito sonoro correspondente.
  • Mantenha a ameaça fora da tela. Escuro e não visto parece mais assustador do que uma criatura na tela.
  • Mantenha tiros fora da tela: corte para preto e deixe o som carregá-los. Modelos disparam armas mesmo quando instruídos a não fazer, então verifique os clipes de armas quadro a quadro e termine a tomada antes de qualquer tiro.
  • Redação do prompt para o modelo de vídeo:
    • Um movimento contínuo e lento. Nomeie o que permanece parado (corpo, pés, fundo).
    • Diga como os adereços se comportam ("o cajado permanece ereto e nunca balança"). Evite "balançar".
    • Descreva o que deve aparecer. Negações ("sem névoa") são frequentemente ignoradas, então mostre menos.
    • Quando o adereço se move, o corpo inteiro se move com ele: peso, tronco, cabeça. Pés plantados.
    • Um close-up precisa de respiração lenta e uma pequena inclinação na maior parte do clipe, depois um movimento rápido. Sem isso, parece congelado.
  • Duração do clipe: 3 a 5 segundos. Clipes mais longos dão ao modelo espaço para divagar.

Knobs de edição (grátis, desenhados na edição)

  • "fade_in" faz um clipe aparecer gradualmente a partir do preto. "flash" adiciona um flash branco cortado nele.
  • "handheld" (0 a 1) balança stills mantidos. Use 0 em clipes de câmera, que carregam sua própria câmera.
  • scan é uma busca através de uma mira, como uma tomada própria, em um still amplo. Nunca use um panorama de modelo de vídeo, pois um panorama desliza como um slider: {"kind": "scan", "dur": 4.4, "src": "<still amplo>", "span": 0.236, "scope": {"radius": 0.445, "sway": 16, "steady": 2.4}, "path": [[0.0, 0.13, 0.24], [3.2, 0.645, 0.345]]} Cada ponto do caminho é [segundos, x, y] no still. A mira persegue o caminho como uma mola, então ela ultrapassa, corrige e pousa no último ponto. Diga ao modelo de vídeo "sem círculo, sem retícula" se um clipe é mostrado através de uma mira. A edição desenha o anel.
  • "live" em um scan reproduz um clipe amplo dentro do still a partir de um determinado segundo, para que um sujeito se mova em velocidade real quando a lente o encontrar. Use para remover uma pausa.
  • Um pequeno movimento mecânico que o modelo não fará (um gatilho, um interruptor): monte-o na edição a partir do quadro chave. Corte a parte móvel como um polígono, preencha atrás dela, gire-a em seu eixo sob um empurrão lento. Corte para que o movimento preencha o telefone.
  • shirt "from_black": 1.0, "from_white": 0 faz a revelação aparecer gradualmente a partir do preto quando o storyboard não tem um fade para branco.

Stills em tela cheia e quadros chave

Use estes quando não houver renders de figura, ou quando o storyboard tiver close-ups e tomadas em primeira pessoa.

  • Uma tomada still usa uma imagem src em tela cheia, com push, anchor [x, y], fade_in, fade_out e flash.
  • Quadros chave vêm de um modelo de edição de imagem, 9:16. Dê a ele a ficha do personagem e a cena como referências, a ficha primeiro. Em uma configuração testada, apenas as duas primeiras referências chegaram ao modelo, então mantenha as importantes primeiro.
  • O quadro final de um clipe é uma edição de seu quadro inicial ("a mesma imagem, apenas ..."), para que os dois se alinhem. Uma pequena alteração é mais rápida como uma edição local no código do que como uma edição de modelo.
  • Um close-up corresponde à própria visão da ficha: uma tomada lateral é o perfil verdadeiro da ficha.
  • Um crânio de perfil mantém proporções reais (um crânio redondo sobre um rosto curto). Um capuz segue o crânio e cobre o topo e a parte de trás. Diga isso no prompt.
  • Julgue o cocar pelo seu contorno lateral. Descreva o contorno ("curto, redondo, termina na parte de trás da cabeça"). Palavras como "alto" ou "pontiagudo" fazem modelos de imagem criar um chapéu de bruxo.
  • Uma mão tem aproximadamente o mesmo comprimento que a altura do crânio. Para mãos esqueléticas, nomeie os ossos dos dedos separadamente. "Grossa e encorpada" sozinho dá um punho.
  • Uma tomada de abertura começa alto e amplo em todo o cenário, depois desce até a figura. Faça o quadro amplo primeiro e pegue o quadro final próximo como um recorte dele. Uma edição que diz "a câmera se moveu" tende a escalar a figura no lugar.

Esboço grátis do storyboard primeiro

Antes de qualquer chamada paga, faça um esboço de cada quadro no servidor de mídia (FLUX, cerca de 8 segundos cada) para work/keys/, depois execute stills. O usuário vê o corte inteiro de graça. Um esboço não mantém um personagem, então diga isso quando mostrá-lo. Quadros chave pagos substituem os esboços. Em um personagem novo, a ficha do personagem é a primeira chamada paga. Cada quadro chave então pega essa ficha como sua primeira referência.

Mantenha uma direção de tela por personagem (espelhe um esboço se ele estiver virado para o lado errado). Personagens recorrentes são cortados de seus quadros chave reais, nunca de um esboço.

Mantenha cada personagem recorrente em assets/characters/<nome>/ com um README: a ficha, as regras de figurino, os cenários que usam. Leia o README antes de qualquer quadro chave.

Música e som

  • Faixa musical: instrumental, cerca de 30 segundos, escrita para a linha do tempo que check imprime. Um arco típico: um impacto no logotipo, uma faixa melancólica sob o dolly, uma construção crescente através do clipe e brilho, o impacto no fade para branco, um impacto final no card. Gere com música do ElevenLabs, ou use sua própria faixa licenciada. Salve em assets/music/<nome>.mp3 e coloque o prompt em audio.prompt.
  • Efeitos sonoros ficam em assets/sfx/ (impacto, whoosh, riser). Adicione entradas audio.sfx ancoradas a uma tomada. Faça um novo quando o adereço mudar.
  • audio.mute: [<ids das tomadas>] corta a música abruptamente nessas tomadas e deixa os efeitos sonoros tocando. Use para "corte para preto, depois tiros".
  • Rajadas de tiros geradas se misturam em uma parede de ruído. Gere um tiro limpo e sobreponha a rajada localmente: uma prateleira baixa, um sub-thump com tom decrescente sob cada impacto, pequenas variações de tom e nível por impacto, depois um limitador.

Custos

Placas, recortes e a renderização local são grátis. Quadros chave pagos, clipes (OpenArt ou similar) e música e efeitos sonoros do ElevenLabs custam créditos. Cote cada chamada primeiro e mantenha a linha AUTH em ~/video-studio/relay/auth.md cobrindo-a.

job.json, resumido

length (o ponto de corte da música), product (url, título, preço, tamanhos, cores), plate (src, prompt), figures (nome para src, opcional feet, centre_on), shots (uma lista de id, kind, dur, panel e chaves específicas do tipo), vhs, handheld, audio (music, prompt, music_gain, fade_out, mute, sfx), post (texto para cada plataforma) e um look opcional. Os padrões por tipo ficam em SHOT_DEFAULTS em sr_lib.py. O texto na tela aceita {title}, {details} e {site}.

Pegadinhas

  • O rembg é necessário para recortes: pip install rembg. O comando cutouts diz o que está faltando e como configurá-lo.
  • O brilho encontra um orbe magenta pela cor. Para outro adereço, defina light.at ([x, y, r], frações da caixa da figura) e light.rgb. Verifique preço e tamanhos com a página ao vivo.
  • O ffmpeg deve estar no seu PATH. Todo texto na tela é desenhado com Pillow, então o ffmpeg não precisa do filtro drawtext.

Individual skills in this repo

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

Habilidades Relacionadas