Communitygithub.com

LingoJack/jcli

Erstellen Sie Videokompositionen, Animationen, Titel, Overlays, Untertitel, Voiceovers, audio-reaktive Grafiken und Szenenübergänge in HyperFrames HTML. Dieses Skill wird verwendet, wenn Sie aufgefordert werden, HTML-basierte Videoinhalte zu erstellen, synchronisierte Untertitel hinzuzufügen, Text-to-Speech-Narration zu generieren, audio-reaktive Animationen (Beat-Sync, Glow, Pulse) zu erstellen, animierte Texthervorhebungen hinzuzufügen oder Übergänge zwischen Szenen einzufügen.

Was ist jcli?

Dieser Skill, LingoJack/jcli, befähigt einen KI-Agenten (wie Claude Code, Cursor oder Codex) dazu, als vollständige Videoproduktionsumgebung auf Basis von HyperFrames HTML zu fungieren. Er behandelt HTML als die Quelle der Wahrheit für Video und ermöglicht die Erstellung von Kompositionen mit data-* Attributen für Timing, GSAP-Timelines für Animationen und CSS für das visuelle Erscheinungsbild. Der Skill deckt den gesamten Workflow ab: von der anfänglichen Discovery und Designsystem-Definition über Prompt-Expansion und Planung bis hin zur konkreten Implementierung von Layout, Animation, Übergängen und Variablen. Er ist besonders nützlich für die Erstellung von Titelcards, Untertiteln, Voiceovers, audio-reaktiven Grafiken, animierten Texthervorhebungen und Szenenübergängen wie Crossfades und Wipes. Plattformunabhängig konzipiert, funktioniert er mit jedem HyperFrames-Setup und integriert nahtlos mit zugehörigen Skills wie hyperframes-cli für Dev-Loop-Befehle und hyperframes-media für Asset-Vorverarbeitung.

Funktioniert mit~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/LingoJack/jcli/tree/HEAD/.jcli/skills/hyperframes

In Ihrer bevorzugten KI fragen

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

Dokumentation

HyperFrames

HTML ist die Quelle der Wahrheit für Videos. Eine Komposition ist eine HTML-Datei mit data-*-Attributen für das Timing, einer GSAP-Timeline für Animationen und CSS für das Erscheinungsbild. Das Framework übernimmt die Sichtbarkeit von Clips, die Medienwiedergabe und die Zeitleistensynchronisation.

Vorgehensweise

Discovery (nur bei explorativen Anfragen)

Bei offenen Anfragen („Erstelle ein Produkt Launch Video“, „Erstelle etwas für unsere Marke“), bei denen der Benutzer noch keine Richtung festgelegt hat, sollten Sie die Absicht verstehen, bevor Sie Farben auswählen:

  • Zielgruppe – Wer sieht sich das an? Entwickler? Führungskräfte? Allgemeine Verbraucher?
  • Plattform – Wo wird es abgespielt? Social (15s), Website Hero, Produktdemo, intern?
  • Priorität – Was ist am wichtigsten? Bewegungsqualität? Inhaltsgenauigkeit? Markentreue? Geschwindigkeit?
  • Variationen – Möchte der Benutzer Optionen oder eine einzige beste Aufnahme?

Bei spezifischen Anfragen („Füge eine Titelcard hinzu“, „Korrigiere das Timing in Szene 3“) überspringen Sie die Discovery.

Bei explorativen Anfragen sollten Sie in Betracht ziehen, 2-3 Variationen anzubieten, die sich deutlich unterscheiden – nicht nur Farbtausch, sondern unterschiedliche Taktung, Energieniveaus oder strukturelle Ansätze. Eine sichere/erwartete, eine ambitionierte. Erzwingen Sie dies nicht – es ist ein Werkzeug, das bei Bedarf zur Verfügung steht.

Schritt 1: Designsystem

Wenn design.md oder DESIGN.md im Projekt existiert, lesen Sie es zuerst (überprüfen Sie beide Schreibweisen – auf Linux sind es unterschiedliche Dateien). Es ist die Quelle der Wahrheit für Markenfarben, Schriftarten und Einschränkungen. Verwenden Sie seine genauen Werte – erfinden Sie keine Farben und ersetzen Sie keine Schriftarten. Jedes Format ist geeignet (YAML-Frontmatter, Prosa, Tabellen – extrahieren Sie einfach die Werte).

Wenn es Schriftarten benennt, die Sie lokal nicht finden können (kein fonts/-Verzeichnis mit .woff2-Dateien, keine eingebaute Schriftart), warnen Sie den Benutzer vor dem Schreiben des HTML: „Die design.md gibt die Schriftart [Schriftartenname] an, aber es wurden keine Schriftartdateien gefunden. Bitte fügen Sie .woff2-Dateien zu fonts/ hinzu, oder ich verwende stattdessen [nächstgelegene eingebaute Alternative].“

Wenn keine design.md existiert, bieten Sie dem Benutzer eine Auswahl an:

  1. Hat der Benutzer einen Stil oder eine Stimmung genannt? → Lesen Sie visual-styles.md für die 8 benannten Presets. Wählen Sie die nächstgelegene Übereinstimmung.
  2. Möchte der Benutzer visuell Optionen durchsuchen? → Starten Sie den Design-Picker: Lesen Sie references/design-picker.md für den vollständigen Workflow. Dies dient eine visuelle Auswahlseite aus. Der Benutzer konfiguriert Stimmung, Palette, Typografie und Bewegung im Browser, kopiert dann die generierte design.md und fügt sie zurück in die Konversation ein.
  3. Möchte der Benutzer überspringen und schnell vorgehen? → Fragen Sie: Stimmung, hell oder dunkel, irgendwelche Markenfarben/Schriftarten? Wählen Sie dann eine Palette aus house-style.md.

design.md definiert die Marke. Es definiert keine Videokompositionsregeln. Diese stammen aus references/video-composition.md und house-style.md. Verwenden Sie Markenfarben in einer für Videos geeigneten Größenordnung – nicht in der Deckkraft einer Web-UI.

Schritt 2: Prompt-Erweiterung

Führen Sie dies immer bei jeder Komposition durch (außer bei Ein-Szenen-Stücken und trivialen Bearbeitungen). Dieser Schritt verankert die Absicht des Benutzers in Bezug auf design.md und house-style.md und erzeugt ein konsistentes Zwischenprodukt, das jeder nachgelagerte Agent auf die gleiche Weise liest.

Lesen Sie references/prompt-expansion.md für den vollständigen Prozess und das Ausgabeformat.

Schritt 3: Plan

Denken Sie auf hohem Niveau nach, bevor Sie HTML schreiben:

  1. Was – Was soll der Betrachter erleben? Identifizieren Sie den narrativen Bogen, die Schlüsselmomente und die emotionalen Beats.
  2. Struktur – Wie viele Kompositionen, welche sind Unterkompositionen vs. inline, welche Spuren transportieren was (Video, Audio, Overlays, Untertitel).
  3. Rhythmus – Deklarieren Sie Ihren Szenenrhythmus vor der Implementierung. Welche Szenen sind schnelle Treffer, welche sind Haltepunkte, wo landen Shader, wo ist der Energiehöhepunkt. Benennen Sie das Muster: schnell-schnell-LANGSAM-schnell-SHADER-Halt. Lesen Sie references/beat-direction.md für Rhythmusvorlagen.
  4. Timing – Welche Clips bestimmen die Dauer, wo landen Übergänge, wie ist das Tempo.
  5. Layout – Bauen Sie zuerst den Endzustand auf. Siehe „Layout vor Animation“ unten.
  6. Animieren – Fügen Sie dann Bewegung mit den unten stehenden Regeln hinzu.

Bauen Sie, worum gebeten wurde. Eine Anfrage nach „einer Titelcard“ ist keine Anfrage nach „einer Titelcard + 3 unterstützenden Szenen + Hintergrundmusik + Untertiteln.“ Jede Szene, jedes Element, jeder Tween sollte seinen Platz verdienen. Wenn zusätzliche Szenen oder Elemente das Stück wirklich verbessern würden, schlagen Sie sie vor – fügen Sie sie nicht hinzu.

Bei kleinen Bearbeitungen (Farbe korrigieren, Timing anpassen, ein Element hinzufügen) gehen Sie direkt zu den Regeln.

Layout vor Animation

Positionieren Sie jedes Element dort, wo es in seinem sichtbarsten Moment sein sollte – dem Frame, in dem es vollständig eingetreten, korrekt platziert und noch nicht wieder verlassen ist. Schreiben Sie dies zuerst als statisches HTML+CSS. Noch kein GSAP.

Warum das wichtig ist: Wenn Sie Elemente in ihrem animierten Startzustand (außerhalb des Bildschirms, auf 0 skaliert, Deckkraft 0) positionieren und sie dann dorthin tweenen, wo sie Ihrer Meinung nach landen sollen, raten Sie das endgültige Layout. Überlappungen sind unsichtbar, bis das Video gerendert wird. Indem Sie zuerst den Endzustand aufbauen, können Sie Layoutprobleme sehen und beheben, bevor Sie Bewegung hinzufügen.

Der Prozess

  1. Identifizieren Sie den Helden-Frame für jede Szene – den Moment, in dem die meisten Elemente gleichzeitig sichtbar sind. Dieses Layout bauen Sie auf.
  2. Schreiben Sie statisches CSS für diesen Frame. Der .scene-content Container MUSS die gesamte Szene mit width: 100%; height: 100%; padding: Npx; ausfüllen, mit display: flex; flex-direction: column; gap: Npx; box-sizing: border-box. Verwenden Sie Padding, um den Inhalt nach innen zu drücken – verwenden Sie NIEMALS position: absolute; top: Npx auf einem Inhaltscontainer. Absolut positionierte Inhaltscontainer laufen über, wenn der Inhalt höher als der verbleibende Platz ist. Reservieren Sie position: absolute nur für dekorative Elemente.
  3. Fügen Sie Eingänge mit gsap.from() hinzu – animieren Sie VOM Offscreen/Unsichtbar ZUR CSS-Position. Die CSS-Position ist die Grundwahrheit; der Tween beschreibt die Reise dorthin. (In Unterkompositionen, die über data-composition-src geladen werden, bevorzugen Sie gsap.fromTo() – siehe lasttragende GSAP-Regeln in references/motion-principles.md.)
  4. Fügen Sie Ausgänge mit gsap.to() hinzu – animieren Sie ZUM Offscreen/Unsichtbar VON der CSS-Position.

Beispiel

/* scene-content füllt die Szene, Padding positioniert den Inhalt */
.scene-content {
  display: flex;
  flex-direction: column;
  justify-content: center;
  width: 100%;
  height: 100%;
  padding: 120px 160px;
  gap: 24px;
  box-sizing: border-box;
}
.title {
  font-size: 120px;
}
.subtitle {
  font-size: 42px;
}
/* Container füllt jede Szenengröße (1920x1080, 1080x1920, usw.).
   Padding positioniert den Inhalt. Flex + Gap handhabt Abstände. */

FALSCH – fest codierte Abmessungen und absolute Positionierung:

.scene-content {
  position: absolute;
  top: 200px;
  left: 160px;
  width: 1920px;
  height: 1080px;
  display: flex; /* ... */
}
// Schritt 3: IN diese Positionen animieren
tl.from(".title", { y: 60, opacity: 0, duration: 0.6, ease: "power3.out" }, 0);
tl.from(".subtitle", { y: 40, opacity: 0, duration: 0.5, ease: "power3.out" }, 0.2);
tl.from(".logo", { scale: 0.8, opacity: 0, duration: 0.4, ease: "power2.out" }, 0.3);

// Schritt 4: Von diesen Positionen AUS animieren
tl.to(".title", { y: -40, opacity: 0, duration: 0.4, ease: "power2.in" }, 3);
tl.to(".subtitle", { y: -30, opacity: 0, duration: 0.3, ease: "power2.in" }, 3.1);
tl.to(".logo", { scale: 0.9, opacity: 0, duration: 0.3, ease: "power2.in" }, 3.2);

Wenn sich Elemente über die Zeit einen Raum teilen

Wenn Element A den Raum verlässt, bevor Element B in denselben Bereich eintritt, sollten beide korrekte CSS-Positionen für ihre jeweiligen Helden-Frames haben. Die Zeitleisten-Reihenfolge garantiert, dass sie nie visuell koexistieren – aber wenn Sie den Layout-Schritt überspringen, werden Sie den Fall nicht bemerken, in dem sie aufgrund eines Timing-Fehlers versehentlich überlappen.

Was als beabsichtigte Überlappung gilt

Geschichtete Effekte (Glow hinter Text, Schattenelemente, Hintergrundmuster) und Z-gestapelte Designs (Kartenstapel, Tiefenschichten) sind beabsichtigt. Beim Layout-Schritt geht es darum, unbeabsichtigte Überlappungen zu erkennen – zwei Überschriften, die übereinander landen, eine Statistik, die ein Label bedeckt, Inhalt, der aus dem Frame läuft.

Datenattribute

Alle Clips

AttributErforderlichWerte
idJaEindeutiger Bezeichner
data-startJaSekunden oder Clip-ID-Referenz ("el-1", "intro + 2")
data-durationErforderlich für img/div/compositionsSekunden. Video/Audio standardmäßig Mediendauer.
data-track-indexJaGanzzahl. Clips auf derselben Spur können sich nicht überlappen.
data-media-startNeinTrim-Offset in die Quelle (Sekunden)
data-volumeNein0-1 (Standard 1)

data-track-index beeinflusst nicht die visuelle Schichtung – verwenden Sie CSS z-index.

Kompositions-Clips

AttributErforderlichWerte
data-composition-idJaEindeutige Kompositions-ID
data-startJaStartzeit (Root-Komposition: verwenden Sie "0")
data-durationJaHat Vorrang vor der GSAP-Timeline-Dauer
data-width / data-heightJaPixelabmessungen (1920x1080 oder 1080x1920)
data-composition-srcNeinPfad zu einer externen HTML-Datei
data-variable-valuesNeinJSON-Objekt mit instanzspezifischen Variablenüberschreibungen auf einem Sub-Comp-Host

Auf dem Root-<html>-Element:

AttributErforderlichWerte
data-composition-variablesNeinJSON-Array deklarierter Variablen (id/type/label/default) – steuert die Studio-Bearbeitungs-UI und stellt Standardwerte für getVariables() bereit

Kompositionsstruktur

Sub-Kompositionen, die über data-composition-src geladen werden, verwenden einen <template>-Wrapper. Eigenständige Kompositionen (die main index.html) verwenden KEIN <template> – sie setzen das data-composition-id-div direkt in <body>. Die Verwendung von <template> in einer eigenständigen Datei verbirgt den gesamten Inhalt vor dem Browser und unterbricht das Rendering.

Sub-Kompositionsstruktur:

<template id="my-comp-template">
  <div data-composition-id="my-comp" data-width="1920" data-height="1080">
    <!-- Inhalt -->
    <style>
      [data-composition-id="my-comp"] {
        /* Bereichsbezogene Styles */
      }
    </style>
    <script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/gsap.min.js"></script>
    <script>
      window.__timelines = window.__timelines || {};
      const tl = gsap.timeline({ paused: true });
      // Tweens...
      window.__timelines["my-comp"] = tl;
    </script>
  </div>
</template>

In Root laden: <div id="el-1" data-composition-id="my-comp" data-composition-src="compositions/my-comp.html" data-start="0" data-duration="10" data-track-index="1"></div>

Variablen (parametrisierte Kompositionen)

Rendern Sie dieselbe Komposition mit unterschiedlichem Inhalt – Titel, Designfarbe, Preise, Untertitel – ohne das Quell-HTML zu bearbeiten.

Drei-Schritt-Muster:

  1. Deklarieren Sie Variablen auf dem <html>-Root der Komposition mit data-composition-variables. Jeder Eintrag benötigt id, type (eines von string, number, color, boolean, enum), label und default. Enum-Einträge benötigen auch options: [{value, label}, ...].
  2. Lesen Sie die aufgelösten Werte innerhalb des Skripts der Komposition mit window.__hyperframes.getVariables(). Gibt das zusammengeführte Ergebnis aus deklarierten Standardwerten + instanzspezifischen Überschreibungen + CLI-Überschreibungen zurück.
  3. Überschreiben Sie zur Renderzeit mit npx hyperframes render --variables '{...}' (oberste Ebene) oder mit data-variable-values='{...}' auf dem Host-Element (instanzspezifisch für Sub-Kompositionen).
<!doctype html>
<html
  data-composition-variables='[
  {"id":"title","type":"string","label":"Titel","default":"Hallo"},
  {"id":"theme","type":"enum","label":"Design","default":"light","options":[
    {"value":"light","label":"Hell"},
    {"value":"dark","label":"Dunkel"}
  ]}
]'
>
  <body>
    <div data-composition-id="root" data-width="1920" data-height="1080">
      <h1 id="hero" class="clip" data-start="0" data-duration="3"></h1>
      <script>
        const { title, theme } = window.__hyperframes.getVariables();
        document.getElementById("hero").textContent = title;
        document.body.dataset.theme = theme;
      </script>
    </div>
  </body>
</html>
# Dev-Vorschau verwendet deklarierte Standardwerte
npx hyperframes preview

# Mit Überschreibungen rendern
npx hyperframes render --variables '{"title":"Q4 Bericht","theme":"dark"}' --output q4.mp4

# Oder aus einer JSON-Datei
npx hyperframes render --variables-file ./vars.json

Instanzspezifische Werte für Sub-Kompositionen: Dasselbe getVariables() funktioniert innerhalb von Sub-Kompositionen, die über data-composition-src geladen werden. Jedes Host-Element übergibt seine eigenen Werte:

<div
  data-composition-id="card-pro"
  data-composition-src="compositions/card.html"
  data-variable-values='{"title":"Pro","price":"$29"}'
></div>
<div
  data-composition-id="card-enterprise"
  data-composition-src="compositions/card.html"
  data-variable-values='{"title":"Enterprise","price":"$99"}'
></div>

Übergänge

Übergänge zwischen Szenen sind Kompositionen, die auf spezielle Weise arbeiten. Eine Übergangskomposition wird zwischen zwei Clips auf derselben Spur eingeblendet und erzeugt einen visuellen Effekt.

Siehe references/transitions.md für das vollständige Schema, verfügbare Typen (Überblendungen, Wipes, Enthüllungen, Shader) und wie man eigene erstellt.

Audio

Fügen Sie Audioclips hinzu, indem Sie ein <audio>-Element mit data-start, data-duration und data-track-index einschließen. Audio-Tracks können sich nicht mit anderen Audio-Tracks auf demselben Index überlappen.

Siehe references/audio.md für Details zu mehreren Spuren, Lautstärkehüllkurven, Sidechain-Ducking und mehr.

Captions & Untertitel

Für Captions, Untertitel, Overlays und animierten Text siehe references/captions.md.

Referenzdokumente

Dev-Loop- & Asset-Befehle

Die folgenden Befehle werden von zugehörigen Skills bereitgestellt:

SkillBefehle
hyperframes-cliinit, lint, inspect, preview, render
hyperframes-mediatts, transcribe, remove-background

Verwandte Skills