media-use: Bevor Audio/Bilder bezogen werden, rufe
/media-useauf, um BGM/SFX/Bilder aus dem HeyGen-Katalog zu holen. Führe zuerst--adoptaus, um vorhandene Assets zu registrieren. Siehe/media-useSkill.
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 zu einem spezialisierten Workflow passt, bevorzuge diesen: vermarktetes Produkt →
/product-launch-video; allgemeine Website →/website-to-video; Themen-Erklärung →/faceless-explainer; GitHub-PR →/pr-to-video; vorhandenes Filmmaterial →/embedded-captions·/talking-head-recut; kurze, unerzählte Bewegtgrafik →/motion-graphics; Remotion-Port →/remotion-to-hyperframes. Außerhalb des Rahmens: Live-/Renderzeit-Daten, NLE-artige Bearbeitung eines fertigen Videos oder die Produktion von Filmmaterial, das HyperFrames nicht aufnehmen kann. Unsicher? Lies zuerst/hyperframes.
Baue genau das, was gefragt wurde. Eine Titelcard ist eine Titelcard – nicht eine Titelcard + drei unterstützende Szenen + Hintergrundmusik + Untertitel. Wenn zusätzliche Szenen oder Elemente das Stück wirklich verbessern würden, schlage sie vor; füge sie nicht stillschweigend hinzu. Bei kleinen Änderungen (Farbe korrigieren, eine Dauer anpassen, ein Element hinzufügen) überspringe die Planungsschritte und gehe direkt zum Bau.
Vorgehensweise
Entdeckung – nur bei vagen Anfragen
Bei vagen, explorativen Anfragen („Mach etwas für unsere Marke“, „Ein cooler Intro“) – verstehe die Absicht, bevor du Farben wählst:
- Zielgruppe – wer sieht zu? Entwickler / Führungskräfte / allgemeine Verbraucher?
- Plattform – wo wird es abgespielt? Soziales (15s) / Website-Hero / Produktdemo / intern?
- Priorität – was ist am wichtigsten? Bewegungsqualität / Inhaltsgenauigkeit / Markentreue / Geschwindigkeit?
- Varianten – ein bester Versuch oder 2-3 bedeutungsvoll unterschiedliche Optionen (unterschiedliches Tempo, Energie oder Struktur – nicht nur Farbwechsel)?
Bei spezifischen Anfragen („Füge eine Titelcard hinzu“, „Korrigiere das Timing in Szene 3“) überspringe die Entdeckung.
Schritt 1 – Designsystem → hyperframes-creative
Lege zuerst die visuelle Identität fest. Wenn das Projekt eine Design-Spezifikation hat, lies sie (Rangfolge frame.md → design.md → DESIGN.md; behandle sie als Markenwahrheit – exakte Farben, Schriften, 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 Schrift wählst. house-style.md liefert den Opener „Interpretiere den Prompt / generiere echten Inhalt“, die Lazy-Default-Liste und das Layer-Rezept; video-composition.md liefert die Dichte / den Maßstab des Videomediums / die Vordergrund-Detaillierung (Datenbalken, Registrierungsmarken, Monospace-Metadaten, „8-10 Elemente, zwei die der Nutzer nicht verlangt hat“), die „produziert“ von „generiert“ trennt. Nur eines zu lesen ist der häufigste Fehler – video-composition.md wird von Agenten ausgelassen, und genau das verhindert flache, zentrierte, webseitenartige Ausgaben. Erfinde keine eigene Palette und überspringe diese nicht; der Übergang in hyperframes-creative ist hier obligatorisch, kein optionaler Zweig. Von dort aus ziehe auch einen benannten Stil/Stimmung → references/visual-styles.md oder den interaktiven Wähler → references/design-picker.md, falls nötig. 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/dieses Thema hervor, und welche visuelle Welt (Metapher, Umgebung, Instrument, Motiv) drückt es aus? Z. B. ein Cybersicherheitstool → Tresortüren / Perimeterscan-Linien / Schlosswalzen; eine Meditations-App → Gezeiten, Atem, langsamer Lichtschein. Lies die Bedeutung des Themas, nicht nur seine Buchstaben; wähle einen konkreten Blickwinkel statt einer wörtlichen Neugestaltung. Dies ist der billige Ersatz für die Prompt-Erweiterung (Schritt 2) bei einszenigen Stücken, bei denen die Erweiterung korrekterweise übersprungen wird – und dies ist der Unterschied zwischen einem gestalteten Konzept und einem generischen Logo auf einem Farbverlauf.
Schritt 2 – Prompt-Erweiterung → hyperframes-creative
Führe für jede mehrteilige Komposition aus (überspringe für einszenige Stücke und triviale Bearbeitungen). Verankere die Anfrage anhand der Design-Spezifikation + Hausstil in einem konsistenten Zwischenergebnis, das nachgelagerte Arbeit auf die gleiche Weise liest. Siehe hyperframes-creative/references/prompt-expansion.md.
Schritt 3 – Plan
Bevor du HTML schreibst, denke auf hohem Niveau:
- Was – das Zuschauererlebnis: Erzählbogen, Schlüsselmomente, emotionale Schläge.
- Struktur – wie viele Kompositionen, Sub-Comp vs. Inline, welche Spuren tragen Video / Audio / Overlays / Untertitel. Für die Entscheidung monolithische Einzeldatei vs. modularer Sub-Comp siehe
hyperframes-core/references/composition-patterns.md§ Zwei Architekturen (Faustregel: ≥3 harte Szenenschnitte oder jede wiederverwendete Szene → modularisieren; ein kurzes einszeniges Stück bleibt eine Datei). - Rhythmus – benenne das Muster, bevor du 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 das zuerst als statisches HTML + CSS. Noch kein GSAP.
Warum: Wenn du Elemente in ihrem animierten Startzustand positionierst (außerhalb des Bildschirms, skaliert auf 0, Deckkraft 0) und zu der Stelle überblendest, von der 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 Layout-Probleme, bevor du Bewegung hinzufügst.
- Identifiziere den Helden-Frame 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 Versätzen:
.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 – es läuft über, wenn der Inhalt höher ist als der Platz. Behalte die absolute Positionierung für dekorative Elemente vor.
⚠ Das obige
width/height: 100%funktioniert nur, wenn jeder Vorfahre eine aufgelöste Höhe hat. Das Wurzel-<div data-composition-id>und jeder Wrapper zwischen ihm und.scene-contentmüssen dimensioniert sein (position: relative; width: 1920px; height: 1080pxauf der Wurzel – siehehyperframes-core→ „Root muss dimensioniert sein“). Überspringe dies und der Flex-Container kollabiert auf ~0, der Inhalt stapelt sich in der oberen linken Ecke, und der erste Buchstabe schneidet bei x=0 ab – währendlint/inspectimmer noch 0 Probleme melden. Und behalte immer denpadding(≥80px) auf.scene-content: Es ist der titelsichere Rand. Ersetze ihn niemals durch bloßengap.
- Füge Eintritte hinzu – animiere VON außerhalb des Bildschirms/unsichtbar ZUR CSS-Position mit
gsap.from()(in Sub-Kompositionen bevorzugegsap.fromTo(), damit der Startzustand explizit ist; siehehyperframes-core/references/sub-compositions.md). Die CSS-Position ist die Grundwahrheit; die Überblendung ist die Reise dorthin. - Austritte werden übergangsbehandelt – gemäß den Szenenübergangsregeln in
hyperframes-animation/transitions/animiert nur die letzte Szene Elemente hinaus; zwischen den Szenen IST der Übergang der Austritt.
Geteilter Raum über die Zeit: Wenn Element A austritt, bevor Element B im selben Bereich eintritt, brauchen beide dennoch korrekte CSS-Positionen für ihre jeweiligen Helden-Frames – die Timeline-Reihenfolge verhindert ihr gleichzeitiges Bestehen, und der Layout-Schritt fängt versehentliche Überlappungen. Geschichtete Leuchteffekte/Schatten und z-gestaffelte Tiefe sind beabsichtigte Überlappungen; der Schritt geht darum, unbeabsichtigte Kollisionen zu fangen (zwei Schlagzeilen übereinander, Inhalt läuft vom Rahmen).
Bauen – delegiere an die Domänen-Skills
Dies bildet die vollständige Oberfläche des Skills (siehe die description) auf seine Referenzen ab – nicht erschöpfend; 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 der 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 / HARD-GATE überprüft; die „produzierte, nicht generierte“ Vordergrund-Detaillierung) |
| Kinetische Typografie / Text-lastig | hyperframes-animation/techniques.md (kinetischer Typ) + adapters/gsap-easing-and-stagger.md + rules/kinetic-beat-slam.md |
| Titelcard / unteres Drittel / Overlay / PiP / Text-hinter-Subjekt | hyperframes-creative/references/composition-patterns.md + (für den zentrierten/dimensionierten Rahmen) hyperframes-core → „Root muss dimensioniert sein“ |
| Logo / Marken-Enthüllung | hyperframes-animation/rules/svg-path-draw.md (Draw-On) + 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 / Musik-getrieben | hyperframes-creative/references/audio-reactive.md (vorab Bänder extrahieren; Bewegung zuordnen) |
| Erzählt / Voiceover / Musik / SFX / Untertitel | hyperframes-media → die gemeinsame Audio-Engine scripts/audio.mjs (ein Aufruf = TTS + BGM + SFX → audio_meta.json); Untertitelerstellung + Asset-Platzierung über hyperframes-core. Siehe Audio unten. |
| Mehrere Szenen / Übergänge | hyperframes-animation/transitions/overview.md dann transitions/catalog.md (du bist nicht fertig nach dem Überblick – das GSAP-Rezept steht im Katalog) |
| Modular / Sub-Kompositionen | 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 gefragt wurde“ – keine Hintergrundmusik auf einer Titelcard). Baue kein TTS von Hand und erstelle keine Kopie eines Anbieters: Schreibe ein neutrales audio_request.json und rufe die gemeinsame Engine in hyperframes-media auf. Sie degradiert automatisch bei einem Schalter – HeyGen-Anmeldeinformationen 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 + Request/Meta-Schema: der Header-Kommentar von hyperframes-media/scripts/audio.mjs.
// audio_request.json – eine Zeile pro erzähltem Segment; `id` ist deine (verbindet audio_meta zurück)
{
"lines": [
{ "id": "s1", "text": "Deine Eröffnungszeile.", "sfx": ["whoosh"] },
{ "id": "s2", "text": "Der nächste Beat." },
],
"bgm": { "query": "ruhige cineastische Untermalung" }, // „mode“ weglassen → automatisch (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 lies audio_meta.json: hänge jeden voices[].path + (bgm.path, sfx[]) als <audio>-Spuren ein und verwende voices[].words für Untertitel, alles gemäß hyperframes-core (Audiospuren + Untertitelerstellung). Wenn BGM den Generierungspfad genommen hat (bgm_pending: true), führe vor dem endgültigen Rendern hyperframes-media/scripts/wait-bgm.mjs aus.