Communitygithub.com

jelukas/kaleidos

Porta de entrada do kaleidos para montar um vídeo NOVO conversando, do início ao fim: verifica o ambiente, faz UMA rodada curta de perguntas (qual vídeo e com qual material, template, estilo, duração e formato), escreve o BRIEF.md e o encaminha para o fluxo adequado (gravação com apresentador → Remotion edicao-apresentador; narração com voz ElevenLabs → Remotion modo narração; gerativo ou promo → HyperFrames), com stills antes do Lambda, OK com custo antes da AWS e relatório final com tempo e custo. Use quando o usuário disser «quero montar um vídeo», «quero fazer/criar um vídeo», «monta um vídeo», «vídeo novo», «faz um vídeo de…», «preciso de um vídeo sobre…», «vamos começar um vídeo», «um vídeo com as notícias de…», «um explainer de…», «uma promo de…» ou similares. Neste repositório, ela vem ANTES de hyperframes, video-curto, product-launch-video, general-video e edicao-apresentador: ela decide qual usar. Não use para retocar ou re-renderizar um projeto que já existe (isso é retomado pela própria skill).

O que é kaleidos?

Esta skill, **kaleidos**, funciona como a porta de entrada inteligente para a criação de novos vídeos dentro do ecossistema. Seu principal objetivo é eliminar a complexidade inicial: ao receber uma solicitação genérica como "monta um vídeo", ela conduz uma curta entrevista (3–4 perguntas) para deduzir o material de origem (gravação real, narração por IA ou conteúdo gerativo), a plantilha, o estilo visual e o formato de saída. Com base nisso, a skill escreve automaticamente um `BRIEF.md` e **encaminha o projeto para a skill especializada correta**: `edicao-apresentador` para gravações com pessoas, o fluxo de narração com ElevenLabs para vídeos explicativos ou noticiosos, e `HyperFrames` para conteúdo gerativo ou promocional. Ela também implementa pontos de controle críticos: verificações de stills antes de qualquer renderização em Lambda, confirmação explícita do custo antes de provisionar recursos AWS, e um relatório final detalhado com tempo de execução e custos reais. Esta skill não deve ser usada para retocar projetos existentes; ela sempre inicia um novo projeto do zero.

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

Perguntar na sua IA favorita

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

Documentação

Montar um vídeo (entrada)

Fonte: docs/MONTAR_VIDEO.md. Esta skill é o roteiro operacional; os detalhes (tabelas de dedução, comandos completos, paralelismo, problemas frequentes) estão lá, citados por seção (§). Leia também as regras do CLAUDE.md do repositório: elas prevalecem sobre isto.

Passo 0 · Inicialização (ainda sem perguntar nada)

  1. Hora de início: date '+%Y-%m-%d %H:%M:%S'. Guarde-a (irá para BRIEF.md › Início e para o relatório).
  2. node scripts/doctor.mjs (≈ 1 s, somente leitura). Leia «Pronto para». Um ✗ do fluxo que for relevante → aplique a solução que ele imprime (se for local e gratuita) ou avise o usuário na mesma resposta da entrevista.
  3. Veja ls brutos/ projetos/. Se o projeto já existir, retome (leia seu BRIEF.md e informe.md) em vez de entrevistar. Se um nome de arquivo de brutos/ contiver um nome de pessoa, no chat descreva-o pela duração e resolução (ffprobe), não pelo nome.

Passo 1 · Entrevista: UMA chamada a AskUserQuestion (3–4 perguntas)

Antes, deduza da frase do usuário tudo o que for possível (§2). Não pergunte o que ele já disse: substitua essa pergunta pela próxima da reserva. Cada pergunta: 2–4 opções, a recomendada primeiro com «(recomendado)» na etiqueta e o motivo na descrição. Sempre deixe a resposta livre («Outro»). Detalhe de cada pergunta: §1.

#headerPerguntaOpções (recomendada conforme contexto)
1MaterialQual vídeo e com qual material?Gravação com apresentador (há bruto em brutos/) · Narração com voz IA (notícias, explainer; sem gravação) · Gerativo ou promo (HyperFrames)
2ModeloQual modelo?conforme 1: aula-longa / curto-ilustrado · noticias-narracao / explainer-narracao · promo-hyperframes / fluxo do HyperFrames — e Livre, sem modelo. Se 1 estiver em aberto: Longa por capítulos · Curta · Livre
3EstiloQual estilo?2 do catálogo que se encaixem, com o caminho de sua referência (estilos/README.md) · Novo a partir de um site ou vídeo (estilos-video §5). Livre → Outro
4FormatoDuração e formato?16:9, duração do modelo (Remotion) · 9:16 · 16:9 e 9:16 (recomendado em video-curto). Outra duração → Outro

Reserva (em ordem): idioma · voz (por padrão a do .env, modelo eleven_v4) · música e efeitos (os do estilo ou novos com ElevenLabs) · fontes (o usuário as fornece ou são pesquisadas oficiais) · corte do apresentador · público e destino. Recomendações de estilo por rota e modelos com duração e exemplo real: §1 e §1.1. Uma segunda pergunta somente se faltar algo imprescindível: qual bruto (se houver vários), o tema, uma URL.

Outros agentes (Codex…): o mesmo conteúdo em uma única mensagem com as perguntas numeradas e as opções em lista.

Passo 2 · Brief

Com as respostas, resuma em um parágrafo o confirmado e o deduzido (com de onde veio) e já inicie o que é gratuito. Escreva BRIEF.md a partir de modelos/<modelo>/BRIEF.md (§3):

  • Remotion: após tools/kaleidos novo … (que cria um vazio), substitua-o pelo modelo preenchido.
  • HyperFrames: o fluxo o escreve após npx hyperframes init (init se recusa se houver arquivos dentro).

Passo 3 · Roteamento (comandos exatos em §4)

MaterialRotaO que fazer
Gravação com apresentador§4.1Siga a skill edicao-apresentador: tools/kaleidos novo <slug> --bruto brutos/<x> --estilo <e> --metodo <m> → tools/kaleidos preparar <slug> --paralelo em segundo plano → ler a transcrição inteira → roteiro.json (esqueleto em modelos/<modelo>/) → linha / media / capitulos
Narração com voz IA§4.2tools/kaleidos novo <slug> --narracao --estilo milikito --cenario → copiar modelos/<modelo>/* → fontes oficiais em fontes.md → locucao.json → em paralelo images.mjs ‖ capture.mjs ‖ voz --simular e voz --max-caracteres N → transcrever → python3 modelos/ferramentas/cues.py <slug> → media → linha → media → capitulos
Gerativo ou promo§4.3Carregue a skill /hyperframes (escolha video-curto, product-launch-video, general-video…), projeto em projetos/<slug>/, estilo como frame.md após init
Estilo novo ou variante§4.4Skill estilos-video (§5 novo, §6 variante) e validar.mjs em verde antes de usar

intro.previo sim, intro.ate não, em narração; nada de eventos nos 3,4 s de um rótulo de capítulo; balões em x 0,2–0,25 e y 0,16–0,17 (§4.2, ponto 6).

Passo 4 · Paralelismo (§6)

Lance simultaneamente o que não compete: voz ‖ images.mjs --concurrency 6 ‖ capture.mjs ‖ pesquisa e roteiro; preparar --paralelo (pausa na CPU enquanto corta na GPU) e o roteiro assim que a transcrição existir. Não simultaneamente em 16 GB: recortar + transcrever + pose, duas etapas de GPU, dois stills.mjs, nem el-audio.mjs com voz. Processos longos em segundo plano com registro completo (sem grep sobre ffmpeg). Lambda com --concorrencia max.

Passo 5 · Pontos de verificação (§5)

  1. APIs pagas: voz --simular (caracteres) e nº de imagens antes de gerá-las; Apify somente se o brief o pedir, com --dry-run e --budget.
  2. Stills antes do Lambda, sempre: node motor/scripts/stills.mjs <slug> --at eventos → abra a folha (motor/out/stills/<nome>/folha.jpg) com Read, olhe de verdade e corrija (roteiro antes do código). Aderência ao estilo com estilos-video §7. HyperFrames: npx hyperframes check --snapshots.
  3. AWS: node motor/scripts/lambda.mjs <slug> --dry-run --concorrencia max → mostre recursos (função, site, bucket privado, uploads), nº de funções, custo e tempo estimados → espere o OK explícito. Se o usuário já pediu expressamente o render no Lambda nesta requisição: mostre e lance sem esperar. Criar recursos (bucket, stack, IAM) precisa sempre de um OK separado. HyperFrames sem Lambda implantada → avise e ofereça render local ou implantar.
  4. Saída: ffprobe + contagem de quadros, folha de um quadro por minuto e python3 modelos/ferramentas/normalizar_audio.py resultados/<slug>.mp4 --no-site (Lambda sai a ≈ −13 LUFS).
  5. Relatório final (projetos/<slug>/informe.md + resumo no chat): duração, estrutura, o que foi verificado (quadros amostrados, não visualização completa), avisos, incoerências, tempo total de relógio (início → MP4 verificado, com detalhamento de work/logs/tempos.json) e custo (Lambda real + S3 + transferência; caracteres do ElevenLabs de work/voz/manifest.json; imagens; Apify). Sem valores inventados: se não souber um preço, informe a quantidade consumida. Diga o que fica na AWS.

Regras que não podem ser ignoradas (§8 e §9)

  • Privacidade: nenhum dado pessoal de clientes em respostas, relatórios, gráficos ou rótulos; não cite fragmentos de transcrição com dados pessoais; o que aparecer na tela deve ser desfocado. Rótulos genéricos.
  • .env: nunca mostre valores nem os coloque em URLs; o doctor só fornece nomes.
  • Conteúdo: os gráficos resumem o que a voz diz; nada inventado; atualidade apenas com fontes oficiais citadas em fontes.md com data (se um site der 403 ao download, leia-o com o navegador integrado); incoerências no relatório; legal ou clínico → validação de um especialista.
  • brutos/ e ~/videos-opus são somente leitura. Remotion 4.0.529 exato. Fontes apenas OFL/Apache.

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

>- Produce vídeos cortos, muy dinámicos y con cortes rápidos para YouTube, Shorts, TikTok o Reels, en formato vertical Y horizontal a la vez, con locución generada (ElevenLabs), música y efectos, B-roll de gpt-image-2, fotografía real vía Apify y montaje HTML+GSAP con HyperFrames. Úsala siempre que el usuario pida un vídeo, un explainer, un vídeo de una noticia, un short, un reel, un vídeo de TikTok o de YouTube, un vídeo con voz en off o locución, un vídeo animado con datos o cifras, o quiera convertir un texto, un guion o una noticia en vídeo — aunque no mencione HyperFrames, ElevenLabs ni ninguna herramienta concreta. Úsala también para retocar, alargar, reencuadrar o volver a renderizar un vídeo ya hecho con este flujo.

Habilidades Relacionadas