Communitygithub.com

jelukas/kaleidos

Einstiegspunkt für Kaleidos, um ein NEUES Video von Anfang bis Ende zu erstellen: Umgebung prüfen, eine kurze Fragerunde (welches Video, mit welchem Material, Vorlage, Stil, Dauer und Format), BRIEF.md schreiben und an den passenden Workflow weiterleiten.

Was ist kaleidos?

Diese Skill dient als zentraler Einstiegspunkt für den Kaleidos-Videoproduktions-Workflow. Sie führt eine einzige, kurze Fragerunde durch, um die wichtigsten Parameter zu ermitteln (Aufnahmematerial, Vorlage, Stil, Dauer und Format), erstellt dann automatisch eine detaillierte Aufgabenbeschreibung (BRIEF.md) und leitet das Projekt an die geeignete Unterskill weiter – sei es für Aufnahmen mit einem Sprecher, KI-Sprachsynthese mit ElevenLabs, generative Inhalte mit HyperFrames oder die Entwicklung neuer Videostile. Die Skill priorisiert Effizienz und Kostenkontrolle: Sie führt Prüfungen vor der kostenpflichtigen Nutzung von APIs und AWS Lambda durch, erstellt Standbilder vor dem finalen Rendering und gibt einen abschließenden Bericht mit Zeit- und Kostenaufstellung aus. Wichtig: Diese Skill ist ausschließlich für die Erstellung neuer Videos gedacht und nicht für die Nachbearbeitung bestehender Projekte; erkennt sie ein vorhandenes Projekt, setzt sie dieses nahtlos fort.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Ein Video erstellen (Einstieg)

Quelle: docs/MONTAR_VIDEO.md. Diese Skill ist das operative Skript; die Details (Ableitungstabellen, vollständige Befehle, Parallelisierung, häufige Probleme) befinden sich dort, referenziert durch Abschnitt (§). Lies auch die Regeln der CLAUDE.md des Repositorys; sie haben Vorrang vor dieser Datei.

Schritt 0 · Start (noch nichts fragen)

  1. Startzeit: date '+%Y-%m-%d %H:%M:%S'. Speichere sie (wird in BRIEF.md › Inicio und im Bericht benötigt).
  2. node scripts/doctor.mjs (≈ 1 s, nur lesend). Lies die Ausgabe „Listo para“. Ein ✗ für den relevanten Workflow → wende die vorgeschlagene Lösung an (falls lokal und kostenlos) oder teile sie dem Benutzer im selben Antwortschritt nach dem Interview mit.
  3. Prüfe ls brutos/ proyectos/. Wenn das Projekt bereits existiert, fahre fort (lies BRIEF.md und informe.md) anstatt ein Interview zu führen. Wenn ein Dateiname in brutos/ einen Personennamen enthält, beschreibe ihn im Chat stattdessen anhand von Dauer und Auflösung (ffprobe), nicht anhand des Namens.

Schritt 1 · Interview: EIN Aufruf von AskUserQuestion (3–4 Fragen)

Leite vorab aus der Benutzeranfrage so viel wie möglich ab (§2). Frage nicht, was bereits gesagt wurde: Ersetze diese Frage durch die nächste aus der Reserve. Jede Frage: 2–4 Optionen, die empfohlene zuerst mit „(empfohlen)" im Label und der Begründung in der Beschreibung. Immer die freie Antwortmöglichkeit („Andere") bereithalten. Details zu jeder Frage: §1.

#headerFrageOptionen (empfohlen je nach Kontext)
1MaterialWelches Video und mit welchem Material?Aufnahme mit Sprecher (Rohmaterial in brutos/) · Erzählung mit KI-Stimme (Nachrichten, Erklärvideo; ohne Aufnahme) · Generativ oder Promo (HyperFrames)
2VorlageWelche Vorlage?je nach 1: clase-larga / corto-ilustrado · noticias-narracion / explainer-narracion · promo-hyperframes / HyperFrames-Workflow — und Frei, ohne Vorlage. Falls 1 noch offen: Lang mit Kapiteln · Kurz · Frei
3StilWelcher Stil?2 passende aus dem Katalog, mit Pfad zu deren Referenz (estilos/README.md) · Neu von einer Webseite oder einem Video (estilos-video §5). Frei → Andere
4FormatDauer und Format?16:9, Vorlagenlaufzeit (Remotion) · 9:16 · 16:9 und 9:16 (empfohlen bei video-corto). Andere Dauer → Andere

Reserve (in Reihenfolge): Sprache · Stimme (standardmäßig aus .env, Modell eleven_v4) · Musik und Effekte (aus dem Stil oder neu mit ElevenLabs) · Schriftarten (vom Benutzer bereitgestellt oder offizielle recherchieren) · Sprecherzuschnitt · Zielgruppe und -plattform. Stilempfehlungen nach Pfad und Vorlagen mit Dauer und Beispielvideo: §1 und §1.1. Eine zweite Frage nur, wenn etwas Wesentliches fehlt: welches Rohmaterial (falls mehrere), das Thema, eine URL.

Andere Agents (Codex …): gleicher Inhalt in einer einzigen Nachricht mit nummerierten Fragen und Optionen als Liste.

Schritt 2 · Brief

Fasse mit den Antworten das Bestätigte und das Abgeleitete (mit Quellenangabe) in einem Absatz zusammen und starte sofort die kostenlosen Schritte. Erstelle BRIEF.md ausgehend von plantillas/<Vorlage>/BRIEF.md (§3):

  • Remotion: Ersetze nach tools/kaleidos nuevo … (erzeugt eine leere Struktur) diese durch die ausgefüllte Vorlage.
  • HyperFrames: Der Workflow schreibt BRIEF.md nach npx hyperframes init (init verweigert sich, wenn bereits Dateien vorhanden sind).

Schritt 3 · Weiterleitung (genaue Befehle in §4)

MaterialPfadVorgehen
Aufnahme mit Sprecher§4.1Folge der Skill edicion-ponente: tools/kaleidos nuevo <slug> --bruto brutos/<x> --estilo <e> --metodo <m> → tools/kaleidos preparar <slug> --paralelo im Hintergrund → gesamtes Transkript lesen → guion.json (Grundgerüst in plantillas/<Vorlage>/) → linea / media / capitulos
Erzählung mit KI-Stimme§4.2tools/kaleidos nuevo <slug> --narracion --estilo milikito --escenario → plantillas/<Vorlage>/* kopieren → offizielle Schriftarten in fuentes.md → locucion.json → parallel images.mjs ‖ capture.mjs ‖ voz --simular und voz --max-caracteres N → transcribir → python3 plantillas/herramientas/cues.py <slug> → media → linea → media → capitulos
Generativ oder Promo§4.3Lade die Skill /hyperframes (wähle video-corto, product-launch-video, general-video…), Projekt in proyectos/<slug>/, Stil als frame.md nach init
Neuer Stil oder Variante§4.4Skill estilos-video (§5 neu, §6 Variante) und validar.mjs grün vor der Verwendung

intro.previo ja, intro.hasta nein bei Erzählung; keine Ereignisse in den 3–4 s eines Kapiteltitels; Sprechblasen bei x 0,2–0,25 und y 0,16–0,17 (§4.2, Punkt 6).

Schritt 4 · Parallelisierung (§6)

Starte gleichzeitig, was sich nicht gegenseitig behindert: voz ‖ images.mjs --concurrency 6 ‖ capture.mjs ‖ Recherche und Skripterstellung; preparar --paralelo (CPU-Pose, während GPU zuschneidet) und das Skript, sobald das Transkript existiert. Nicht gleichzeitig bei 16 GB: recortar + transcribir + pose, zwei GPU-Schritte, zwei stills.mjs oder el-audio.mjs mit voz. Langlaufende Prozesse im Hintergrund mit vollständigem Log (kein grep über ffmpeg). Lambda mit --concurrencia max.

Schritt 5 · Kontrollpunkte (§5)

  1. Bezahlte APIs: voz --simular (Zeichenanzahl) und Anzahl der Bilder vor deren Generierung; Apify nur wenn vom Brief gefordert, mit --dry-run und --budget.
  2. Stills vor Lambda, immer: node motor/scripts/stills.mjs <slug> --at events → öffne das Blatt (motor/out/stills/<name>/hoja.jpg) mit Read, prüfe es wirklich und korrigiere (Skript vor Code). Stilkonformität mit estilos-video §7. HyperFrames: npx hyperframes check --snapshots.
  3. AWS: node motor/scripts/lambda.mjs <slug> --dry-run --concurrencia max → zeige Ressourcen (Funktion, Site, privater Bucket, Uploads), Anzahl der Funktionen, geschätzte Kosten und Laufzeit → warte auf explizites OK. Wenn der Benutzer bereits explizit das Lambda-Rendering in dieser Anfrage gewünscht hat: Zeige es an und starte es ohne Wartezeit. Das Erstellen von Ressourcen (Bucket, Stack, IAM) benötigt immer ein separates OK. HyperFrames ohne bereitgestelltes Lambda → Warnung ausgeben und lokales Rendering oder Bereitstellung anbieten.
  4. Ausgabe: ffprobe + Bildzählung, Blatt mit einem Bild pro Minute und python3 plantillas/herramientas/normalizar_audio.py resultados/<slug>.mp4 --en-sitio (Lambda ergibt ≈ −13 LUFS).
  5. Abschlussbericht (proyectos/<slug>/informe.md + Zusammenfassung im Chat): Dauer, Struktur, was überprüft wurde (Stichproben, keine Vollansicht), Warnungen, Inkonsistenzen, Gesamtzeit (Start → MP4 verifiziert, mit Aufschlüsselung aus work/logs/tiempos.json) und Kosten (tatsächliche Lambda + S3 + Transfer; ElevenLabs-Zeichen aus work/voz/manifest.json; Bilder; Apify). Keine erfundenen Beträge: Wenn kein Preis bekannt ist, gib die verbrauchte Menge an. Gib an, was in AWS verbleibt.

Unverzichtbare Regeln (§8 und §9)

  • Datenschutz: Keine personenbezogenen Daten von Kunden in Antworten, Berichten, Grafiken oder Untertiteln; zitiere keine Transkriptauszüge mit personenbezogenen Daten; alles, was auf dem Bildschirm erscheint, wird unkenntlich gemacht. Generische Untertitel.
  • .env: Zeige niemals Werte an und setze sie nicht in URLs; Doctor gibt nur Namen aus.
  • Inhalt: Die Grafiken fassen zusammen, was die Stimme sagt; nichts Erfundenes; Aktualität nur mit offiziellen Quellen, zitiert in fuentes.md mit Datum (falls eine Website 403 beim Herunterladen liefert, lese sie mit dem integrierten Browser); Inkonsistenzen in den Bericht; rechtliche oder klinische Inhalte → Validierung durch einen Experten erforderlich.
  • brutos/ und ~/videos-opus sind schreibgeschützt. Exakt Remotion 4.0.529. Nur OFL/Apache-Schriftarten.

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.

Verwandte Skills