Mediennutzung: Vor dem Laden von Audio/Bildern
/media-useaufrufen, um BGM/SFX/Bilder aus dem HeyGen-Katalog zu beziehen. Führe--adoptaus, um vorhandene Assets zu registrieren. Siehe Skill/media-use.
general-video – Allgemeiner Video-Workflow
Bestätige den Weg, bevor du baust. Dies ist der Fallback für die Erstellung benutzerdefinierter Kompositionen. Wenn die Eingabe eindeutig in einen spezialisierten Workflow passt, verwende diesen: Vermarktetes Produkt →
/product-launch-video; allgemeine Website →/website-to-video; Themen-Erklärvideo →/faceless-explainer; GitHub-PR →/pr-to-video; vorhandenes Material →/embedded-captions·/talking-head-recut; kurze, unkommentierte Bewegungsgrafik →/motion-graphics; Remotion-Port →/remotion-to-hyperframes. Nicht im Scope: Live-Daten zur Renderzeit, NLE-artige Bearbeitung eines fertigen Videos, oder Produktion von Material, das HyperFrames nicht aufnehmen kann. Unsicher? Lies zuerst/hyperframes.
Baue genau das, was verlangt wurde. Eine Titelcard ist eine Titelcard – nicht eine Titelcard + drei unterstützende Szenen + Ambient-Musik + Untertitel. Wenn zusätzliche Szenen oder Elemente das Stück tatsächlich verbessern würden, schlage sie vor; füge sie nicht stillschweigend hinzu. Für kleine Änderungen (eine Farbe korrigieren, eine Dauer anpassen, ein Element hinzufügen) überspringe die Planungsschritte und gehe direkt zum Bau.
Vorgehen
Discovery – nur für offene Anfragen
Bei vagen, explorativen Anfragen ("Mach etwas für unsere Marke", "Ein cooler Intro") – verstehe die Absicht, bevor du Farben wählst:
- Zielgruppe – Wer schaut zu? 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?
- Varianten – Ein bester Versuch oder 2-3 sinnvoll unterschiedliche Optionen (unterschiedliches Tempo, Energie oder Struktur – nicht nur Farbänderungen)?
Bei spezifischen Anfragen ("Füge eine Titelcard hinzu", "Korrigiere das Timing in Szene 3") überspringe die Discovery.
Schritt 1 – Designsystem → hyperframes-creative
Etabliere zuerst die visuelle Identität. Wenn das Projekt eine Design-Spezifikation hat, lese sie (Priorität frame.md → design.md → DESIGN.md; behandle sie als Markenwahrheit – exakte Farben, Schriftarten, Einschränkungen).
Wenn keine Spezifikation existiert, MUSST du SOWOHL hyperframes-creative/references/house-style.md ALS AUCH hyperframes-creative/references/video-composition.md lesen, bevor du eine Farbe oder Schriftart wählst. house-style.md gibt den Aufmacher "Interpretiere den Prompt / generiere echten Inhalt", die Lazy-Default-Liste und das Schichtenrezept; video-composition.md gibt die Video-Medium-Dichte / den Maßstab / die Vordergrund-Detaillierung (Datenbalken, Registriermarken, Monospace-Metadaten, "8-10 Elemente, zwei, die der Benutzer nicht verlangt hat"), die "produziert" von "generiert" unterscheidet. Nur eines zu lesen ist der häufigste Fehler – video-composition.md wird von Agenten am meisten übersprungen, und genau das verhindert flache, zentrierte, webseitenartige Ausgaben. Erfinde keine eigene Palette und überspringe diese; der Schritt in hyperframes-creative ist hier obligatorisch, kein optionaler Zweig. Von dort aus ziehe bei Bedarf auch einen benannten Stil/Stimmung → references/visual-styles.md, oder den interaktiven Picker → references/design-picker.md. Die Spezifikation/der Stil definiert die Marke, nicht die Kompositionsregeln.
Finde den Blickwinkel (vage Vorgabe, keine Spezifikation): Bevor du Farben wählst, schreibe EINEN Satz – was ruft dieser Name/dieses Wort/Thema hervor, und welche visuelle Welt (Metapher, Setting, Instrument, Motiv) drückt es aus? Z.B. ein Cybersicherheitstool → Tresortüren / Perimeterscanlinien / Schlossfallen; eine Meditations-App → Gezeiten, Atem, sanfte Lichtblüte. Lies die Bedeutung des Themas, nicht nur seine Buchstaben; wähle einen konkreten Blickwinkel über eine wörtliche Neugestaltung. Dies ist der günstige Ersatz für die Prompt-Erweiterung (Schritt 2) bei Einszenenstücken, bei denen die Erweiterung korrekterweise übersprungen wird – und es ist der Unterschied zwischen einem durchdachten Konzept und einem generischen Logo auf einem Farbverlauf.
Schritt 2 – Prompt-Erweiterung → hyperframes-creative
Führe dies für jede mehrszenige Komposition aus (überspringe für einszenige Stücke und triviale Bearbeitungen). Bette die Anfrage gegen die Design-Spezifikation + den Hausstil in ein konsistentes Zwischenformat ein, das nachgelagerte Arbeiten auf die gleiche Weise lesen. Siehe hyperframes-creative/references/prompt-expansion.md.
Schritt 3 – Plan
Denke auf hoher Ebene nach, bevor du HTML schreibst:
- Was – das Zuschauererlebnis: narrativer Bogen, Schlüsselmomente, emotionale Schläge.
- Struktur – wie viele Kompositionen, Unterkomposition vs. Inline, welche Spuren tragen Video / Audio / Overlays / Untertitel. Für die Entscheidung monolithische Einzeldatei vs. modulare Unterkomposition siehe
hyperframes-core/references/composition-patterns.md§ Zwei Architekturen (Faustregel: ≥3 harte Szenenschnitte oder eine wiederverwendete Szene → modularisieren; ein kurzes einszeniges Stück bleibt eine Datei). - Rhythmus – benenne das Muster, bevor du es implementierst (z.B.
schnell-schnell-LANGSAM-SHADER-halten); siehehyperframes-creative/references/beat-direction.md. - Timing – welche Clips treiben die Dauer, wo landen Übergänge, das Tempo.
- Layout – baue zuerst den Endzustand (siehe unten).
- Animieren – füge dann Bewegung über
hyperframes-animationhinzu.
Layout vor Animation
Positioniere jedes Element dort, wo es in seinem sichtbarsten Moment sitzt – vollständig eingetreten, korrekt platziert, noch nicht austretend. Schreibe dies zuerst als statisches HTML + CSS. Noch kein GSAP.
Warum: Wenn du Elemente in ihrem animierten Startzustand positionierst (außerhalb des Bildschirms, auf 0 skaliert, Deckkraft 0) und dorthin tweenst, wo du denkst, dass sie landen, errätst du das endgültige Layout – Überlappungen bleiben bis zum Rendern unsichtbar. Baue zuerst den Endzustand, und du siehst und behebst Layoutprobleme, bevor du Bewegung hinzufügst.
- Identifiziere den Heldenframe für jede Szene – den Moment, in dem die meisten Elemente gleichzeitig sichtbar sind. Das ist das Layout, das du baust.
- Schreibe statisches CSS für diesen Frame. Der Inhaltscontainer muss die Szene mit Abstand füllen, nicht mit absoluten Offsets:
.scene-content {
display: flex;
flex-direction: column;
justify-content: center;
width: 100%;
height: 100%;
padding: 120px 160px; /* Abstand positioniert den Inhalt; füllt jede Szenengröße */
gap: 24px;
box-sizing: border-box;
}
Verwende niemals position: absolute; top: Npx auf einem Inhaltscontainer – er läuft über, wenn der Inhalt höher als der Platz ist. Reserviere absolute Positionierung für Dekorationen.
⚠ Das
width/height: 100%oben funktioniert nur, wenn jeder Vorfahre eine aufgelöste Höhe hat. Der Root<div data-composition-id>und jeder Wrapper zwischen ihm und.scene-contentmüssen dimensioniert sein (position: relative; width: 1920px; height: 1080pxauf dem Root – siehehyperframes-core→ "Root muss dimensioniert sein"). Überspringe dies, und der Flex-Container kollabiert auf ~0, Inhalt stapelt sich in der linken oberen Ecke, und das erste Zeichen wird bei x=0 abgeschnitten – währendlint/inspectweiterhin 0 Probleme melden. Und behalte immer denpadding(≥80px) auf.scene-content: Es ist der titelsichere Rand. Ersetze ihn niemals durch bloßesgap.
- Füge Auftritte hinzu – animiere VON außerhalb des Bildschirms/unsichtbar ZUR CSS-Position mit
gsap.from()(in Unterkompositionen bevorzugegsap.fromTo(), damit der Startzustand explizit ist; siehehyperframes-core/references/sub-compositions.md). Die CSS-Position ist die Grundwahrheit; der Tween ist die Reise dorthin. - Ausgänge werden durch Übergänge behandelt – gemäß den Szenenübergangsregeln in
hyperframes-animation/transitions/animiert nur die letzte Szene Elemente aus; zwischen den Szenen IST der Übergang der Ausgang.
Geteilter Raum über die Zeit: Wenn Element A austritt, bevor Element B im selben Bereich eintritt, benötigen beide dennoch korrekte CSS-Positionen für ihre jeweiligen Heldenframes – die Timeline-Reihenfolge verhindert ihr gleichzeitiges Vorhandensein, und der Layout-Schritt fängt versehentliche Überlappungen auf. Geschichtete Glühen/Schatten und Z-Stack-Tiefe sind beabsichtigte Überlappungen; der Schritt dient zum Auffangen unbeabsichtigter Kollisionen (zwei Überschriften übereinander, Inhalt, der aus dem Rahmen läuft).
Bau – Delegiere an die Domänen-Skills
Dies bildet die gesamte Oberfläche des Skills (siehe description) auf seine Referenzen ab – nicht abschließend; wenn eine Absicht nicht aufgeführt ist, leite sie durch hyperframes-creative (Look/Konzept), hyperframes-animation (Bewegung), hyperframes-core (Vertrag), hyperframes-media (Audio/Untertitel). Die erste Zeile ist ADDITIV – lies sie UND deine Absichtszeile, nicht das eine oder das andere.
| Bauen… | Lies zuerst (in Reihenfolge) |
|---|---|
| IMMER – jedes nicht-triviale Stück, zusätzlich zu deiner Absichtszeile unten | hyperframes-creative/references/house-style.md + references/video-composition.md (auch in Schritt 1 / HARDES-TOR abgesichert; die "produziert, nicht generiert"-Vordergrund-Detaillierung) |
| Kinetische Typografie / Textlastig | hyperframes-animation/techniques.md (kinetischer Typ) + adapters/gsap-easing-and-stagger.md + rules/kinetic-beat-slam.md |
| Titelcard / Einblendung / Overlay / PiP / Text-hinter-Subjekt | hyperframes-creative/references/composition-patterns.md + (für den zentrierten/skalierten Rahmen) hyperframes-core → "Root muss dimensioniert sein" |
| Logo / Marken-Enthüllung | hyperframes-animation/rules/svg-path-draw.md (einzeichnen) + rules/3d-text-depth-layers.md + rules/scale-swap-transition.md |
| Daten / Statistiken / Zahlen | hyperframes-animation/rules/counting-dynamic-scale.md + rules/stat-bars-and-fills.md + hyperframes-creative/references/data-in-motion.md |
| Produkt / App / UI-Demo | hyperframes-animation/rules/3d-page-scroll.md + rules/cursor-click-ripple.md + rules/press-release-spring.md |
| Audio-reaktiv / Musikgetrieben | hyperframes-creative/references/audio-reactive.md (Bänder vorher extrahieren; auf Bewegung abbilden) |
| Erzählerkommentar / Voiceover / Musik / SFX / Untertitel | hyperframes-media → die gemeinsame Audio-Engine scripts/audio.mjs (ein Aufruf = TTS + BGM + SFX → audio_meta.json); Untertitel-Authoring + Asset-Platzierung über hyperframes-core. Siehe Audio unten. |
| Mehrszenig / Übergänge | hyperframes-animation/transitions/overview.md dann transitions/catalog.md (du bist nach dem Überblick nicht fertig – das GSAP-Rezept ist im Katalog) |
| Modular / Unterkompositionen | hyperframes-core/references/composition-patterns.md + references/sub-compositions.md |
Audio: eine Engine (TTS · BGM · SFX)
Nur wenn das Stück es erfordert (gemäß "baue genau das, was verlangt wurde" – keine Ambient-Musik auf einer Titelcard). Baue kein eigenes TTS oder beziehe eine Kopie von einem Anbieter: Schreibe ein neutrales audio_request.json und rufe die gemeinsame Engine in hyperframes-media auf. Sie degradiert automatisch bei einem Schalter – HeyGen-Anmeldedaten vorhanden → HeyGen TTS + Musik/SFX Abruf; nicht vorhanden → ElevenLabs/Kokoro TTS, Lyria/MusicGen BGM Generierung und die gebündelte SFX-Bibliothek. Vollständige Flag-Liste + Anforderungs-/Meta-Schema: der Kopfkommentar von hyperframes-media/scripts/audio.mjs.
// audio_request.json – eine Zeile pro erzähltem Segment; `id` ist deine (verknüpft audio_meta zurück)
{
"lines": [
{ "id": "s1", "text": "Your opening line.", "sfx": ["whoosh"] },
{ "id": "s2", "text": "The next beat." },
],
"bgm": { "query": "calm cinematic underscore" }, // "mode" weglassen → auto (abrufen, wenn HeyGen, sonst generieren); "none" zum Deaktivieren
}
# <MEDIA_DIR> = das installierte hyperframes-media-Skill-Verzeichnis (Geschwister dieses Skills)
node <MEDIA_DIR>/scripts/audio.mjs --request ./audio_request.json --hyperframes . --out ./audio_meta.json
Dann lese audio_meta.json: Binde jeden voices[].path + (bgm.path, sfx[]) als <audio>-Spuren ein und verwende voices[].words für Untertitel, alles gemäß hyperframes-core (Audiospuren + Untertitel-Authoring). Wenn BGM den Generierungspfad genommen hat (bgm_pending: true), führe vor dem endgültigen Rendern hyperframes-media/scripts/wait-bgm.mjs aus.
Ausgabe-Checkliste → hyperframes-cli
- …
[truncated for translation]