Communitygithub.com

shutckin/aivfx-content-kit

Empacota vídeos do YouTube e Shorts: um pacote de 3 a 4 variantes de thumbnail para uma ideia, para escolha e teste A/B, título e thumbnail como uma unidade, uma ideia por imagem, rosto e emoção, um objeto grande, texto de até 3-4 palavras ou nenhum, legível em uma tela pequena de celular. Funciona a partir de próprios frames e screenshots mais referências, gera ou refina o frame com modelos (Nano Banana, Seedream, GPT-Image, Higgsfield e outros) com o estilo de filme e logotipos em uma única passada, mantém uma série de canal consistente, verifica o arquivo com um script (tamanho, peso, nome), revisa a visualização reduzida a olho nu em uma folha de contato e mostra opções ao proprietário antes do upload. Gatilhos: 'miniatura do YouTube', 'embalagem de vídeo', 'teste A/B de miniatura', 'capa do Shorts', 'título e miniatura'. Gatilhos (RU): «сделай превью», «обложку для ролика», «обложку для YouTube», «упакуй ролик», «варианты для A/B-теста», «заголовок и превью», «обложку для Shorts», «серия превью для канала».

O que é aivfx-content-kit?

Esta habilidade para agentes de IA (como Claude Code, Cursor ou Codex) automatiza a criação de thumbnails e packaging de vídeos do YouTube e Shorts. Ela gera de 3 a 4 variantes de thumbnail a partir de uma única ideia, combinando referências próprias (frames do vídeo, screenshots) com modelos de IA de geração de imagem (Seedream, Nano Banana, GPT-Image, Higgsfield) para criar imagens com estilo cinematográfico e logotipos integrados, mantendo a consistência da série do canal. A habilidade define regras claras de composição visual (rosto e emoção em destaque, objeto grande, texto de no máximo 3-4 palavras, canto inferior direito livre) e um fluxo de trabalho que inclui briefing, geração ou refinamento, adição de texto em separado (para precisão cirílica), verificação automática com script (`check_thumb.py`) e revisão visual em miniatura. O resultado é apresentado ao proprietário em um contato de folha, com recomendações, antes de qualquer upload. Ideal para criadores de conteúdo que buscam otimizar taxas de clique e teste A/B com eficiência e qualidade profissional.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/shutckin/aivfx-content-kit/tree/HEAD/skills/youtube-thumbnail

Perguntar na sua IA favorita

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

Documentação

Pré-visualização e Embalagem de Vídeos do YouTube

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

Por quê

A miniatura e o título decidem se alguém clicará no vídeo no feed, na pesquisa ou nas recomendações. O vídeo pode ser excelente, mas se o cartão no celular parecer uma mancha cinza com letras minúsculas, a visualização não acontecerá.

Dois problemas comuns. O primeiro: uma captura de tela do vídeo com cor ajustada. É honesto, mas plano: no feed, ao lado estão quadros onde a luz e a atmosfera são mais fortes do que em qualquer quadro bruto. O segundo: uma "imagem bonita" no estilo Pinterest, onde o herói é minúsculo e há muito espaço ao redor. Na tela do celular, resta um retângulo vazio.

A habilidade foi montada a partir do fluxo de trabalho de um pequeno estúdio: cada regra abaixo surgiu após uma variante que teve que ser refeita.

Em que funciona

O quêPor que está aqui
Quadros e capturas de tela do vídeoreferências de suporte: rosto, roupa, produto, local
Seedream 5 Pro e Nano Banana via Higgsfield, Flowith ou similarcriam um novo quadro a partir de referências com luz para miniatura; os modelos são comparados, um mantém o rosto, o outro é mais forte na luz
Visual de film-lookno final de cada prompt, proporção como parâmetro
Logotipos PNG do site oficialo logotipo nasce no quadro junto com a cena; apenas PNG: no CLI do Higgsfield, JPEG falha com erro de assinatura de armazenamento apenas no log, e a geração silenciosamente vai sem referência, então verifique os logs
Editor (Photoshop ou similar)texto preciso em camada separada após a geração: os modelos confundem o cirílico
scripts/check_thumb.pytamanho, peso e nome do arquivo; a visualização reduzida é feita a olho nu em uma folha de contato
Agente e proprietárioo agente faz 3-4 variantes e uma folha de contato, o proprietário escolhe e decide sobre o upload

Quando ativar

  • É necessária uma miniatura para um vídeo no YouTube ou uma capa para Shorts.
  • É necessário empacotar o vídeo inteiro: miniatura, título, descrição, tags.
  • São necessárias 3-4 variantes para teste de miniatura (no YouTube, isso é "Teste e comparação").
  • O canal quer uma série unificada para que os vídeos sejam reconhecidos no feed.

Capas para artigos e páginas são feitas por article-cover, o visual para prompts é retirado de film-look.

Ordem de trabalho

  1. Briefing. Preencha templates/thumb-brief.md: tema do vídeo, o que o espectador deve sentir em um segundo, objeto principal, texto na miniatura, título de trabalho, seus quadros e referências com funções. Campos vazios nos três primeiros blocos significam que é cedo para gerar.
  2. Uma ideia. Escreva em uma frase: "A miniatura promete: ...". Não é o tema ("análise de câmera"), mas um sentimento ou mistério ("esta câmera filma melhor do que custa"). Se houver duas frases, escolha uma, a segunda vá para o título.
  3. Vínculo com o título. Escreva imediatamente 3-5 variantes de título. A miniatura dá a emoção, o título dá os fatos e palavras para pesquisa. Não duplique a mesma coisa: se na imagem está "SILÊNCIO", no título não precisa de "silêncio" novamente.
  4. Seus materiais. Reúna 10-20 quadros do vídeo uniformemente ao longo da linha do tempo (folha de contato), escolha 2-4 onde o herói, rosto, produto, local são mais visíveis. Isso é suporte para a geração, não uma miniatura pronta.
  5. Funções das referências. Atribua a cada referência uma função: aparência e rosto, produto, local, composição, luz, clima. Uma referência para tudo de uma vez funciona mal.
  6. 3-4 conceitos diferentes. Não quatro repetições do mesmo quadro, mas técnicas diferentes: rosto grande com emoção, objeto-herói, herói em cena atmosférica, quadro "antes e depois" ou "contra". Descreva cada um em uma linha no briefing.
  7. Geração ou refinamento (seção abaixo). Visual de film-look no final de cada prompt, proporção apenas como parâmetro do modelo.
  8. Texto na miniatura em etapa separada (seção "Texto").
  9. Verificação. Script scripts/check_thumb.py para tamanho, peso e nome, a olho nu para o significado: cada miniatura em tamanho reduzido ao lado de outras.
  10. Mostrar ao proprietário. Todas as variantes em uma única mensagem, numeradas, com recomendação e variantes de título. Enquanto o proprietário não escolher, não carregue nada no canal nem inicie o teste.
  11. Salvamento. Finais com nomes compreensíveis na pasta do vídeo, quadros de trabalho e prompts ao lado, nada sobrescrito.

Regras do quadro

Uma ideia. O olho entende em meio segundo para onde olhar. No quadro, não mais que 2-3 elementos: herói, um detalhe, texto. Todo o resto é fundo.

Rosto e emoção. Um rosto vivo com emoção compreensível atrai mais: surpresa, concentração, cansaço, entusiasmo. Se não há rosto por design (capacete, máscara, costas do herói), ele é substituído por um detalhe reconhecível que se repete de vídeo para vídeo e se torna o "rosto" do canal.

Objeto grande. O herói ocupa uma parte notável do quadro. Uma silhueta pequena em uma paisagem enorme é bonita para capa de playlist ou banner do canal, mas como miniatura de um vídeo individual não funciona: no celular não é visível.

Contraste. O herói é separado do fundo por luz ou cor: objeto quente em fundo frio, rosto claro em fundo escuro, nítido em suave. Se o herói e o fundo têm o mesmo brilho, a miniatura se funde com as vizinhas.

Atmosfera mais forte que no vídeo. A miniatura pode ser mais cinematográfica que o original: céu dramático, contraluz, névoa, asfalto molhado, sol baixo. Mas deve prometer o que está dentro: local, herói, clima. O YouTube no teste de miniatura escolhe o vencedor pelo tempo de exibição, não pelos cliques, então o engano é punido.

Canto inferior direito livre. O YouTube coloca a duração do vídeo ali. Não coloque rosto, texto ou objeto principal ali.

Tela de celular primeiro. A maioria assiste pelo celular. Tudo que não é legível em um cartão com largura de um dedo não existe.

Geração e refinamento

Uma captura de tela bruta quase sempre perde. Os quadros do vídeo, fotos do herói e capturas de tela vão para o modelo como referências: aparência, pose, produto, local. O modelo cria a partir delas um novo quadro com luz e composição para miniatura. Colagem de pedaços recortados em vez de geração parece barato.

Esquema do prompt, cada bloco separadamente:

  • Suporte: o que deve permanecer como em seus quadros (rosto, roupa, forma do produto, cor, local).
  • Estilo: o que pegar das referências de estilo (luz, ótica, clima).
  • Composição: enquadramento, onde está o herói, onde está o espaço vazio para texto, canto inferior direito livre.
  • Luz: especificamente, em palavras de operador.
  • Proibições: sem letras aleatórias, marcas d'água, logotipos extras, brilho CGI, sem substituição do herói ou produto.
  • Visual: núcleo de film-look no final, sem alterações.

Regras que economizam tempo:

  • Proporção apenas como parâmetro. 16:9 para vídeos, 9:16 para Shorts. No texto do prompt não está: no modo de edição por referência, o modelo sem parâmetro geralmente retorna um quadrado, e o texto 4:3 entra em conflito com o parâmetro e corta o quadro errado.
  • Gere com margem (2K), depois reduza para 1280x720 ou 1080x1920.
  • Compare modelos. Um mantém melhor o rosto por referência, o outro é mais forte na luz. Se houver modo em lote, pegue um monte e selecione.
  • Duas falhas consecutivas significam pare. Se o modelo perder o herói duas vezes ou for para um pôster fora do tema, não force no mesmo contexto e não corrija com colagem. Comece de novo: uma referência de suporte, 2-3 referências de estilo, prompt curto.

Logotipos no quadro em uma única passada. Vídeo sobre um serviço, produto ou marca específicos: o logotipo nasce no quadro junto com a cena, como em article-cover. O quadro e o logotipo de referência (PNG do site oficial) vão para o modelo juntos, o logotipo é descrito como parte do mundo: tela na mão do herói, patch, placa, corpo do dispositivo. Logotipo sobreposto depois no editor parece colado. Após a geração, zoom em cada caractere: letras trocadas e forma simplificada são defeitos.

Texto na miniatura

  • Até 3-4 palavras ou sem texto. Melhor 1-2 palavras grandes do que uma frase pequena. Se a imagem fala por si, o texto não é necessário.
  • Texto é emoção ou mistério, não descrição. "A ESTRADA DESAPARECEU" funciona, "VIAGEM NA NEVOEIRO" não, "NÃO PIOR?" funciona, "ANÁLISE DA CÂMERA" não. Alavancas: sentimento, pergunta, número, contraste, local.
  • O texto não repete o título. Eles se complementam.
  • Como colocar letras. Para cirílico preciso e fonte corporativa, o texto é colocado em camada separada após a geração: os modelos confundem letras e desenham fonte simplória. Uma palavra latina curta o modelo às vezes desenha bem, mas verifique cada letra. Logotipos, no entanto, não toque: eles já estão no quadro.
  • Fonte. Grotesco negrito, largo ou denso, um para toda a série. Números no mesmo sans com font-variant-numeric: tabular-nums onde estão em coluna. Não use fontes mono-espaçadas ou "terminais".
  • Base. Gradiente suave esfumaçado sob o texto, se faltar contraste. Blocos rígidos, ovais e molduras dão aspecto "caseiro".
  • Posicionamento sob cada quadro. Primeiro encontre onde realmente está vazio, coloque o texto ali. O texto nunca cobre o rosto e o objeto principal.

Série unificada do canal

O canal é lido no feed de relance quando 5-10 vídeos seguidos mantêm um código: a mesma fonte, a mesma técnica com texto, um detalhe reconhecível do herói, paleta semelhante. Crie um arquivo de série do canal (seção no final do modelo) e consulte-o antes de cada pacote. Mudar o código é permitido, mas conscientemente e imediatamente para toda a série, não porque desta vez quis diferente.

Shorts

  • Formato 9:16, final 1080x1920.
  • No feed de Shorts, a miniatura quase não é visível, há reprodução automática. A capa é necessária para a grade do canal e pesquisa. A principal alavanca dos Shorts é um primeiro quadro forte e texto no primeiro segundo do vídeo, não a capa.
  • Coloque o texto na borda superior ou no centro: a parte inferior está ocupada pela legenda e botões.
  • Na grade do canal, a capa é cortada mais perto de um quadrado: mantenha o herói no centro.

Nomes de arquivo e armazenamento

  • Latim, números, hífen. Sem espaços, cirílico ou parênteses: assim o arquivo não quebra no upload, em links e scripts.
  • Formato: <slug-do-video>-<letra-da-variante>-<técnica>-v<numero>.jpg, exemplo cheap-cam-a-face-v2.jpg.
  • Nova versão recebe um novo nome. Não sobrescreva os antigos: no teste, é importante saber qual arquivo exato foi carregado.
  • Estrutura de pasta do vídeo: sources/ (seus quadros e referências), generated/ (originais de geração), finals/ (miniaturas prontas), previews/ (reduzidas para exibição). Não deixe a única cópia no cache do gerador ou nos downloads do navegador.
  • Final: 1280x720 para vídeos, JPEG ou PNG, até 2 MB (limite do YouTube).

Verificação

python3 scripts/check_thumb.py finals/cheap-cam-a-face-v2.jpg
python3 scripts/check_thumb.py --shorts finals/cheap-cam-short-a-v1.jpg
python3 scripts/check_thumb.py finals/*.jpg
python3 scripts/check_thumb.py --make-test test-thumb.png

O script sem bibliotecas externas lê o cabeçalho PNG ou JPEG e verifica: tamanho 1280x720 (com --shorts 1080x1920), peso até 2 MB, nome do arquivo em latim sem espaços. Código de saída 1 em caso de violações. --make-test cria um PNG cinza do tamanho necessário para testar o próprio script.

A verificação a olho nu em tamanho reduzido é obrigatória, o script não a substitui. Reduza a miniatura para cerca de 200 pixels de largura (aproximadamente como aparece no feed do celular) e coloque ao lado de 5-6 miniaturas de terceiros do mesmo tema. Perguntas: é claro em um segundo o que é; o texto é legível; o herói não se perde entre os vizinhos; o canto inferior direito está livre.

Mostrar ao proprietário

Uma única mensagem, para que a resposta seja uma palavra:

  • miniaturas reduzidas lado a lado (folha de contato);
  • caminhos para 3-4 finais, numerados;
  • recomendação: qual variante e por quê, em uma frase;
  • 3-5 variantes de título, se necessário, descrição e tags.

Upload no canal, início do teste de miniatura e publicação apenas com a palavra direta do proprietário.

Exemplo (curto)

Vídeo: um mês filmando com uma câmera barata em vez de uma cara, comparando quadros.

  • Ideia: "a câmera barata acabou não sendo pior".
  • A: rosto grande do autor com sorriso incrédulo, na mão uma câmera pequena, logotipo do fabricante no corpo gerado no quadro. Texto "NÃO PIOR?".
  • B: duas câmeras em uma balança, a barata pesa mais. Sem texto.
  • C: quadro dividido "antes e depois", no centro autor encolhe os ombros. Texto "UM MÊS DEPOIS".
  • Título: "Um mês com câmera barata em vez de cara | Comparação de quadros".
  • Arquivos: cheap-cam-a-face-v1.jpg, cheap-cam-b-scales-v1.jpg, cheap-cam-c-split-v1.jpg.

Erros típicos

  • Captura de tela do vídeo com cor ajustada em vez de quadro montado. Plano, perde para vizinhos em luz.
  • Quatro variantes do mesmo quadro. O teste compara a mesma coisa, não há o que escolher.
  • Herói pequeno e muito espaço. Bonito em tela grande, vazio no celular.
  • Cinco palavras de texto. No celular, é uma faixa cinza.
  • Texto repete o título. Espaço desperdiçado duas vezes na mesma coisa.
  • Letras tortas do modelo em cirílico. Visível imediatamente, parece descuidado.
  • Logotipo sobreposto depois sobre o quadro. Parece um adesivo.
  • Texto ou rosto no canto inferior direito sob a duração do vídeo.
  • Miniatura promete o que não está no vídeo. Cliques há, visualização não, e o teste não escolherá tal miniatura.
  • Cada vídeo em um novo estilo. O canal não é reconhecido no feed.
  • Sobrescrita de arquivo com o mesmo nome. Depois não se sabe o que foi carregado.

Checklist antes de mostrar

  • Briefing preenchido, ideia da miniatura escrita em uma frase.
  • Título e miniatura se complementam, não se duplicam.
  • 3-4 conceitos diferentes, não repetições.
  • Seus quadros usados como referência, funções das referências atribuídas.
  • Visual de film-look em cada prompt, proporção como parâmetro.
  • Logotipos, se necessários, gerados no quadro e verificados com zoom.
  • Texto de até 3-4 palavras ou sem texto, letras verificadas.
  • Canto inferior direito livre.
  • Verificado em tamanho reduzido ao lado de miniaturas de terceiros.
  • check_thumb.py passou: tamanho, peso, nome.
  • Série do canal respeitada ou mudança consciente.
  • Variantes mostradas ao proprietário, escolha obtida antes do upload.

O que desatualiza primeiro

Nomes de modelos, modos em lote e limites de agregadores, regras de teste de miniatura no YouTube, limite de peso de arquivo. Antes de trabalhar, verifique a ajuda da ferramenta e a ajuda do YouTube, não a memória. Regras de quadro e texto desatualizam lentamente. Fatos verificados em outubro de 2026.

Mais fundo

Modelos completos de prompts, análises de pacotes reais de miniatura e configuração de série para um canal específico, o estúdio AIVFX mostra em trabalho e 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

Runs a client AI video for a concept studio from brief to delivery. Takes the brief and real product photos, writes a synopsis, builds character and location sheets with 3 options each, a 16:9 approval deck, stills in waves, one prompt for the whole video, client revisions as a list, assembly and a delivery checklist. Core rule: the client approves the preproduction package before the first video frame, and the approved character and location sheets go as references into every generation. Use when a brief arrives for an advertising or product AI video. Triggers: 'client AI video', 'preproduction package', 'character sheet', 'location sheet'. Not for articles or covers (use blog-article and article-cover). Triggers (RU): «вот бриф», «новый клиент», «концепт студия», «препродакшн-пакет», «лист персонажа», «лист локации», «презентация клиенту», «правки от клиента», «готовим сдачу».

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): «сделай плашку», «нижняя треть», «плашка с именем», «заставка», «глава», «титры», «хук для шортс», «финальная карточка», «моушен для ролика», «графика с альфой для монтажа», «заведи бренд для графики», «сделай на хайперфреймс».

Habilidades Relacionadas