Communitygithub.com

shutckin/aivfx-content-kit

Executa um vídeo de IA para cliente em um estúdio conceitual, desde o briefing até a entrega. Leva o briefing e fotos reais do produto, escreve uma sinopse, cria fichas de personagem e local com 3 opções cada, um deck de aprovação 16:9, stills em ondas, um prompt para o vídeo inteiro, revisões do cliente como uma lista, montagem e um checklist de entrega.

O que é aivfx-content-kit?

O AIVFX Content Kit é uma habilidade de agente de IA projetada para estúdios de conceito que produzem vídeos publicitários ou de produto com IA generativa. Ele gerencia todo o fluxo de trabalho, do briefing à entrega final, garantindo consistência visual e aprovação do cliente antes de qualquer quadro ser gerado. A habilidade suporta plataformas como Claude Code (ou outros agentes), Seedream 5 Pro, Nano Banana Pro, Seedance, Kling, Suno, e ferramentas de pós-produção como DaVinci Resolve. O processo principal envolve a criação de um pacote de pré-produção (sinopse, fichas de personagem e local, apresentação 16:9) que deve ser aprovado pelo cliente antes de gerar stills e vídeos. As fichas aprovadas são usadas como referência em todas as gerações para manter a consistência do personagem e do cenário. A habilidade também gerencia revisões do cliente, organização de arquivos, e inclui regras críticas como usar fotos reais do produto em vez de descrições textuais para evitar produtos inventados, e nunca incorporar texto nas gerações, deixando títulos para a edição.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/shutckin/aivfx-content-kit/tree/HEAD/skills/ai-video-concept

Perguntar na sua IA favorita

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

Documentação

Concept studio: vídeo de IA para cliente, do briefing à entrega

As instruções estão em russo. Responda no idioma do usuário.

Porquê

Antes do primeiro quadro do vídeo em si, é montado o pacote de pré-produção: sinopse, ficha de personagem, ficha de local e apresentação, e o cliente o aprova. Em seguida, as fichas de personagem e local aprovadas são fornecidas como referências em cada geração, incluindo macro. A razão é simples: sem elas, o modelo inventa o herói e o quarto novamente a cada vez, o rosto flutua de quadro para quadro, a cozinha muda de móveis e janela, e as primeiras ondas de quadros vão inteiras para o lixo. O pacote é sempre montado, não apenas "se o cliente pedir".

Em que funciona

FerramentaPara que serve aquiQuem faz
Claude Code (ou outro agente)gerencia a pasta do projeto, escreve sinopse e prompts, analisa revisões, monta apresentação, verifica logs de geraçãoagente
Pasta do projetoinbox/ do cliente como está, docs/ sinopse, apresentação e diários de geração, stills/r1, stills/r2 quadros por rodadas mais stills/preview*/ JPG leves para o celular, videos/, final/agente
Seedream 5 Pro via Higgsfieldmodelo principal para fichas e quadros: um modelo para todo o vídeo mantém a imagem coesaagente inicia após "sim" do proprietário
Nano Banana Pro via Higgsfield no navegadorcorreção de quadro pronto e execução de variantes; em algumas tarifas de agregadores no navegador sem usar créditos (verifique sua tarifa); não para misturar com outro modelo dentro da mesma cenaagente
Seedance via Higgsfieldvídeo com um único prompt para todo o vídeo, shots com timecodes internos, todo o lote de quadros aprovados de uma vezagente
Klingalternativa para vídeo, se o Seedance não der conta de um movimento específicoagente
Suno (ou similar)música, se necessária pela sinopseagente escreve o prompt, proprietário ouve
HTML para PDF via headless Chromeapresentação 16:9 com imagens incorporadas no arquivoagente
DaVinci Resolve (ou similar)edição, som, montagem finalproprietário ou editor
motion-graphicsvinhetas, títulos, cartão final sobre a ediçãoagente
film-lookum look no final de cada promptagente
Clientebriefing, foto do produto, escolha de variantes, revisõescliente

Gerações pagas são iniciadas apenas após o "sim" do proprietário do projeto. Qualquer envio ao cliente (sinopse, apresentação, master) é feito por uma pessoa e apenas sob sua ordem direta. O agente prepara e verifica.

Quando ativar

  • Chegou um briefing para um vídeo publicitário ou de produto, onde os quadros são gerados.
  • Precisa montar um pacote para aprovação: sinopse, fichas, apresentação.
  • Chegaram revisões por áudios e capturas de tela, e é preciso não perdê-las.
  • A entrega está sendo preparada.

A tabela quadro a quadro detalhada é feita por shot-list, quadros de arquivo sob texto são buscados por archive-footage, o look para todas as gerações vem de film-look, vinhetas e títulos são feitos por motion-graphics.

Etapas em ordem

0. Recebimento do briefing -> 1. Sinopse no chat -> [ok] -> 2. Ficha de personagem
-> 3. Ficha de local -> 4. Apresentação -> [aprovação] -> 5. Stills em ondas
-> 6. Vídeo -> 7. Revisões do cliente -> 8. Montagem e entrega

Nos colchetes estão os pontos onde o trabalho para até o cliente responder. Mantenha o estado do projeto em um único arquivo (status.md ou project.json): etapa atual, o que foi aprovado, o que estamos aguardando. Uma nova sessão começa por ele.

Etapa 0. Recebimento do briefing

Coloque tudo do cliente em inbox/ como está: áudios, capturas de tela de conversas, documentos, fotos. Não reescreva nada sobre o original. Questionário: templates/brief-questions.md.

Antes de começar, obter:

  • Especificação técnica ou roteiro em qualquer formato, áudios e capturas de tela servem;
  • fotos reais do produto em três ângulos: frontal, três quartos (mostrando profundidade) e com uma régua ou objeto para escala. Todas as variantes de embalagem que estarão no quadro. Sem fotos, não começar;
  • referências de vídeo, se houver;
  • duração e plataforma (daí a proporção de tela);
  • quem aprova finalmente e quando. Se quem aprova não for quem está na conversa, cada rodada de revisões chega duas vezes.

Analise a referência de vídeo quadro a quadro (folha de contato via ffmpeg, por exemplo tile=6x6) e descreva em palavras o que você está pegando: ritmo, luz, movimento de câmera, cor. Isso elimina metade do mal-entendido "eu queria como ali".

Etapa 1. Sinopse em texto no chat

Breve docs/synopsis.md, vai para o cliente como texto no chat, não como documento: a correção nesta etapa é a mais barata. Composição:

  • logline: o que o espectador vê e o que sente, 2-4 linhas;
  • tabela quadro a quadro com timecodes (formato e verificação em shot-list);
  • mecânica das transições: como um shot passa para o próximo, em palavras;
  • som: música, voz, ruídos, onde a música entra;
  • o que foi alterado em relação à especificação técnica e por quê, em bloco separado.

Se o cliente chegou sem ideia, antes da sinopse mostre 2-3 direções, diferentes em estratégia, cada uma com uma linha e logline. Não dê uma única direção: o cliente não tem o que escolher.

Etapa 2. Ficha de personagem

Character reference sheet, 3 variantes com diferenças no rosto, cabelo e roupas. Composição da ficha: templates/character-sheet.md. Emoções e poses são escritas para as cenas deste vídeo específico: come no quadro, então nas poses tem colher.

  • Reserve 2-3 iterações após a primeira escolha. Novas variantes de roupa, modelo próprio do cliente, comprimento de cabelo: isso é normal, não uma falha.
  • Roupa em contraste com a embalagem. O herói na cor do produto se mistura com ele, e o produto se perde.
  • Para cenas, recorte da ficha aprovada um grande retrato frontal: na grade, o rosto ocupa alguns por cento do quadro e o modelo não o lê. A ficha fica para aprovação, o retrato vai para as gerações.

Etapa 3. Ficha de local

Location reference sheet, 3 variantes de interior. Composição: templates/location-sheet.md. Principal: um cômodo de todos os lados, com plano geral de cada parede. Caso contrário, na mudança de ponto ou voo, não haverá referência do lado necessário, e o modelo completará o seu.

Se o vídeo for concebido como uma única passagem de câmera, após as fichas faça um master shot da cena: o herói já está no local, objetos nos lugares, luz ajustada. 2-3 variantes de ponto de câmera, depois cada quadro é gerado a partir do master aprovado.

Etapa 4. Apresentação

Slides horizontais 16:9 em um único PDF. Ordem que funciona:

capa -> personagem e local (escolha entre três) -> cenas em ordem com timecodes -> cortes -> final -> plano de trabalho

Montagem: HTML com imagens incorporadas no arquivo (base64), depois impressão em PDF via headless Chrome. Mostre quadros verticais em cartões inteiros (object-fit: contain em fundo), caso contrário eles são cortados em faixas iguais e parecem duplicatas. Fontes: sans-serif comum, números com tabular-nums, sem monoespaçadas.

Antes de enviar, verifique se a apresentação não contém informações internas: preços, orçamento, gasto de créditos, nomes de modelos, horas de trabalho, links internos e nomes. Pesquise no arquivo pelas palavras "rub", "crédito", "orçamento", "hora" e nomes de modelos. Se encontrar, refaça. Checklist do pacote: templates/preprod-checklist.md.

Etapa 5. Stills em ondas

Somente após o pacote aprovado. Ordem:

  1. base: "antes", produto, final;
  2. "depois" apenas i2i a partir do "antes" aprovado: mudam pose, rosto, luz, o resto deve coincidir, senão a progressão não se lê;
  3. macro e cortes, também com a ficha de local.

Cada onda mostre com variantes numeradas, para que a resposta seja uma palavra. Nova rodada em nova pasta (stills/r2), junto com previews JPG leves: PNGs grandes não chegam ao celular.

Etapa 6. Vídeo

Um único prompt para todo o vídeo, shots com timecodes internos, todo o lote de quadros aprovados de uma vez. Assim fica mais coeso do que colar clipes separados.

  • Cabeçalho do prompt: herói, local, produto, política de cores, som, tudo que é igual em todos os shots. Depois shots com timecodes e um título-âncora curto para cada ("caixa", "sachê", "final"). No final, o look.
  • Não escreva "como na referência 4": as imagens vão para o modelo em ordem arbitrária. A consistência é mantida pela descrição no cabeçalho.
  • Comece pelo lugar mais arriscado: transição, movimento complexo, texto pequeno no produto. Se não funcionar, mude a mecânica da cena (por exemplo, voo de câmera sobre cobertura de quadro por objeto), não ajuste o resto.
  • Macro estático congela: no cabeçalho, uma linha sobre movimento contínuo em cada shot. O final congela após um gesto: prolongue a ação.
  • Antes de iniciar, liste os quadros de entrada e marque cada um como "correção manual" ou "geração". Correções manuais (logotipo, texto pequeno) armazene separadamente e nunca sobrescreva com a saída do modelo.

Etapa 7. Revisões do cliente

As revisões chegam em áudios, capturas de tela, pedaços em mensagens diferentes.

  1. Organize em uma lista numerada: número, quadro, o que mudar, citação.
  2. Envie a lista para confirmação antes do trabalho: "entendi corretamente, aqui estão 7 itens?". Perguntar de novo é mais barato do que perder um item.
  3. Uma revisão que contradiz o pacote aprovado, marque separadamente: esta é uma nova rodada, não uma revisão.
  4. Reporte pelos mesmos números: feito, não feito e por quê.

Etapa 8. Montagem

Edição, som, vinhetas. Texto nunca é incorporado na geração: títulos apenas na edição (motion-graphics), nos quadros deixe espaço livre em cima.

Música, se necessária: entra após o ponto de virada, não desde o primeiro segundo. Para Suno, no estilo, bpm explícito (BPM) e 3-5 características técnicas específicas de som, resumidamente; a estrutura é definida por tags no campo de texto. Uma longa lista de adjetivos resulta em uma faixa sobrecarregada. O Suno não aceita a faixa de referência do cliente: analise seu tempo e caráter e traduza para o prompt em palavras.

O que carregar em cada geração

  • Retrato do herói da ficha aprovada (não a grade em si).
  • Quadro ou ficha de local, incluindo planos macro.
  • Foto real do produto ou packshot de referência aprovado.

Estas são três referências obrigatórias, e não adicione mais: com imagens extras, o modelo começa a fazer média, e o rosto enfraquece. Se o produto na cena não se mantiver, ele é inserido em uma execução separada (abaixo).

Regra do produto real. Não gere a embalagem por descrição textual: resultará em um produto inventado, e isso é uma recusa, não uma revisão. A forma não pode ser definida por palavras: "caixa cúbica" o modelo lê como "quadrada na frente". Se não houver foto da variante necessária (há caixa, não há sachê), primeiro um packshot limpo separado, ele é aprovado, depois as cenas. A orientação da embalagem é mantida pela referência, não pelo texto: uma foto em ângulo dará uma embalagem tombando. Um logotipo exigente insira no modo de edição: cena com espaço vazio para o produto, depois uma execução separada "coloque este packshot aqui, não mexa no resto". Produto pequeno em plano geral o modelo inventa: se ele deve ser lido, faça-o maior e com a história do quadro.

Look. O núcleo film-look no final de cada prompt. Remova a grade quente em dois casos: interiores claros e produtos com cores da marca (puxa para um monocromático amarelo) e cena escura com uma única lâmpada quente (sabão marrom). E também em estilo frio, monocromático ou neon. Proporção de tela apenas como parâmetro do modelo.

Referências apenas PNG. No Higgsfield CLI, o upload de JPEG falha com erro de assinatura de armazenamento no log, mas o próprio comando não retorna erro, e a geração prossegue silenciosamente sem a referência. Converta com antecedência (sips -s format png no macOS ou qualquer conversor) e após cada lote leia os logs em busca de linhas com erros, em vez de verificar a existência do arquivo. Falhas de comunicação com o armazenamento são resolvidas com repetição.

Onde se perde tempo

  • Geração sem fichas. O rosto e o local flutuam, a onda é descartada inteira. Nada de cenas antes das fichas aprovadas.
  • Arquivos com o mesmo nome. Dos downloads, é fácil pegar o quadro errado com nome semelhante. A nova versão recebe um novo nome, antes de substituir verifique a soma de verificação (md5).
  • Reconstrução da apresentação esquecida. As imagens estão incorporadas no HTML: mudou o arquivo no disco, o PDF será gerado com o antigo. Reconstrua a cada alteração.
  • Voo de câmera em stills. O modelo de imagens não entende arco: gira o herói na cadeira, o fundo fica parado. Em stills, define-se o que é fisicamente visível no quadro (qual parede está atrás, qual ombro está na frente). Movimento de câmera é tarefa do modelo de vídeo.
  • i2i a partir de um quadro com detalhe antigo. O comprimento do cabelo e as mangas não podem ser alterados assim: a imagem anula o texto. É necessária uma referência onde o detalhe já esteja correto, ou geração do zero.
  • Material pelo nome. O modelo interpreta o nome do produto à sua maneira e desenha outro material. Descreva a física da superfície (ceroso, semitransparente, brilho nas bordas) e proíba separadamente sinais de material estranho (porosidade, crosta).

Checklist de entrega

  • Embalagem sempre com a face frontal, logotipo não espelhado, ícones no lugar, texto pequeno verificado com o padrão quadro a quadro.
  • Produto idêntico em todos os quadros.
  • Herói com o mesmo rosto em todos os quadros.
  • Luz muda conforme a dramaturgia, não aleatoriamente.
  • Local único em todos os quadros, incluindo macro.
  • Texto na tela apenas na edição, nos quadros há espaço.
  • Duração e formato como no briefing, zonas seguras da plataforma verificadas.
  • Todos os itens da última lista de revisões concluídos.
  • Previews leves para celular estão em stills/preview*/.

Conexões com outras habilidades do conjunto

  • shot-list: tabela quadro a quadro para a sinopse e sua verificação.
  • film-look: um look para todas as gerações do projeto.
  • motion-graphics: vinhetas, títulos, cartão final na montagem.
  • archive-footage: quadros de arquivo e diário de fontes, se houver.
  • youtube-thumbnail: thumbnail, se o vídeo for para um canal.

O que fica desatualizado primeiro

Nomes e versões de modelos, quais formatos de referência a ferramenta aceita, tarifas e limites de agregadores. A ordem das etapas e as regras de aprovação ficam desatualizadas lentamente. Verificado em outubro de 2026.

Mais fundo

Modelos completos de fichas e apresentação, análises de vídeos reais e configuração do pipeline para equipe, o estúdio AIVFX mostra no trabalho e no treinamento: https://aivfx.ru.

Individual skills in this repo

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

shutckin/aivfx-content-kit

Makes motion graphics on the HyperFrames engine (HTML scenes rendered to video) with an AIVFX studio layer: name lower thirds, chapters, numbers, Shorts and Reels hooks, end cards, titles. The brand (colors, fonts, motion, durations) lives in one file, the video is a brief of scene roles, motion is set in words, and the agent renders a draft over footage and a final ProRes 4444 with alpha. Gives timing rules, 9:16 and 16:9 safe zones, lint and black-frame checks, a delivery checklist and a brand file checker. Triggers: 'lower third', 'motion graphics', 'chapter card', 'shorts hook', 'end card', 'transparent overlay', 'brand kit for motion', 'HyperFrames'. Triggers (RU): «сделай плашку», «нижняя треть», «плашка с именем», «заставка», «глава», «титры», «хук для шортс», «финальная карточка», «моушен для ролика», «графика с альфой для монтажа», «заведи бренд для графики», «сделай на хайперфреймс».

shutckin/aivfx-content-kit

Packages YouTube videos and Shorts: a pack of 3-4 thumbnail variants of one idea for choice and A/B testing, title and thumbnail as one unit, one idea per image, face and emotion, a large object, text up to 3-4 words or none, readable on a small phone screen. Works from own frames and screenshots plus references, generates or refines the frame with models (Nano Banana, Seedream, GPT-Image, Higgsfield and others) with the film-look style and logos in one pass, keeps a consistent channel series, checks the file with a script (size, weight, name), reviews the small view by eye on a contact sheet and shows options to the owner before upload. Triggers: 'YouTube thumbnail', 'video packaging', 'thumbnail A/B test', 'Shorts cover', 'title and thumbnail'. Triggers (RU): «сделай превью», «обложку для ролика», «обложку для YouTube», «упакуй ролик», «варианты для A/B-теста», «заголовок и превью», «обложку для Shorts», «серия превью для канала».

Habilidades Relacionadas