media-use: Bevor Sie Audio/Quellen verwenden, rufen Sie
/media-useauf, um BGM/SFX/Bilder aus dem HeyGen-Katalog zu beziehen. Führen Sie zuerst--adoptaus, um vorhandene Assets zu registrieren. Siehe Skill/media-use.
general-video – Allgemeiner Video-Workflow
Bestätigen Sie den Pfad, bevor Sie beginnen. Dies ist der Fallback für die Erstellung benutzerdefinierter Kompositionen. Wenn die Eingabe eindeutig 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; kurze, unkommentierte Bewegtgrafik →/motion-graphics; Remotion-Portierung →/remotion-to-hyperframes. Nicht im Scope: Live-/Renderzeit-Daten, NLE-artige Bearbeitung eines fertigen Videos oder die Produktion von Filmmaterial, das HyperFrames nicht erfassen kann. Unsicher? Lesen Sie zuerst/hyperframes.
Bauen Sie genau das, was gefragt wurde. Ein Titelbild ist ein Titelbild – nicht ein Titelbild + drei unterstützende Szenen + Hintergrundmusik + Untertitel. Wenn zusätzliche Szenen oder Elemente das Stück tatsächlich verbessern würden, schlagen Sie diese vor; fügen Sie sie nicht stillschweigend hinzu. Bei kleinen Änderungen (eine Farbe korrigieren, eine Dauer anpassen, ein Element hinzufügen) überspringen Sie die Planungsschritte und gehen Sie direkt zum Bau.
Ansatz
Erkundung – nur bei vagen, offenen Anfragen
Bei vagen, explorativen Anfragen ("etwas für unsere Marke machen", "ein cooles Intro") – verstehen Sie die Absicht, bevor Sie Farben auswählen:
- Zielgruppe – wer sieht es? Entwickler / Führungskräfte / allgemeine Verbraucher?
- Plattform – wo wird es abgespielt? Social Media (15s) / Website-Hero / Produktdemo / intern?
- Priorität – worauf kommt es an? 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 ("ein Titelbild hinzufügen", "das Timing in Szene 3 korrigieren") überspringen Sie die Erkundung.
Schritt 1 – Designsystem → hyperframes-creative
Etablieren Sie zuerst die visuelle Identität. Wenn das Projekt ein Design-Spezifikationsdokument hat, lesen Sie es (Rangfolge frame.md → design.md → DESIGN.md; behandeln Sie es als Markenwahrheit – exakte Farben, Schriftarten, Einschränkungen).
Wenn kein Spezifikationsdokument 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 auswählen. house-style.md gibt die Einleitung „Interpretiere die Eingabeaufforderung / generiere echten Inhalt", die Lazy-Default-Liste und das Schichtenrezept; video-composition.md gibt die Dichte / den Maßstab des Videomediums / die Vordergrund-Detaillierung (Datenbalken, Registriermarken, monospace Metadaten, „8-10 Elemente, zwei die der Benutzer nicht angefordert hat"), die „produziert" von „generiert" unterscheidet. Nur eines zu lesen ist der häufigste Fehler – video-composition.md wird von Agenten übersprungen, und genau das verhindert flache, zentrierte, webseitenartige Ausgabe. Erfinden Sie keine eigene Palette und überspringen Sie diese nicht; der Übergang zu hyperframes-creative ist hier obligatorisch, kein optionaler Zweig. Ziehen Sie von dort aus auch einen benannten Stil / eine Stimmung → references/visual-styles.md oder den interaktiven Auswähler → references/design-picker.md bei Bedarf heran. Das Spezifikationsdokument / der Stil definiert die Marke, nicht die Kompositionsregeln.
Finden Sie den Blickwinkel (vage Anforderung, kein Spezifikationsdokument): Bevor Sie Farben auswä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 / Perimeterscan-Linien / Schlosshülsen; eine Meditations-App → Gezeiten, Atem, sanfte Lichtblüte. Lesen Sie die Bedeutung des Themas, nicht nur seine Buchstaben; wählen Sie einen konkreten Blickwinkel gegenüber einer wörtlichen Neugestaltung. Dies ist der günstige Ersatz für die Erweiterung der Eingabeaufforderung (Schritt 2) bei einszenigen Stücken, bei denen die Erweiterung korrekt übersprungen wird – und es ist der Unterschied zwischen einem durchdachten Konzept und einem generischen Logo auf einem Farbverlauf.
Schritt 2 – Eingabeaufforderung erweitern → hyperframes-creative
Führen Sie für jede mehrteilige Komposition durch (überspringen Sie für einszenige Stücke und triviale Bearbeitungen). Verankern Sie die Anfrage gegen das Design-Spezifikationsdokument + Hausstil zu einem konsistenten Zwischenprodukt, das nachgelagerte Arbeiten auf die gleiche Weise lesen. Siehe hyperframes-creative/references/prompt-expansion.md.
Schritt 3 – Planen
Bevor Sie HTML schreiben, denken Sie auf hohem Niveau:
- Was – das Betrachtererlebnis: Erzählbogen, Schlüsselmomente, emotionale Schläge.
- Struktur – wie viele Kompositionen, Unterkomposition vs. inline, welche Spuren Video / Audio / Overlays / Untertitel tragen. Für die Entscheidung monolithisch-einzelfile vs. modular-sub-comp, 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 – benennen Sie das Muster, bevor Sie es implementieren (z.B.
schnell-schnell-LANGSAM-SHADER-halten); siehehyperframes-creative/references/beat-direction.md. - Timing – welche Clips bestimmen die Dauer, wo Übergänge landen, das Tempo.
- Layout – bauen Sie zuerst den Endzustand (siehe unten).
- Animieren – fügen Sie dann Bewegung hinzu über
hyperframes-animation.
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 im animierten Startzustand positionieren (außerhalb des Bildschirms, auf 0 skaliert, Deckkraft 0) und zu dem Punkt bewegen, von dem 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 Layoutprobleme, bevor Sie Bewegung hinzufügen.
- Identifizieren Sie den Helden-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 Abständen füllen, nicht mit absoluten Offsets:
.scene-content {
display: flex;
flex-direction: column;
justify-content: center;
width: 100%;
height: 100%;
padding: 120px 160px; /* Abstände positionieren den Inhalt; füllt jede Szenengröße */
gap: 24px;
box-sizing: border-box;
}
Verwenden Sie niemals position: absolute; top: Npx auf einem Inhaltscontainer – es 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 Vorfahr eine festgelegte 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 dem Wurzelelement – siehehyperframes-core→ "Root muss dimensioniert sein"). Überspringen Sie dies und der Flex-Container kollabiert auf ~0, Inhalt türmt sich in der oberen linken Ecke auf, und das erste Glyph wird bei x=0 abgeschnitten – währendlint/inspectimmer noch 0 Probleme melden. Und behalten Sie immer denpadding(≥80px) auf.scene-contentbei: Es ist der titelsichere Rand. Ersetzen Sie ihn niemals durch bloßesgap.
- Fügen Sie Eintritte hinzu – animieren Sie VON außerhalb des Bildschirms/unsichtbar ZUR CSS-Position mit
gsap.from()(in Unterkompositionen 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 durch Übergänge behandelt – gemäß den Szenenübergangsregeln in
hyperframes-animation/transitions/animiert nur die letzte Szene Elemente heraus; zwischen den Szenen IST der Übergang der Austritt.
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 Helden-Frames – die Timeline-Reihenfolge verhindert, dass sie koexistieren, und der Layout-Schritt fängt versehentliche Überlappungen auf. Überlagerte Glühen/Schatten und z-gestaffelte Tiefe sind beabsichtigte Überlappungen; der Schritt geht darum, unbeabsichtigte Kollisionen zu fangen (zwei Überschriften übereinander, Inhalt läuft aus dem Rahmen).
Bauen – an die Bereichs-Skills delegieren
Dies bildet die gesamte Oberfläche des Skills (siehe die description) auf seine Referenzen ab – nicht erschöpfend; wenn eine Absicht nicht aufgeführt ist, leiten Sie durch hyperframes-creative (Aussehen/Konzept), hyperframes-animation (Bewegung), hyperframes-core (Vertrag), hyperframes-media (Audio/Untertitel). Die erste Zeile ist ADDITIV – lesen Sie sie UND Ihre Absichtszeile, nicht das eine oder das andere.
| Bauen... | Zuerst lesen (in der 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 geprüft; die "produziert, nicht generiert" Vordergrund-Detaillierung) |
| Kinetische Typographie / textlastig | hyperframes-animation/techniques.md (kinetischer Typ) + adapters/gsap-easing-and-stagger.md + rules/kinetic-beat-slam.md |
| Titelbild / unteres Drittel / Overlay / PiP / Text-hinter-Subjekt | hyperframes-creative/references/composition-patterns.md + (für den zentrierten/dimensionierten Frame) hyperframes-core → "Root muss dimensioniert sein" |
| 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 / musikgetrieben | hyperframes-creative/references/audio-reactive.md (Bänder vorab extrahieren; Bewegung zuordnen) |
| Kommentiert / 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. |
| Mehrere Szenen / Übergänge | hyperframes-animation/transitions/overview.md dann transitions/catalog.md (Sie sind nicht fertig nach der Übersicht – 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äß "bauen Sie genau das, was gefragt wurde" – keine Hintergrundmusik auf einem Titelbild). Bauen Sie kein TTS von Hand oder besorgen Sie eine Kopie eines Anbieters: Schreiben Sie ein neutrales audio_request.json und rufen Sie 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 + Anfrage/Meta-Schema: der Kopfkommentar von hyperframes-media/scripts/audio.mjs.
// audio_request.json — eine Zeile pro kommentiertem Segment; `id` gehört Ihnen (verknüpft audio_meta zurück)
{
"lines": [
{ "id": "s1", "text": "Ihre Eröffnungszeile.", "sfx": ["whoosh"] },
{ "id": "s2", "text": "Der nächste Schlag." },
],
"bgm": { "query": "beruhigende kinematografische Untermalung" }, // "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
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-Authoring). Wenn BGM den Generierungspfad genommen hat (bgm_pending: true), führen Sie vor dem endgültigen Rendern hyperframes-media/scripts/wait-bgm.mjs aus.