Communitygithub.com

jelukas/kaleidos

Produz vídeos curtos, muito dinâmicos e com cortes rápidos para YouTube, Shorts, TikTok ou Reels, nos formatos vertical e horizontal ao mesmo tempo, com locução gerada (ElevenLabs), música e efeitos, B-roll gerado por gpt-image-2, fotografia real via Apify e montagem HTML+GSAP com HyperFrames. Use sempre que o usuário pedir um vídeo, um explainer, um vídeo de notícia, um short, um reel, um vídeo para TikTok ou YouTube, um vídeo com narração ou locução, um vídeo animado com dados ou números, ou quiser converter um texto, roteiro ou notícia em vídeo — mesmo que não mencione HyperFrames, ElevenLabs nem nenhuma ferramenta específica. Use também para retocar, alongar, reenquadrar ou renderizar novamente um vídeo já feito com este fluxo.

O que é kaleidos?

A skill **jelukas/kaleidos** transforma temas, roteiros ou notícias em dois vídeos MP4 sincronizados—vertical (1080×1920) e horizontal (1920×1080)—a partir de uma única fonte. Ela é ideal para criar conteúdo dinâmico e de alto impacto para plataformas como YouTube, TikTok, Shorts e Reels, com cortes rápidos, B-roll gerado por inteligência artificial (gpt-image-2) e fotografia real (via Apify), além de locução profissional com emoções (ElevenLabs, modelo v3), música e efeitos sonoros. O fluxo baseia-se em um roteiro que dita o ritmo: cada linha do script é convertida em áudio, e os tempos reais são usados para sincronizar automaticamente o vídeo, eliminando a necessidade de estimativas manuais. A montagem é feita com HyperFrames, usando HTML, GSAP para animações e CSS responsivo (vw/vh/vmin) para que cada cena funcione perfeitamente em ambos os formatos. A skill também inclui verificações de qualidade obrigatórias (`npm run check`), validação jornalística (com referencia a `references/periodismo.md`) e um conjunto de nove cenas animadas SVG pré-prontas para evitar o erro comum de um carrossel de texto. Suporta Node 22+, ffmpeg e requer chaves de API no `.env`. Ideal para produtores de conteúdo que desejam criar vídeos explicativos, notícias ou peças promocionais com alto nível de polimento e sem retrabalho manual de sincronização.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jelukas/kaleidos/tree/HEAD/skills-globales/video-corto

Perguntar na sua IA favorita

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

Documentação

Vídeo curto dual-formato

Converte um tema, um roteiro ou uma notícia em dois MP4 — vertical 1080×1920 e horizontal 1920×1080 — gerados a partir de uma única fonte. A locução define o ritmo; todo o resto depende dela.

Antes de tudo: se o tema é uma notícia

Verifique os fatos com pesquisa web antes de escrever uma única linha de roteiro. Um vídeo informativo com dados falsos é o pior resultado possível desta skill, e é uma falha silenciosa: o vídeo sai igualmente bonito.

Se a premissa da solicitação não se sustenta, diga e monte o que realmente aconteceu. Não "suavize" o roteiro para encaixar em uma premissa falsa. Leia references/periodismo.md antes de tocar no roteiro: ele cobre verificação, tratamento de imagens em peças informativas e o arquivo de rastreabilidade.

O fluxo

npm run voz -- <slug>       # script.json → assets/voice/*.wav + manifest de tempos
npm run imagens -- <slug>   # images.json → B-roll gerado
npm run stock -- <slug>     # stock.json  → fotografia real (opcional, pago)
npm run audio -- <slug>     # audio.json  → música e efeitos
npm run build -- <slug>     # plan.json   → vertical.html + horizontal.html
npm run use -- <slug> vertical
npm run check               # obrigatório: 0 erros antes de renderizar
npm run render -- <slug>    # renders/<slug>-<formato>.mp4

Se o projeto ainda não existe: npx hyperframes@latest init . --non-interactive --example blank, copie scripts/ e assets/ desta skill e adicione os scripts do package.json. Requer Node 22+ e ffmpeg. Chaves no .env (modelo em assets/env.example).

Estrutura

videos/_shared/vox.css, timeline.js     compartilhados por TODOS os vídeos
videos/<slug>/
  script.json   roteiro — uma linha = um corte
  images.json   prompts de B-roll gerado
  stock.json    consultas de fotografia real
  audio.json    música e efeitos
  plan.json     a montagem: beats que referenciam linhas do roteiro
  scenes/*.html sub-composições animadas de uso único
  assets/       o que é gerado + manifests com os tempos reais
  vertical.html, horizontal.html   GERADOS por build.mjs — não editar

As duas ideias que sustentam tudo

1. O roteiro manda no relógio. voice.manifest.json traz o start e a duration reais de cada linha. Um beat de plan.json referencia linhas, não segundos. Nunca estime durações de olho: mude o roteiro, regenere a voz e a montagem se reposiciona sozinha.

2. Os shells são artefatos. Com dezenas de cortes em dois formatos, sincronizá-los manualmente é inviável. build.mjs gera os dois a partir do mesmo plan.json, então eles não podem divergir: a única diferença é o tamanho do palco. Edite plan.json e reconstrua.

Para que uma cena valha em 9:16 e 16:9: modele em vw/vh/vmin, nunca px fixos; a raiz de uma sub-composição não leva data-width/data-height (a caixa é definida pelo slot do host); e estilize por #root, nunca por uma classe — o escopo do compilador a descarta. Para layouts que mudam de eixo, @media (min-aspect-ratio: 1/1).

Tipos de beat

stat (número protagonista com contagem ascendente via countTo) · compare (dois números confrontados) · title (kicker + título + entrada) · quote (citação + atribuição) · photo (imagem em tela cheia com gradiente, texto e crédito) · capture (captura de tela inteira, com sua fonte, como prova do que se afirma) · scene (sub-composição animada de uso único).

Para vídeos sobre uma empresa ou um produto, o logotipo e uma captura da fonte melhoram muito o resultado: ambos em references/imagens.md.

O erro de design mais comum: o carrossel de rótulos

Um vídeo feito apenas de cartões de texto entedia, por melhor que seja a tipografia. Quando notar que se acumulam title e stat seguidos, a solução não é mais texto: é movimento com significado.

assets/scenes/ traz nove cenas animadas em SVG prontas para adaptar: olas, puntos, barras, mapa, cierre, orbita (corpos orbitando), precos (tabela antes→depois), caida (uma queda com sua porcentagem) e indice (ranking com barras). Copie a que encaixar para videos/<slug>/scenes/ e altere os dados. Detalhes e regras de desempenho em references/escenas-animadas.md.

Alterne: número → foto → cena animada → citação → foto. E varie o enquadramento em cada corte (kb: "in" / "out" alterna o Ken Burns).

Ritmo

Beats de 2 a 6 s em um explainer de três minutos; de 0,8 a 2,5 s em um short. Cada beat dura até o próximo começar, para que não haja quadros pretos. Entradas com fromTo(), nunca from(): o host rebusca a cena a cada seek e from() dessincroniza.

Voz com emoções

eleven_multilingual_v2 ignora as tags. Para direcionar a interpretação, use "modelId": "eleven_v3" e tags em minúsculo entre colchetes, inline:

{ "id": "l19", "text": "[somber] Sessenta e sete pessoas morreram." }

Ajuste o registro ao tema — em uma notícia com vítimas, nada de [excited]. Catálogo de tags, ajustes e como verificar que não são lidas em voz alta: references/audio.md.

Antes de dar como bom

npm run check deve sair com 0 erros. Depois, assista ao vídeo: extraia quadros (ffmpeg -ss <t> -i <mp4> -frames:v 1) ou use npx hyperframes snapshot --at 12,40,90, que também gera uma folha de contato. O linter não vê que um plano está preto, que um texto sai do limite ou que uma foto não é o que diz ser.

Referências

  • references/hyperframes.md — as restrições do framework que quebram o render em silêncio. Leia antes de escrever composições.
  • references/audio.md — ElevenLabs: voz com tags v3, música, efeitos, faixas.
  • references/imagens.md — gpt-image-2 e Apify, com o controle de custo.
  • references/periodismo.md — verificação e tratamento de imagens em notícias.
  • references/escenas-animadas.md — as nove cenas SVG, como criar novas e as duas armadilhas que custam uma tarde (colisão de classes com vox.css e GSAP reescrevendo o transform dos SVGs).
  • references/sistema-visual.md — a paleta e a tipografia do estilo explainer.

Individual skills in this repo

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

jelukas/kaleidos

>- Catálogo de guías de estilo de vídeo de kaleidos (estilos/): listar los estilos con sus referencias, aplicarlos a un proyecto del motor de Remotion o a un proyecto HyperFrames, recomendar 2–3 cuando no se indica ninguno, crear estilos nuevos (desde una web, una marca, un vídeo de referencia o una descripción), crear variantes y revisar la adherencia de un vídeo a su estilo antes de renderizar. Úsala cuando el usuario diga «con el estilo X», «en estilo curso-azul», «como el de Ensaya», «como el vídeo de la cabaña», «qué estilos hay», «enséñame los estilos», «qué estilo me recomiendas», «crea un estilo a partir de esta web», «saca el estilo de esta marca», «haz un estilo como este vídeo», «usa el estilo X pero con acento Y», «una variante de X más seria/más oscura/vertical», «revisa que el vídeo cumple el estilo», o cuando empiece un vídeo nuevo sin estilo decidido.

jelukas/kaleidos

>- Puerta de entrada de kaleidos para montar un vídeo NUEVO conversando, de principio a fin: comprueba el entorno, hace UNA ronda corta de preguntas (qué vídeo y con qué material, plantilla, estilo, duración y formato), escribe BRIEF.md y lo enruta al flujo adecuado (grabación con ponente → Remotion edicion-ponente; narración con voz de ElevenLabs → Remotion modo narración; generativo o promo → HyperFrames), con stills antes de Lambda, OK con coste antes de AWS e informe final con tiempo y coste. Úsala cuando el usuario diga «quiero montar un vídeo», «quiero hacer/crear un vídeo», «monta un vídeo», «vídeo nuevo», «hazme un vídeo de…», «necesito un vídeo sobre…», «empecemos un vídeo», «un vídeo con las noticias de…», «un explainer de…», «una promo de…» o similares. En este repo va ANTES que hyperframes, video-corto, product-launch-video, general-video y edicion-ponente: ella decide cuál usar. No la uses para retocar o re-renderizar un proyecto que ya existe (eso lo retoma su propia skill).

Habilidades Relacionadas