Communitygithub.com

jelukas/kaleidos

Porte d'entrée de Kaleidos pour monter une vidéo NOUVELLE en conversant, de bout en bout : vérifie l'environnement, pose UNE série rapide de questions (quelle vidéo et avec quel matériel, modèle, style, durée et format), rédige BRIEF.md et achemine vers le flux approprié (enregistrement avec intervenant → Remotion edition-ponente ; narration avec voix ElevenLabs → Remotion mode narration ; génératif ou promo → HyperFrames), avec des stills avant Lambda, un OK sur le coût avant AWS et un rapport final temps et coût. À utiliser quand l'utilisateur dit « je veux monter une vidéo », « je veux faire/créer une vidéo », « monte une vidéo », « nouvelle vidéo », « fais-moi une vidéo de… », « j’ai besoin d’une vidéo sur… », « commençons une vidéo », « une vidéo avec les infos de… », « un explainer de… », « une promo de… » ou similaire. Dans ce dépôt, elle vient AVANT hyperframes, video-corto, product-launch-video, general-video et edicion-ponente : elle décide laquelle utiliser. Ne l'utilise pas pour retoucher ou re-rendre un projet qui existe déjà (ce sera repris par sa propre skill).

Qu'est-ce que kaleidos ?

Cette skill, nommée **Kaleidos**, est le point d'entrée unique pour tout nouveau projet vidéo dans l'écosystème de l'agent. Elle orchestre l'ensemble du pipeline de création vidéo, depuis la vérification initiale de l'environnement jusqu'à la livraison du fichier MP4 final, en passant par une interview concise de l'utilisateur, la rédaction d'un brief (BRIEF.md), puis le routage vers les sous-skills spécialisées (edicion-ponente pour les enregistrements avec intervenant, Remotion pour les narrations vocales générées par ElevenLabs, ou HyperFrames pour les vidéos génératives ou promotionnelles). Son utilité principale réside dans le fait qu'elle centralise et automatise les décisions initiales complexes (déduction du type de vidéo, du template, du style, du format) et qu'elle valide le coût avant tout appel à des services payants comme AWS Lambda (stills, rendu final) ou ElevenLabs. Elle impose des points de contrôle obligatoires : vérification des stills avant Lambda, validation du budget avant génération d'images ou de voix, et obtention d'un accord explicite sur le coût et le temps estimé avant tout déploiement cloud. Plateformes supportées : Remotion (via les skills edicion-ponente et narration), HyperFrames pour le contenu génératif/promo, et tout projet utilisant un pipeline basé sur Node.js et des outils comme ffmpeg, ffprobe et des services cloud (AWS Lambda, ElevenLabs, Apify). Le workflow inclut le parallélisme intelligent des tâches non conflictuelles, la gestion de fichiers bruts (brutos/) et de projets (projets/), ainsi qu'un rapport final détaillant le temps réel et le coût, garantissant une transparence totale.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Monter une vidéo (entrée)

Source : docs/MONTAR_VIDEO.md. Cette skill est le script opérationnel ; les détails (tables de déduction, commandes complètes, parallélisme, problèmes fréquents) s'y trouvent, cités par section (§). Lis aussi les règles du CLAUDE.md du dépôt : elles prévalent sur celles-ci.

Étape 0 · Démarrage (sans rien demander encore)

  1. Heure de début : date '+%Y-%m-%d %H:%M:%S'. Enregistre-la (elle ira dans BRIEF.md › Début et dans le rapport).
  2. node scripts/doctor.mjs (≈ 1 s, lecture seule). Lis « Prêt pour ». Un ✗ du flux concerné → applique la solution qu'il imprime (si elle est locale et gratuite) ou dis-la à l'utilisateur dans la même réponse que l'entretien.
  3. Regarde ls brutos/ proyectos/. Si le projet existe déjà, reprends-le (lis son BRIEF.md et informe.md) au lieu de faire un entretien. Si un nom de fichier dans brutos/ porte un nom de personne, décris-le dans le chat par sa durée et sa résolution (ffprobe), pas par son nom.

Étape 1 · Entretien : UN appel à AskUserQuestion (3–4 questions)

Avant, déduis tout ce qui est possible de la phrase de l'utilisateur (§2). Ne demande pas ce qu'il a déjà dit : remplace cette question par la suivante de la réserve. Chaque question : 2–4 options, la recommandée en premier avec « (recommandé) » dans le libellé et le pourquoi dans la description. La réponse libre (« Autre ») est toujours possible. Détail de chaque question : §1.

#en-têteQuestionOptions (recommandée selon le contexte)
1MatérielQuelle vidéo et avec quel matériel ?Enregistrement avec intervenant (il y a une source brute dans brutos/) · Narration avec voix IA (actualités, explainer ; sans enregistrement) · Génératif ou promo (HyperFrames)
2ModèleQuel modèle ?selon 1 : clase-larga / corto-ilustrado · noticias-narracion / explainer-narracion · promo-hyperframes / flux HyperFrames — et Libre, sans modèle. Si 1 est ouverte : Long par chapitres · Court · Libre
3StyleQuel style ?2 du catalogue qui correspondent, avec le chemin de leur référence (estilos/README.md) · Nouveau depuis un site web ou une vidéo (estilos-video §5). Libre → Autre
4FormatDurée et format ?16:9, durée du modèle (Remotion) · 9:16 · 16:9 et 9:16 (recommandé pour video-corto). Autre durée → Autre

Réserve (dans l'ordre) : langue · voix (par défaut celle de .env, modèle eleven_v4) · musique et effets (ceux du style ou nouveaux avec ElevenLabs) · polices (l'utilisateur les fournit ou elles sont recherchées officielles) · recadrage de l'intervenant · public et destination. Recommandations de style par chemin et modèles avec durée et exemple réel : §1 et §1.1. Une deuxième question seulement si quelque chose d'essentiel manque : quelle source brute (s'il y en a plusieurs), le sujet, une URL.

Autres agents (Codex…) : le même contenu dans un seul message avec les questions numérotées et les options en liste.

Étape 2 · Brief

Avec les réponses, résume en un paragraphe ce qui est confirmé et ce qui est déduit (avec d'où ça vient) et lance déjà ce qui est gratuit. Écris BRIEF.md à partir de plantillas/<template>/BRIEF.md (§3) :

  • Remotion : après tools/kaleidos nuevo … (qui en crée un vide), remplace-le par le template rempli.
  • HyperFrames : le flux l'écrit après npx hyperframes init (init refuse s'il y a des fichiers à l'intérieur).

Étape 3 · Routage (commandes exactes au §4)

MatérielCheminQue faire
Enregistrement avec intervenant§4.1Suis la skill edicion-ponente : tools/kaleidos nuevo <slug> --bruto brutos/<x> --estilo <e> --metodo <m> → tools/kaleidos preparar <slug> --paralelo en arrière-plan → lire la transcription entière → guion.json (squelette dans plantillas/<template>/) → linea / media / capitulos
Narration avec voix IA§4.2tools/kaleidos nuevo <slug> --narracion --estilo milikito --escenario → copier plantillas/<template>/* → polices officielles dans fuentes.md → locucion.json → en parallèle images.mjs ‖ capture.mjs ‖ voz --simular et voz --max-caracteres N → transcribir → python3 plantillas/herramientas/cues.py <slug> → media → linea → media → capitulos
Génératif ou promo§4.3Charge la skill /hyperframes (choisit video-corto, product-launch-video, general-video…), projet dans proyectos/<slug>/, style comme frame.md après init
Nouveau style ou variante§4.4Skill estilos-video (§5 nouveau, §6 variante) et validar.mjs au vert avant de l'utiliser

intro.previo oui, intro.hasta non, en narration ; rien d'événements dans les 3,4 s d'un cartouche de chapitre ; bulles à x 0,2–0,25 et y 0,16–0,17 (§4.2, point 6).

Étape 4 · Parallélisme (§6)

Lance en même temps ce qui n'entre pas en compétition : voz ‖ images.mjs --concurrency 6 ‖ capture.mjs ‖ recherche et scénario ; preparar --paralelo (pose sur CPU pendant qu'il recadre sur GPU) et le scénario dès que la transcription existe. Pas en même temps sur 16 Go : recortar + transcribir + pose, deux étapes GPU, deux stills.mjs, ni el-audio.mjs avec voz. Processus longs en arrière-plan avec journal complet (sans grep sur ffmpeg). Lambda avec --concurrencia max.

Étape 5 · Points de contrôle (§5)

  1. APIs payantes : voz --simular (caractères) et nombre d'images avant de les générer ; Apify seulement si le brief le demande, avec --dry-run et --budget.
  2. Stills avant Lambda, toujours : node motor/scripts/stills.mjs <slug> --at eventos → ouvre la planche (motor/out/stills/<nom>/hoja.jpg) avec Read, regarde-la vraiment et corrige (scénario avant code). Conformité au style avec estilos-video §7. HyperFrames : npx hyperframes check --snapshots.
  3. AWS : node motor/scripts/lambda.mjs <slug> --dry-run --concurrencia max → affiche les ressources (fonction, site, bucket privé, uploads), nombre de fonctions, coût et temps estimés → attends l'OK explicite. Si l'utilisateur a déjà expressément demandé le rendu sur Lambda dans cette requête : montre-le et lance-le sans attendre. Créer des ressources (bucket, stack, IAM) nécessite toujours un OK séparé. HyperFrames sans Lambda déployée → préviens et propose un rendu local ou un déploiement.
  4. Sortie : ffprobe + comptage d'images, planche d'une image par minute et python3 plantillas/herramientas/normalizar_audio.py resultados/<slug>.mp4 --en-sitio (Lambda sort à ≈ −13 LUFS).
  5. Rapport final (proyectos/<slug>/informe.md + résumé dans le chat) : durée, structure, ce qui a été vérifié (images échantillonnées, pas de visionnage complet), avertissements, incohérences, temps total réel (début → MP4 vérifié, avec détail de work/logs/tiempos.json) et coût (Lambda réel + S3 + transfert ; caractères ElevenLabs de work/voz/manifest.json ; images ; Apify). Pas de montants inventés : si tu ne connais pas un prix, donne la quantité consommée. Dis ce qui reste sur AWS.

Règles non négociables (§8 et §9)

  • Vie privée : aucune donnée personnelle de clients dans les réponses, rapports, graphiques ou cartouches ; ne cite pas d'extraits de transcription contenant des données personnelles ; ce qui apparaît à l'écran doit être flouté. Cartouches génériques.
  • .env : ne montre jamais les valeurs ni ne les mets dans des URL ; le docteur ne donne que des noms.
  • Contenu : les graphiques résument ce que dit la voix ; rien d'inventé ; actualité seulement avec sources officielles citées dans fuentes.md avec date (si un site web donne 403 au téléchargement, lis-le avec le navigateur intégré) ; incohérences dans le rapport ; juridique ou clinique → validation par un expert.
  • brutos/ et ~/videos-opus sont en lecture seule. Remotion 4.0.529 exactement. Polices seulement 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.

Skills associés