Communitygithub.com

assafkip/claude-video-editor

Erstelle Videokompositionen, Animationen, Titel, Overlays, Untertitel, Voiceovers, audio-reaktive Visuals und Szenenübergänge in HyperFrames HTML.

Was ist claude-video-editor?

Dieses Skill ermöglicht die vollständige Videoproduktion mit HyperFrames, bei dem HTML als zentrale Wahrheitsquelle für Video dient. Es unterstützt die Erstellung von Kompositionen mit `data-*`-Attributen für Timing, GSAP-Timelines für Animationen und CSS für das Erscheinungsbild. Besonderes Augenmerk liegt auf der Trennung von Layout und Animation: Zuerst wird der Endzustand als statisches HTML+CSS definiert, dann werden Bewegungen mit `gsap.from()` und `gsap.to()` hinzugefügt. Dadurch werden unbeabsichtigte Überlagerungen vermieden. Das Skill deckt die gesamte Workflow-Pipeline ab: von der visuellen Identität (via DESIGN.md oder visual-style.md) über Szenenübergänge (obligatorisch, mit Exit-Animationen nur in der letzten Szene) bis hin zu nicht verhandelbaren Regeln wie deterministischen Animationen, synchronem Timeline-Aufbau und der Vermeidung von `repeat: -1`. Es ist ideal für Entwickler, die HTML-basierte Videoinhalte, Untertitel, Text-to-Speech, audio-reaktive Effekte oder komplexe Szenenwechsel mit Claude Code, Cursor oder Codex erstellen möchten.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/assafkip/claude-video-editor/tree/HEAD/skills/hyperframes

In Ihrer bevorzugten KI fragen

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

Vorschau

Aus dem Skill-README

Dokumentation

HyperFrames

HTML ist die zentrale Wahrheitsquelle für Video. 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 Clip-Sichtbarkeit, Medienwiedergabe und Timeline-Synchronisation.

Vorgehensweise

Bevor du HTML schreibst, denke auf einer hohen Ebene nach:

  1. Was – Was soll der Zuschauer erleben? Identifiziere den Erzählbogen, die Schlüsselmomente und die emotionalen Höhepunkte.
  2. Struktur – Wie viele Kompositionen, welche sind Unterkompositionen vs. inline, welche Spuren enthalten was (Video, Audio, Overlays, Untertitel).
  3. Timing – Welche Clips bestimmen die Dauer, wo liegen die Übergänge, wie ist das Tempo.
  4. Layout – Baue zuerst den Endzustand auf. Siehe „Layout vor Animation“ unten.
  5. Animation – Füge dann Bewegung mit den folgenden Regeln hinzu.

Bei kleinen Änderungen (Farbe korrigieren, Timing anpassen, ein Element hinzufügen) kannst du direkt zu den Regeln springen.

Visuelles Identitätstor

Überprüfe in dieser Reihenfolge:

  1. Existiert DESIGN.md im Projekt? → Lies es. Verwende seine exakten Farben, Schriftarten, Bewegungsregeln und „Was NICHT zu tun ist“-Einschränkungen.
  2. Existiert visual-style.md? → Lies es. Wende sein style_prompt_full und seine strukturierten Felder an. (Hinweis: visual-style.md ist eine projektspezifische Datei. visual-styles.md ist die Stilbibliothek mit 8 benannten Vorlagen – andere Dateien.)
  3. Hat der Benutzer einen Stil genannt (z. B. „Swiss Pulse“, „dunkel und technisch“, „Luxusmarke“)? → Lies visual-styles.md für die 8 benannten Vorlagen. Erstelle eine minimale DESIGN.md mit: ## Stil-Prompt (ein Absatz), ## Farben (3-5 Hex-Werte mit Rollen), ## Typografie (1-2 Schriftfamilien), ## Was NICHT zu tun ist (3-5 Anti-Patterns).
  4. Nichts davon? → Stelle 3 Fragen, bevor du HTML schreibst:
    • Was ist die Stimmung? (explosiv / cineastisch / fließend / technisch / chaotisch / warm)
    • Heller oder dunkler Hintergrund?
    • Gibt es bestimmte Markenfarben, Schriftarten oder visuelle Referenzen? Erstelle dann aus den Antworten eine minimale DESIGN.md.

Jede Komposition muss ihre Palette und Typografie auf eine DESIGN.md, visual-style.md oder explizite Benutzeranweisung zurückführen. Wenn du nach #333, #3b82f6 oder Roboto greifst, hast du diesen Schritt übersprungen.

Befolge für Bewegungsstandards, Größen, Eintrittsmuster und Easing die house-style.md. Der Hausstil regelt WIE sich Dinge bewegen. Die DESIGN.md regelt WIE Dinge aussehen.

Layout vor Animation

Positioniere jedes Element genau dort, wo es sich in seinem am stärksten sichtbaren Moment befinden soll – dem Frame, in dem es vollständig eingetreten, korrekt platziert und noch nicht verlassen wird. Schreibe dies zuerst als statisches HTML+CSS. Noch keine GSAP.

Warum das wichtig ist: Wenn du Elemente in ihrem animierten Startzustand positionierst (außerhalb des Bildschirms, auf 0 skaliert, Deckkraft 0) und sie dann dorthin bewegst, wo du denkst, dass sie landen sollen, rätst du das endgültige Layout. Überlappungen bleiben unsichtbar, bis das Video gerendert wird. Indem du zuerst den Endzustand baust, kannst du Layout-Probleme sehen und beheben, bevor du Bewegung hinzufügst.

Der Prozess

  1. 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.
  2. Schreibe statisches CSS für diesen Frame. Der .scene-content-Container MUSS die gesamte Szene mit width: 100%; height: 100%; padding: Npx; mit display: flex; flex-direction: column; gap: Npx; box-sizing: border-box ausfüllen. Verwende Padding, um den Inhalt nach innen zu verschieben – NIEMALS position: absolute; top: Npx auf einem Inhaltscontainer. Absolut positionierte Inhaltscontainer laufen über, wenn der Inhalt höher als der verbleibende Platz ist. Reserviere position: absolute nur für Dekorationen.
  3. Füge Eingänge mit gsap.from() hinzu – animiere VON außerhalb/unsichtbar ZUR CSS-Position. Die CSS-Position ist die Grundwahrheit; der Tween beschreibt den Weg dorthin.
  4. Füge Ausgänge mit gsap.to() hinzu – animiere ZU außerhalb/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 den Abstand. */

FALSCH – hartcodierte Abmessungen und absolute Positionierung:

.scene-content {
  position: absolute;
  top: 200px;
  left: 160px;
  width: 1920px;
  height: 1080px;
  display: flex; /* ... */
}
// Schritt 3: In diese Positionen hinein 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 Elemente Platz über die Zeit teilen

Wenn Element A den Bereich verlässt, bevor Element B in den gleichen Bereich eintritt, sollten beide korrekte CSS-Positionen für ihre jeweiligen Helden-Frames haben. Die Timeline-Reihenfolge garantiert, dass sie nie visuell koexistieren – aber wenn du den Layout-Schritt überspringst, wirst du den Fall nicht erkennen, dass sie aufgrund eines Timing-Fehlers versehentlich überlappen.

Was als beabsichtigte Überlappung gilt

Geschichtete Effekte (Glühen hinter Text, Schattenelemente, Hintergrundmuster) und gestapelte Z-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
idJaEindeutige Kennung
data-startJaSekunden oder Clip-ID-Referenz ("el-1", "intro + 2")
data-durationErforderlich für img/div/compositionsSekunden. Video/Audio verwendet standardmäßig die Mediendauer.
data-track-indexJaGanzzahl. Clips auf derselben Spur können sich nicht überlappen.
data-media-startNeinVersatz innerhalb der Quelle (Sekunden)
data-volumeNein0-1 (Standard: 1)

data-track-index beeinflusst nicht die visuelle Überlagerung – verwende CSS z-index.

Kompositions-Clips

AttributErforderlichWerte
data-composition-idJaEindeutige Kompositions-ID
data-startJaStartzeit (Hauptkomposition: "0" verwenden)
data-durationJaHat Vorrang vor der GSAP-Timeline-Dauer
data-width / data-heightJaPixelabmessungen (1920x1080 oder 1080x1920)
data-composition-srcNeinPfad zur externen HTML-Datei

Kompositionsstruktur

Unterkompositionen, die über data-composition-src geladen werden, verwenden einen <template>-Wrapper. Eigenständige Kompositionen (die Haupt-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.

Struktur für Unterkompositionen:

<template id="my-comp-template">
  <div data-composition-id="my-comp" data-width="1920" data-height="1080">
    <!-- Inhalt -->
    <style>
      [data-composition-id="my-comp"] {
        /* eingeschränkte Stile */
      }
    </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>

Im 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>

Video und Audio

Video muss muted playsinline sein. Audio ist immer ein separates <audio>-Element:

<video
  id="el-v"
  data-start="0"
  data-duration="30"
  data-track-index="0"
  src="video.mp4"
  muted
  playsinline
></video>
<audio
  id="el-a"
  data-start="0"
  data-duration="30"
  data-track-index="2"
  src="video.mp4"
  data-volume="1"
></audio>

Timeline-Vertrag

  • Alle Timelines beginnen mit { paused: true } – der Player steuert die Wiedergabe
  • Jede Timeline registrieren: window.__timelines["<composition-id>"] = tl
  • Das Framework verschachtelt Unter-Timelines automatisch – NICHT manuell hinzufügen
  • Die Dauer kommt von data-duration, nicht von der GSAP-Timeline-Länge
  • Niemals leere Tweens erstellen, um die Dauer festzulegen

Regeln (Nicht verhandelbar)

Deterministisch: Kein Math.random(), Date.now() oder zeitbasierte Logik. Verwende einen gesetzten PRNG, wenn du pseudozufällige Werte benötigst (z. B. mulberry32).

GSAP: Nur visuelle Eigenschaften animieren (opacity, x, y, scale, rotation, color, backgroundColor, borderRadius, Transformationen). NIEMALS visibility, display animieren oder video.play()/audio.play() aufrufen.

Animationskonflikte: Niemals dieselbe Eigenschaft auf demselben Element aus mehreren Timelines gleichzeitig animieren.

Kein repeat: -1: Unendlich wiederholte Timelines brechen die Capture-Engine. Berechne die genaue Wiederholungszahl aus der Kompositionsdauer: repeat: Math.ceil(duration / cycleDuration) - 1.

Synchroner Timeline-Aufbau: Timelines niemals innerhalb von async/await, setTimeout oder Promises erstellen. Die Capture-Engine liest window.__timelines synchron nach dem Laden der Seite. Schriftarten werden vom Compiler eingebettet, sodass sie sofort verfügbar sind – kein Warten auf das Laden von Schriftarten erforderlich.

Niemals Folgendes tun:

  1. window.__timelines-Registrierung vergessen
  2. Video für Audio verwenden – immer stummgeschaltetes Video + separates <audio>
  3. Video innerhalb eines getimten divs verschachteln – einen nicht getimten Wrapper verwenden
  4. data-layer (stattdessen data-track-index verwenden) oder data-end (stattdessen data-duration verwenden)
  5. Videoelementabmessungen animieren – einen Wrapper-div animieren
  6. Play/Pause/Seek auf Medien aufrufen – das Framework besitzt die Wiedergabe
  7. Einen Container der obersten Ebene ohne data-composition-id erstellen
  8. repeat: -1 auf einer Timeline oder einem Tween verwenden – immer endliche Wiederholungen
  9. Timelines asynchron erstellen (innerhalb von async, setTimeout, Promise)
  10. gsap.set() auf Clip-Elementen aus späteren Szenen verwenden – sie existieren zum Zeitpunkt des Seitenladens nicht im DOM. Verwende stattdessen tl.set(selector, vars, timePosition) innerhalb der Timeline zum oder nach dem data-start-Zeitpunkt des Clips.
  11. <br> im Textinhalt verwenden – erzwungene Zeilenumbrüche berücksichtigen nicht die tatsächliche gerenderte Schriftbreite. Text, der natürlich umbricht + ein <br> erzeugt einen zusätzlichen unerwünschten Umbruch, was zu Überlappungen führt. Lasse Text stattdessen über max-width umbrechen. Ausnahme: kurze Anzeigetitel, bei denen jedes Wort bewusst in einer eigenen Zeile steht (z. B. „DER UNSTERBLICHE SPIEL“ bei 130px).

Szenenübergänge (Nicht verhandelbar)

Jede Mehrszenen-Komposition MUSS ALLE diese Regeln befolgen. Eine Verletzung einer einzigen Regel führt zu einer defekten Komposition.

  1. IMMER Übergänge zwischen den Szenen verwenden. Keine Jump Cuts. Keine Ausnahmen.
  2. IMMER Eingangsanimationen in jeder Szene verwenden. Jedes Element animiert mit gsap.from() EIN. Kein Element darf vollständig ausgebildet erscheinen. Wenn eine Szene 5 Elemente hat, benötigt sie 5 Eingangs-Tweens.
  3. NIEMALS Ausgangsanimationen verwenden, außer in der letzten Szene. Das bedeutet: KEIN gsap.to(), das die Deckkraft auf 0, y außerhalb des Bildschirms, Maßstab auf 0 oder eine andere „Aus“-Animation animiert, bevor ein Übergang ausgelöst wird. Der Übergang IST der Ausgang. Der Inhalt der ausgehenden Szene MUSS zum Zeitpunkt des Übergangsbeginns vollständig sichtbar sein.
  4. Nur letzte Szene: In der letzten Szene können Elemente ausgeblendet werden (z. B. Ausblenden auf Schwarz). Dies ist die EINZIGE Szene, in der gsap.to(..., { opacity: 0 }) erlaubt ist.

FALSCH – Ausgangsanimation vor dem Übergang:

// VERBOTEN – dies entleert die Szene, bevor der Übergang sie verwenden kann
tl.to("#s1-title", { opacity: 0, y: -40, duration: 0.4 }, 6.5);
tl.to("#s1-subtitle", { opacity: 0, duration: 0.3 }, 6.7);
// Der Übergang wird auf einem leeren Frame ausgelöst

RICHTIG – nur Eingang, Übergang behandelt Ausgang:

// Szenen 1 Eingangsanimationen
tl.from("#s1-title", { y: 50, opacity: 0, duration: 0.7, ease: "power3.out" }, 0.3);
tl.from("#s1-subtitle", { y: 30, opacity: 0, duration: 0.5, ease: "power2.out" }, 0.6);
// KEINE Ausgangs-Tweens – Übergang bei 7,2s behandelt den Szenenwechsel
// Szenen 2 Eingangsanimationen
tl.from("#s2-heading", { x: -40, opacity: 0, duration: 0.6, ease: "expo.out" }, 8.0);

Animationsleitplanken

  • Versetze die erste Animation um 0,1-0,3 s (nicht t=0)
  • Variiere die Easings zwischen den Eingangs-Tweens – verwende mindestens 3 verschiedene Easings pro Szene
  • Wiederhole ein Eingangsmuster nicht innerhalb einer Szene
  • Vermeide Vollbild-Linearfarbverläufe auf dunklen Hintergründen (H.264-Banding – verwende radial oder einfarbig + lokalisiertes Glühen)
  • 60px+ Überschriften, 20px+ Fließtext, 16px+ Datenbeschriftungen für gerendertes Video
  • font-variant-numeric: tabular-nums auf Zahlenspalten

Wenn keine visual-style.md oder Animationsrichtung angegeben ist, folge der house-style.md für ästhetische Standardeinstellungen.

Typografie und Assets

  • Schriftarten: Schreibe einfach die gewünschte font-family in CSS – der Compiler bettet unterstützte Schriftarten automatisch ein. Wenn eine Schriftart nicht unterstützt wird, gibt der Compiler eine Warnung aus.
  • Füge `crossorigin="anonymous"" zu externen Medien hinzu

Für…

[im Interesse der Länge gekürzt]

Individual skills in this repo

This repo contains 9 individual skills — each has its own dedicated page.

assafkip/claude-video-editor

Build videos from stills when there is nothing to cut — narration first (ElevenLabs v3 with audio tags), then still keyframes from ANY source (AI image tools, screenshots, photos, HyperFrames-rendered HTML), animated deterministically with the animate-stills recipe (HyperFrames camera moves + GSAP atmosphere). Use when the user wants an explainer, documentary-style video, or any video built from generated or collected visuals instead of recorded footage.

assafkip/claude-video-editor

GSAP animation reference for HyperFrames. Covers gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), position parameter, labels, nesting, playback), and performance (transforms, will-change, quickTo). Use when writing GSAP animations in HyperFrames compositions.

assafkip/claude-video-editor

HyperFrames CLI tool — hyperframes init, lint, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark. Use when scaffolding a project, linting or validating compositions, previewing in the studio, rendering to video, transcribing audio, generating TTS, or troubleshooting the HyperFrames environment.

assafkip/claude-video-editor

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

assafkip/claude-video-editor

Beginner-friendly end-to-end video creator for HyperFrames. Use when the user says "make a video", "create a video", "new video", "build a video", "video from scratch", "I want to make a video", "help me create a video", or when someone who's never used HyperFrames before arrives with a concept, script, or rough idea and wants a finished MP4. Interviews the user in one pass, then builds the full video with mandatory preview and visual-verification gates.

assafkip/claude-video-editor

Build and iterate short-form vertical (9:16) videos in Hyperframes — TikTok/Reels/Shorts style. Use when Nate says "short-form video", "vertical video", "TikTok/Reels/Shorts", "make a short", "talking-head + motion graphics", or when the target is a 1080x1920 composition with face video + synced scene overlays + karaoke captions. Encodes the full May Shorts 19 playbook: face-mode choreography, audio-synced scene timing, karaoke captions, and the 10-rule quality checklist.

assafkip/claude-video-editor

Edit any video by conversation — the orchestrator for the bundled video pipeline. Use when the user wants to edit, cut, caption, grade, or add motion graphics to footage; drops a folder of clips and says "edit this"; or asks to make a promo/teaser/tutorial/short. Routes to video-use (the cut engine) and HyperFrames (motion-graphics overlays), with a motion-craft library for taste.

assafkip/claude-video-editor

Production pipeline for mathematical and technical animations using Manim Community Edition. Creates 3Blue1Brown-style explainer videos, algorithm visualizations, equation derivations, architecture diagrams, and data stories. Use when users request: animated explanations, math animations, concept visualizations, algorithm walkthroughs, technical explainers, 3Blue1Brown style videos, or any programmatic animation with geometric/mathematical content.

assafkip/claude-video-editor

Capture a website and create a HyperFrames video from it. Use when: (1) a user provides a URL and wants a video, (2) someone says "capture this site", "turn this into a video", "make a promo from my site", (3) the user wants a social ad, product tour, or any video based on an existing website, (4) the user shares a link and asks for any kind of video content. Even if the user just pastes a URL — this is the skill to use.

Verwandte Skills