media-use: Bevor Sie Audio/Bilder beziehen, rufen Sie
/media-useauf, um BGM/SFX/Bilder aus dem HeyGen-Katalog zu laden. Führen Sie zuerst--adoptaus, um vorhandene Assets zu registrieren. Siehe Skill/media-use.
general-video – allgemeiner Video-Workflow
Bestätigen Sie den Weg, bevor Sie bauen. Dies ist der Fallback für die Erstellung benutzerdefinierter Kompositionen. Wenn die Eingabe klar zu einem spezialisierten Workflow passt, bevorzugen Sie 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; kurzer, unerzählter Motion Graphic →/motion-graphics; Remotion-Portierung →/remotion-to-hyperframes. Nicht im Fokus: Live-Daten zur Renderzeit, NLE-ähnliche Bearbeitung eines fertigen Videos oder die Produktion von Filmmaterial, das HyperFrames nicht aufnehmen kann. Unsicher? Lesen Sie zuerst/hyperframes.
Bauen Sie 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 den Beitrag tatsächlich verbessern würden, schlagen Sie sie vor; fügen Sie sie nicht stillschweigend hinzu. Bei kleinen Bearbeitungen (Farbe korrigieren, eine Dauer anpassen, ein Element hinzufügen) überspringen Sie die Planungsschritte und gehen Sie direkt zum Bau.
Ansatz
Entdeckung – nur bei offenen Anfragen
Bei vagen, explorativen Anfragen ("etwas für unsere Marke machen", "ein cooler Intro") – verstehen Sie die Absicht, bevor Sie Farben wählen:
- Zielgruppe – wer schaut zu? Entwickler / Führungskräfte / allgemeine Verbraucher?
- Plattform – wo wird es abgespielt? Social (15s) / Website-Hero / Produkt-Demo / intern?
- Priorität – was ist am wichtigsten? Bewegungsqualität / Inhaltsgenauigkeit / Markentreue / Geschwindigkeit?
- Varianten – eine beste Aufnahme oder 2-3 sinnvoll unterschiedliche Optionen (unterschiedliches Tempo, Energie oder Struktur – nicht nur Farbwechsel)?
Bei spezifischen Anfragen ("eine Titelcard hinzufügen", "das Timing von Szene 3 korrigieren") überspringen Sie die Entdeckung.
Schritt 1 – Designsystem → hyperframes-creative
Legen Sie zuerst die visuelle Identität fest. Wenn das Projekt eine Design-Spezifikation hat, lesen Sie sie (Priorität frame.md → design.md → DESIGN.md; behandeln Sie sie als Markenwahrheit – exakte Farben, Schriftarten, Einschränkungen).
Wenn keine Spezifikation existiert, MÜSSEN Sie SOWOHL hyperframes-creative/references/house-style.md ALS AUCH hyperframes-creative/references/video-composition.md lesen, bevor Sie eine Farbe oder Schriftart wählen. house-style.md liefert den "Interpretiere den Prompt / generiere echten Inhalt"-Einstieg, die Lazy-Default-Liste und das Schichtenrezept; video-composition.md liefert die Video-Medium-Dichte / Skalierung / Vordergrund-Detaillierung (Datenbalken, Registriermarken, Monospace-Metadaten, "8-10 Elemente, von denen zwei der Benutzer nicht verlangt hat"), die "produziert" von "generiert" trennt. Nur eines zu lesen ist der häufigste Fehler – video-composition.md wird von Agenten oft übersprungen, und genau das verhindert flache, zentrierte, wie eine Webseite aussehende Ausgaben. Erfinden Sie keine eigene Palette und überspringen Sie diese nicht; der Übergang in hyperframes-creative ist hier obligatorisch, kein optionaler Zweig. Ziehen Sie von dort bei Bedarf auch einen benannten Stil/eine Stimmung → references/visual-styles.md oder den interaktiven Picker → references/design-picker.md. Die Spezifikation/der Stil definiert die Marke, nicht die Kompositionsregeln.
Finden Sie den Blickwinkel (vage Vorgabe, keine Spezifikation): Bevor Sie Farben wählen, schreiben Sie 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 / Perimeter-Scanlinien / Schlosszuhaltungen; eine Meditations-App → Gezeiten, Atem, langsames Lichtblühen. Lesen Sie die Bedeutung des Themas, nicht nur seine Buchstaben; wählen Sie einen konkreten Blickwinkel statt einer wörtlichen Neugestaltung. Dies ist der günstige Ersatz für die Prompt-Erweiterung (Schritt 2) bei Ein-Szenen-Stücken, bei denen die Erweiterung zu Recht ü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ühren Sie für jede mehrszenige Komposition durch (überspringen Sie für Ein-Szenen-Stücke und triviale Bearbeitungen). Verankern Sie die Anfrage anhand der Design-Spezifikation + des House-Stils in einem konsistenten Zwischenformat, das nachgelagerte Arbeiten einheitlich liest. Siehe hyperframes-creative/references/prompt-expansion.md.
Schritt 3 – Plan
Denken Sie auf hoher Ebene nach, bevor Sie HTML schreiben:
- Was – das Betrachtererlebnis: narrativer Bogen, Schlüsselmomente, emotionale Beats.
- 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§ Two Architectures (Faustregel: ≥3 harte Szenenschnitte oder jede wiederverwendete Szene → modularisieren; ein kurzes Ein-Szenen-Stück bleibt eine Datei). - Rhythmus – benennen Sie das Muster, bevor Sie es implementieren (z. B.
schnell-schnell-LANGSAM-SHADER-halten); siehehyperframes-creative/references/beat-direction.md. - Timing – welche Clips treiben die Dauer, wo liegen die Übergänge, das Tempo.
- Layout – bauen Sie zuerst den Endzustand (siehe unten).
- Animieren – fügen Sie dann Bewegung via
hyperframes-animationhinzu.
Layout vor Animation
Positionieren Sie jedes Element dort, wo es sich in seinem sichtbarsten Moment befindet – vollständig eingetreten, korrekt platziert, noch nicht austretend. Schreiben Sie das zuerst als statisches HTML + CSS. Noch kein GSAP.
Warum: Wenn Sie Elemente in ihrem animierten Startzustand positionieren (außerhalb des Bildschirms, auf 0 skaliert, Deckkraft 0) und dann zu der Stelle tweenen, von der Sie denken, dass sie landen, raten Sie das endgültige Layout – Überlappungen bleiben bis zum Rendern unsichtbar. Bauen Sie zuerst den Endzustand, und Sie sehen und beheben Layout-Probleme, bevor Sie Bewegung hinzufügen.
- Identifizieren Sie den Hero-Frame für jede Szene – den Moment, in dem die meisten Elemente gleichzeitig sichtbar sind. Das ist das Layout, das Sie bauen.
- Schreiben Sie statisches CSS für diesen Frame. Der Inhaltscontainer muss die Szene mit Innenabstand füllen, nicht mit absoluten Offsets:
.scene-content {
display: flex;
flex-direction: column;
justify-content: center;
width: 100%;
height: 100%;
padding: 120px 160px; /* padding positioniert Inhalt; füllt jede Szenengröße */
gap: 24px;
box-sizing: border-box;
}
Verwenden Sie niemals position: absolute; top: Npx auf einem Inhaltscontainer – er läuft über, wenn der Inhalt höher als der Platz ist. Reservieren Sie absolute Positionierung für dekorative Elemente.
⚠ Das obige
width/height: 100%funktioniert nur, wenn jeder Vorfahre eine aufgelöste Höhe hat. Das root<div data-composition-id>und alle Wrapper zwischen ihm und.scene-contentmüssen dimensioniert sein (position: relative; width: 1920px; height: 1080pxauf dem root – siehehyperframes-core→ "Root must be sized"). Überspringen Sie dies, und der Flex-Container kollabiert auf ~0, Inhalt stapelt sich in der oberen linken Ecke, und der erste Buchstabe wird bei x=0 abgeschnitten – währendlint/inspectimmer noch 0 Probleme melden. Und behalten Sie immer daspadding(≥80px) auf.scene-content: es ist der Title-Safe-Rand. Ersetzen Sie es niemals durch bloßesgap.
- Fügen Sie Eintritte hinzu – animieren Sie VON außerhalb des Bildschirms/unsichtbar ZUR CSS-Position mit
gsap.from()(in Sub-Kompositionen bevorzugen Siegsap.fromTo(), damit der Startzustand explizit ist; siehehyperframes-core/references/sub-compositions.md). Die CSS-Position ist die Grundwahrheit; der Tween ist die Reise dorthin. - Austritte werden übergangsweise behandelt – gemäß den Szenenübergangsregeln in
hyperframes-animation/transitions/animiert nur die letzte Szene Elemente aus; zwischen den Szenen IST der Übergang der Austritt.
Gemeinsamer 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 Hero-Frames – die Timeline-Reihenfolge verhindert ihr gleichzeitiges Bestehen, und der Layout-Schritt fängt versehentliche Überlappungen auf. Geschichtete Glühen/Schatten und z-gestaffelte Tiefe sind beabsichtigte Überlappungen; der Schritt geht es darum, unbeabsichtigte Kollisionen zu erkennen (zwei Überschriften übereinander, Inhalt, der vom Bildschirmrand läuft).
Bauen – an die Domain-Skills delegieren
Dies bildet die vollständige Oberfläche des Skills (siehe description) auf seine Referenzen ab – nicht erschöpfend; wenn eine Absicht nicht aufgeführt ist, leiten Sie sie über hyperframes-creative (Aussehen/Konzept), hyperframes-animation (Bewegung), hyperframes-core (Vertrag), hyperframes-media (Audio/Untertitel) weiter. Die erste Zeile ist ADDITIV – lesen Sie sie UND Ihre Absichtszeile, nicht eine oder die andere.
| Bauen… | Zuerst lesen (in Reihenfolge) |
|---|---|
| IMMER – jedes nicht-triviale Stück, zusätzlich zu Ihrer Absichtszeile unten | hyperframes-creative/references/house-style.md + references/video-composition.md (auch in Schritt 1 / HARD-GATE 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 / Lower-Third / Overlay / PiP / Text-hinter-Subjekt | hyperframes-creative/references/composition-patterns.md + (für den zentrierten/dimensionierten Frame) hyperframes-core → "Root must be sized" |
| Logo / Markenzeichen-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 / musikgesteuert | hyperframes-creative/references/audio-reactive.md (Bänder vorab extrahieren; auf Bewegung abbilden) |
| Erzählt / Voiceover / Musik / SFX / Untertitel | hyperframes-media → die gemeinsame Audio-Engine scripts/audio.mjs (ein Aufruf = TTS + BGM + SFX → audio_meta.json); Untertitel-Erstellung + Asset-Platzierung via hyperframes-core. Siehe Audio unten. |
| Mehrere Szenen / Übergänge | hyperframes-animation/transitions/overview.md dann transitions/catalog.md (nach der Übersicht sind Sie nicht fertig – das GSAP-Rezept befindet sich 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äß "Bauen Sie genau das, was gefragt wurde" – keine Hintergrundmusik auf einer Titelcard). Bauen Sie kein TTS selbst oder beschaffen Sie eine Kopie: Schreiben Sie ein neutrales audio_request.json und rufen Sie die gemeinsame Engine in hyperframes-media auf. Sie degradiert automatisch per Schalter – HeyGen-Anmeldedaten vorhanden → HeyGen TTS + Musik/SFX Abruf; abwesend → ElevenLabs/Kokoro TTS, Lyria/MusicGen BGM Generierung und die gebündelte SFX-Bibliothek. Vollständige Flag-Liste + Anfrage/Meta-Schema: der Header-Kommentar von hyperframes-media/scripts/audio.mjs.
// audio_request.json — eine Zeile pro erzähltem Segment; `id` ist Ihre (verbindet audio_meta zurück)
{
"lines": [
{ "id": "s1", "text": "Ihr Eröffnungssatz.", "sfx": ["whoosh"] },
{ "id": "s2", "text": "Der nächste 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 (neben diesem Skill)
knoten <MEDIA_DIR>/scripts/audio.mjs --request ./audio_request.json --hyperframes . --out ./audio_meta.json
Lesen Sie dann audio_meta.json: mounten Sie jeden voices[].path + (bgm.path, sfx[]) als <audio>-Spuren und verwenden Sie voices[].words für Untertitel, alles gemäß hyperframes-core (Audiospuren + Untertitel-Erstellung). Wenn BGM den Generierungspfad genommen hat (bgm_pending: true), führen Sie vor dem endgültigen Rendern hyperframes-media/scripts/wait-bgm.mjs aus.
Ausgabe-Checkliste → hyperframes-cli
…
[gekürzt zur Übersetzung]