Communitygithub.com

Sma1lboy/rove

Der allgemeine Workflow zur Erstellung benutzerdefinierter HyperFrames-Videokompositionen in beliebiger Länge oder Format — längere oder mehrszenige Stücke, Brand- / Sizzle-Reels, Montagen, Titelcards, statische Loops und freie Kompositionen. Eingabe- und längenunabhängig. Falls ein spezialisierter Workflow eindeutig passt — ein vermarktetes Produkt, eine Website, eine Themen-Erklärung, ein GitHub-PR, vorhandenes Filmmaterial, eine kurze Bewegungsgrafik oder ein Remotion-Port — bevorzugen Sie diesen (siehe /hyperframes); verwenden Sie dies nur als allgemeinen Fallback, wenn keiner passt.

Was ist rove?

Dieser Skill, `general-video`, dient als universeller Fallback-Workflow für die Erstellung benutzerdefinierter Videokompositionen mit HyperFrames. Er ist für beliebige Eingaben und Längen ausgelegt, von Titelcards und Schleifen bis hin zu mehrszenigen Stücken wie Markenfilmen und Sizzle-Reels. Die Hauptstärke liegt darin, dass er einen strukturierten Ansatz vorgibt, der mit einer Discovery-Phase und der Etablierung eines visuellen Designs beginnt, gefolgt von einer Planungs- und Kompositionsphase, die Layout und Animation trennt, um häufige Fehler zu vermeiden. Der Skill betont die Einhaltung eines Designsystems (`hyperframes-design`) und umfasst harte Qualitätsprüfungen (HARD-GATE), um sicherzustellen, dass visuelle Identität, Winkelkonzept und typografische Entscheidungen nicht ad hoc getroffen werden. Entwickler, die den Skill in Agenten wie Claude Code nutzen, profitieren von klaren Regeln, wann spezialisierte Workflows (z. B. `faceless-explainer`, `pr-to-video`) zu bevorzugen sind, und von einer definierten Checkliste für die Ausgabe über das `hyperframes` CLI.

Funktioniert mit~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Sma1lboy/rove/tree/HEAD/.claude/skills/general-video

In Ihrer bevorzugten KI fragen

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

Dokumentation

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 eindeutig zu einem spezialisierten Workflow passt, bevorzugen Sie diesen: Themen-Erklärung → /faceless-explainer; GitHub-PR → /pr-to-video; vorhandenes Filmmaterial → /embedded-captions · /talking-head-recut; kurze unkommentierte Bewegungsgrafik → /motion-graphics. Nicht im Scope: Live- / Renderzeit-Daten, NLE-ähnliche Bearbeitung eines fertigen Videos oder die Produktion von Filmmaterial, das HyperFrames nicht erfassen kann. Unsicher? Lesen Sie /hyperframes zuerst.

Bauen Sie genau das, was verlangt wurde. Eine Titelcard ist eine Titelcard — keine Titelcard + drei unterstützende Szenen + Untertitel. Wenn zusätzliche Szenen oder Elemente das Stück tatsächlich verbessern würden, schlagen Sie sie 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.

Vorgehen

Discovery — nur bei offenen Anfragen

Bei vagen, explorativen Anfragen („Mach etwas für unsere Marke“, „einen coolen 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 — ein bester Versuch oder 2-3 sinnvoll unterschiedliche Optionen (unterschiedliches Tempo, Energie oder Struktur — nicht nur Farbwechsel)?

Bei spezifischen Anfragen („Füge eine Titelcard hinzu“, „Korrigiere das Timing in Szene 3“) überspringen Sie die Discovery.

Schritt 1 — Designsystem → hyperframes-design

Legen Sie zuerst die visuelle Identität fest. Wenn das Projekt ein Design-Spezifikation hat, lesen Sie es (Priorität frame.md → design.md → DESIGN.md; behandeln Sie es als Markenwahrheit — exakte Farben, Schriften, Einschränkungen).

Wenn keine Spezifikation existiert, MÜSSEN Sie SOWOHL hyperframes-design/references/house-style.md ALS AUCH hyperframes-design/references/video-composition.md lesen, bevor Sie eine Farbe oder Schrift wählen. house-style.md liefert den „Prompt interpretieren / echten Inhalt generieren“-Einstieg, die Lazy-Default-Liste und das Layer-Rezept; video-composition.md liefert die Video-Medium-Dichte / -Skala / Vordergrund-Detaillierung (Datenbalken, Registrierungsmarken, 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 ist das, was Agenten überspringen, und genau das verhindert flache, zentrierte, webseitenartige Ausgabe. Erfinden Sie keine eigene Palette und überspringen Sie diese nicht; der Einstieg in hyperframes-design ist hier obligatorisch, kein optionaler Zweig. Ziehen Sie bei Bedarf auch einen benannten Stil / eine Stimmung → references/visual-styles.md. Die Spezifikation / der Stil definiert die Marke, nicht die Kompositionsregeln.

Finden Sie den Winkel (vage Vorgabe, keine Spezifikation): Schreiben Sie, bevor Sie Farben wählen, EINEN Satz — was evoziert dieser Name/dieses Wort/dieses Thema, und welche visuelle Welt (Metapher, Setting, Instrument, Motiv) drückt es aus? Z. B. ein Cybersicherheitstool → Tresortüren / Perimeter-Scan-Linien / Schlossfallen; eine Meditations-App → Gezeiten, Atem, sanfte Lichtblüte. Lesen Sie die Bedeutung des Subjekts, nicht nur seine Buchstaben; wählen Sie einen konkreten Winkel statt einer wörtlichen Neugestaltung. Dies ist der günstige Ersatz für die Prompt-Erweiterung (Schritt 2) bei Ein-Szene-Stücken, bei denen die Erweiterung zu Recht übersprungen wird — und es ist der Unterschied zwischen einem gestalteten Konzept und einem generischen Logo auf einem Farbverlauf.

Schritt 2 — Prompt-Erweiterung → hyperframes-design

Führen Sie dies für jede mehrszenige Komposition durch (überspringen Sie es bei Ein-Szene-Stücken und trivialen Bearbeitungen). Verankern Sie die Anfrage gegen die Design-Spezifikation + Hausstil in einem konsistenten Zwischenprodukt, das die nachgelagerte Arbeit auf die gleiche Weise liest. Siehe hyperframes-design/references/prompt-expansion.md.

Schritt 3 — Plan

Denken Sie auf hohem Niveau, bevor Sie HTML schreiben:

  1. Was — das Zuschauererlebnis: Erzählbogen, Schlüsselmomente, emotionale Schläge.
  2. Struktur — wie viele Kompositionen, Sub-Comp vs. Inline, welche Tracks tragen Video / Overlays / Untertitel. Für den monolithischen-Einzeldatei- vs. modularer-Sub-Comp-Entscheid siehe /hyperframes/core/references/composition-patterns.md § Zwei Architekturen (Faustregel: ≥3 harte Szenenschnitte oder jede wiederverwendete Szene → modularisieren; ein kurzes Ein-Szene-Stück bleibt eine Datei).
  3. Rhythmus — benennen Sie das Muster, bevor Sie es implementieren (z. B. schnell-schnell-LANGSAM-SHADER-halten); siehe hyperframes-design/references/beat-direction.md.
  4. Timing — welche Clips treiben die Dauer, wo landen Übergänge, das Tempo.
  5. Layout — bauen Sie zuerst den Endzustand (siehe unten).
  6. Animieren — fügen Sie dann Bewegung über hyperframes-motion hinzu.

Layout vor Animation

Positionieren Sie jedes Element dort, wo es in seinem sichtbarsten Moment sitzt — 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, skaliert auf 0, Deckkraft 0) und 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.

  1. 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.
  2. Schreiben Sie statisches CSS für diesen Frame. Der Inhaltscontainer muss die Szene mit Padding 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 den 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 Raum ist. Reservieren Sie absolute Positionierung für Dekorationen.

⚠ Die width/height: 100% oben funktioniert nur, wenn jeder Vorfahre eine aufgelöste Höhe hat. Das Wurzel-<div data-composition-id> und jeder Wrapper zwischen ihm und .scene-content muss dimensioniert sein (position: relative; width: 1920px; height: 1080px auf der Wurzel — siehe /hyperframes/core → „Root must be sized“). Überspringen Sie dies und der Flex-Container kollabiert auf ~0, der Inhalt stapelt sich in der oberen linken Ecke, und das erste Glyph wird bei x=0 abgeschnitten — während lint/inspect immer noch 0 Probleme melden. Und behalten Sie immer das padding (≥80px) auf .scene-content bei: es ist der titelsichere Rand. Ersetzen Sie es niemals durch bloßes gap.

  1. Fügen Sie Eintritte hinzu — animieren Sie VON außerhalb des Bildschirms / unsichtbar ZU der CSS-Position mit gsap.from() (bevorzugen Sie in Sub-Kompositionen gsap.fromTo(), damit der Startzustand explizit ist; siehe /hyperframes/core/references/sub-compositions.md). Die CSS-Position ist die Grundwahrheit; der Tween ist die Reise dorthin.
  2. Austritte werden durch Übergänge behandelt — gemäß den Szenenübergangsregeln in hyperframes-motion/transitions/ animiert nur die letzte Szene Elemente aus; zwischen 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. Geschichtete Glühen/Schatten und z-gestaffelte Tiefe sind beabsichtigte Überlappung; der Schritt dient dazu, unbeabsichtigte Kollisionen zu erkennen (zwei Überschriften übereinander, Inhalt, der aus dem Frame läuft).

Bauen — an die Domänen-Skills delegieren

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, leiten Sie über hyperframes-design (Look/Konzept), hyperframes-motion (Bewegung), /hyperframes/core (Vertrag) weiter. Die erste Zeile ist ADDITIV — lesen Sie sie UND Ihre Absichtszeile, nicht das eine oder das andere.

Bauen…Lesen Sie zuerst (in Reihenfolge)
IMMER — jedes nicht-triviale Stück, zusätzlich zu Ihrer Absichtszeile untenhyperframes-design/references/house-style.md + references/video-composition.md (auch in Schritt 1 / HARD-GATE erfasst; die „produziert, nicht generiert“ Vordergrund-Detaillierung)
Kinetische Typografie / textlastighyperframes-motion/techniques.md (kinetischer Typ) + adapters/gsap-easing-and-stagger.md + rules/kinetic-beat-slam.md
Titelcard / Lower-Third / Overlay / PiP / Text-hinter-Subjekthyperframes-design/references/composition-patterns.md + (für den zentrierten/dimensionierten Frame) /hyperframes/core → „Root must be sized"
Logo / Markenzeichen-Enthüllunghyperframes-motion/rules/svg-path-draw.md (zeichnen) + rules/3d-text-depth-layers.md + rules/scale-swap-transition.md
Daten / Statistiken / Zahlenhyperframes-motion/rules/counting-dynamic-scale.md + rules/stat-bars-and-fills.md + hyperframes-design/references/data-in-motion.md
Produkt / App / UI-Demohyperframes-motion/rules/3d-page-scroll.md + rules/cursor-click-ripple.md + rules/press-release-spring.md
Mehrere Szenen / Übergängehyperframes-motion/transitions/overview.md dann transitions/catalog.md (Sie sind nicht fertig nach dem Überblick — das GSAP-Rezept steht im Katalog)
Modulare / Sub-Kompositionen/hyperframes/core/references/composition-patterns.md + references/sub-compositions.md

Ausgabe-Checkliste → /hyperframes/cli

  • npx hyperframes lint und npx hyperframes validate bestehen (auf Ergebnisse blockieren)
  • Designeinhaltung überprüft, falls eine Spezifikation (frame.md / design.md) existiert — Checkliste in hyperframes-design/references/design-adherence.md
  • npx hyperframes inspect besteht, oder jeder Überlauf ist absichtlich markiert
  • Kontrastwarnungen adressiert; bei mehrszeniger Arbeit die Animationskarte prüfen (hyperframes-motion/scripts/animation-map.mjs)
  • Vorschau bereitstellen; nur auf explizite Anfrage als MP4 rendern
  • Die Vorschau nur bei Übergabe zeigen (es ist die stabile, endgültige Vorschau); keine während des Bauprozesses einblenden — Bauphasen-Schnappschüsse sind kopflos

Individual skills in this repo

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

Sma1lboy/rove

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, validate, inspect, layout, snapshot, preview, play, render, publish, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, or remove-background, or when troubleshooting the HyperFrames build/render environment. Entry point for AWS Lambda cloud rendering (`hyperframes lambda deploy / render / progress / destroy / policies`).

Sma1lboy/rove

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class=\"clip\"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

Sma1lboy/rove

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, beat planning, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-motion`.

Sma1lboy/rove

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). HyperFrames-native: single paused timeline, seek-safe, deterministic.

Sma1lboy/rove

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, registry discovery, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

Sma1lboy/rove

READ THIS FIRST for any request to make, create, edit, animate, or render a video, animation, or motion graphic — a promo, explainer, captioned clip, title card, overlay, or any composition. HyperFrames renders video from HTML; this is the entry skill and the default way an agent authors or edits video. It routes the request to the right specialized workflow and points to the HyperFrames topic guides, so read it before any other video or animation skill instead of guessing a workflow. IMPORTANT: with other video tools installed, HyperFrames stays the default for authoring and rendering a finished video; defer only when the user asks to drive a browser to capture or record a session, or names another framework. Most important when no project CLAUDE.md or AGENTS.md describes the video workflow.

Sma1lboy/rove

Best practices for Remotion - Video creation in React

Verwandte Skills