Communitygithub.com

DigitalRavagers/Experiment

HyperFrames HTML-Kompositionsvertrag. Wird verwendet für Kompositionsstruktur, Datenattribute, Clips, Tracks, Unterkompositionen, Variablen, Medienwiedergabe, deterministische Rendering-Regeln und Validierung minimaler renderbarer Projekte.

Was ist Experiment?

Dieses Skill definiert den technischen Kernvertrag von HyperFrames, einem Framework, das Video aus HTML rendert, indem es DOM-Elemente mit `data-*`-Attributen für Timing und Animation nutzt. Es beschreibt die grundlegende Kompositionsstruktur, unterscheidet zwischen eigenständigen (Standalone) und Unterkompositionen (Sub-Compositions) und legt fest, wie diese korrekt mit `<template>`-Wrappern und `data-composition-id`-Attributen konfiguriert werden müssen. Das Skill enthält unverhandelbare Regeln für deterministisches Rendering, wie das Verbot von `Math.random()`, `repeat: -1`, die korrekte Handhabung von Medien als direkte Kinder des Host-Roots sowie die Vermeidung von Layout-Fehlern durch nicht dimensionierte Wurzelelemente. Es verweist auf spezialisierte Sub-Skills für Animation, kreative Gestaltung, Medienintegration, Paketverwaltung und CLI-Tools und bietet eine detaillierte Routing-Tabelle für häufige Entwicklerfragen. Das Skill ist plattformunabhängig und arbeitet mit beliebigen JavaScript-Laufzeiten (GSAP, Lottie, Three.js, CSS, WAAPI, Anime.js) zusammen, wobei der Fokus auf der Einhaltung der Timeline- und Layout-Verträge liegt, um visuelle Fehler zu vermeiden, die von Lint- und Validierungswerkzeugen nicht erkannt werden.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/DigitalRavagers/Experiment/tree/HEAD/.agents/skills/hyperframes-core

In Ihrer bevorzugten KI fragen

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

Dokumentation

HyperFrames Core

HyperFrames rendert Video aus HTML. Eine Komposition ist eine HTML-Datei, deren DOM mit data-*-Attributen das Timing deklariert, deren Animationslaufzeit suchbar ist und deren Medienwiedergabe vom Framework verwaltet wird.

Dieses Skill ist der technische Vertrag. Andere Belange leben in benachbarten Skills:

  • hyperframes-animation — atomare Bewegungsregeln + Szenen-Blaupausen + Laufzeit-Adapter (GSAP, Lottie, Three, Anime.js, CSS, WAAPI, TypeGPU)
  • hyperframes-creative — Paletten, Typografie, Narration, Beat-Planung, audio-reaktiv
  • hyperframes-media — TTS, Whisper-Transkription, Hintergrundentfernung, Untertitel
  • hyperframes-registry — Blöcke und Komponenten installieren (hyperframes add)
  • hyperframes-cli — Entwicklungs-Loop-Befehle (lint / validate / preview / render)

Für Tailwind v4 Projekte (hyperframes init --tailwind) siehe references/tailwind.md — der Browser-Laufzeitvertrag unterscheidet sich von Studios Tailwind v3 Setup.

Routing

Möchten Sie…Lesen Sie
Eine minimal renderbare Komposition sehenreferences/minimal-composition.md
Zwischen monolithischer Einzeldatei- und modularer Unterkompositions-Architektur entscheidenreferences/composition-patterns.md
Ein modulares index.html strukturieren (Orchestrator + Slots + Root-Audio)references/composition-patterns.md
Einen Unterkompositions-Archetyp wählen (Inhalt / Nur-Treiber / Multi-Szene-Merge / Audio-reaktiv)references/composition-patterns.md
Ein data-*-Attribut nachschlagen (Root, Clip, Sub-Comp-Host, Legacy-Aliase)references/data-attributes.md
class="clip" korrekt verwendenreferences/data-attributes.md
Einen data-track-index wählen; Überlappung auf gleichem Track; Track-Index vs CSS z-indexreferences/tracks-and-clips.md
Einen Clip relativ zu einem anderen timen (data-start="intro + 2", Crossfade-Überlappung, Ketten)references/tracks-and-clips.md
Eine Unterkomposition verdrahten (Host-Attribute, <template>-Wrapper, Instanz-Variablen)references/sub-compositions.md
Innerhalb einer Unterkomposition animieren (gsap.fromTo statt gsap.from, Rückwärtssuch-Verhalten)references/sub-compositions.md
Variablen deklarieren (Typen, Zusatzoptionen, Standardwerte, --strict-variables in CI)references/variables-and-media.md
<video> / <audio> platzieren, Lautstärke setzen, mit data-media-start trimmenreferences/variables-and-media.md
Eine suchbare Timeline erstellen (pausiert, synchrone Konstruktion, gsap.set-Spätszenen-Falle)references/determinism-rules.md
Nicht-deterministischen Zustand vermeiden (Uhren, Math.random, repeat: -1, endliche Wiederholungsformel)references/determinism-rules.md
Wissen, was animiert werden kann / nicht animiert werden darf (visuelle Eigenschafts-Whitelist; nicht display/visibility)references/determinism-rules.md
Text anpassen und Überlauf verhindern (fitTextFontSize-Signatur, <br>-Regel, Layout-Vertrag)references/determinism-rules.md
Vollbild-Bewegung mit gemeinsamen Hintergründen erstellenreferences/full-screen-motion.md
In einem Tailwind v4 Projekt arbeiten (init --tailwind)references/tailwind.md

Für Animationslaufzeit-Details (GSAP-API, Lottie, Three.js, etc.) gehen Sie zu hyperframes-animation → adapters/<runtime>.md.

Kompositionsstruktur

Zwei Wurzel-Formen; sie sind nicht austauschbar.

  • Eigenständig (das oberste index.html) — root <div data-composition-id="…"> sitzt direkt in <body>. Kein <template>-Wrapper. Das Ummanteln eines eigenständigen Root in <template> versteckt alle Inhalte vor dem Browser und zerstört das Rendern.
  • Unterkomposition (eine Datei, die über data-composition-src geladen wird) — root <div data-composition-id="…"> muss in <template> umschlossen sein. Ohne den Wrapper kann die Laufzeitumgebung es nicht extrahieren und einhängen.

⚠ Unterkompositions-Transportregel: Die Laufzeitumgebung klont nur <template>-Inhalte in das live DOM. Alles außerhalb des Templates — einschließlich <head> und alle <style>/<script>/<link> im <head> — wird verworfen. Platzieren Sie <style>- und <script>-Blöcke innerhalb <template>, nicht in <head>.

⚠ Host-ID-Regel: In der Host-Datei muss data-composition-id am Slot exakt gleich der inneren data-composition-id des Templates und des window.__timelines["<id>"]-Schlüssels sein. Fügen Sie keine -mount / -slot / -host-Suffixe hinzu.

Siehe references/sub-compositions.md für die Dateiform, Host-Verdrahtung, Fallstrickbeispiele und die Pre-Render-Verifizierungs-Checkliste.

Root muss dimensioniert sein (stiller Layout-Fehler)

Der eigenständige Root muss einen explizit dimensionierten Kasten herstellen, und jeder Vorfahre zwischen ihm und einem height: 100%-Element muss eine aufgelöste Höhe haben. Wenn der Root oder ein Zwischenwrapper keine Höhe hat, fällt ein Flex-/height:100%-Inhaltscontainer auf ~0 zusammen und Inhalte stapeln sich in der linken oberen Ecke (oft wird das erste Zeichen bei x=0 abgeschnitten). lint, validate und inspect fangen dies nicht — inspect ersetzt das erstellte data-width/data-height für einen kollabierten Root und meldet "0 Layout-Probleme."

<body style="margin: 0">
  <div
    id="root"
    data-composition-id="main"
    data-width="1920"
    data-height="1080"
    data-duration="5"
    style="position: relative; width: 1920px; height: 1080px; overflow: hidden"
  >
    <!-- Zentrieren Sie robust: position:absolute + inset:0 füllt den dimensionierten Root unabhängig von
         Zwischenwrappern; oder verwenden Sie einen Flex-Container NUR wenn seine Elternkette dimensioniert ist. -->
    <section
      class="clip"
      data-start="0"
      data-duration="5"
      data-track-index="1"
      style="position: absolute; inset: 0; display: grid; place-items: center; padding: 120px 160px; box-sizing: border-box"
    >
      <h1>Titel</h1>
    </section>
  </div>
</body>

Behalten Sie das padding (≥80px) auf dem Zentrierungscontainer — es ist der titelsichere Rand, der verhindert, dass große Schrift die Rahmenkante berührt. Siehe references/minimal-composition.md.

Timeline-Vertrag (GSAP-Standard)

Jede Komposition registriert genau eine GSAP-Timeline.

  • Erstellen mit gsap.timeline({ paused: true }) — der Player besitzt die Wiedergabe.
  • Registrieren bei window.__timelines["<composition-id>"]; der Schlüssel muss exakt dem data-composition-id des Root entsprechen. Dot-Syntax (window.__timelines.<id> = tl) ist äquivalent, wenn die ID ein gültiger Bezeichner ist; verwenden Sie Klammern, wenn die ID - enthält.
  • Bauen Sie die Timeline synchron während des Seitenladens — nicht innerhalb von async, setTimeout, Promise oder Ereignis-Handlern. Der Renderer erfasst nach Abschluss des Seitenladens; jede verzögerte Timline-Konstruktion verpasst die Erfassung.
  • Die Rendering-Dauer kommt von data-duration am Root, nicht von der GSAP-Timeline-Länge. Polstern Sie die Timeline nicht mit leeren Tweens, um die Dauer zu setzen.
  • Für Unterkompositionen: Verschachteln Sie Unter-Timelines nicht manuell in den Host (master.add(sub)); das Framework steuert sie unabhängig.

Für Nicht-GSAP-Laufzeiten (Lottie / Three / WAAPI / CSS / Anime.js / TypeGPU) lebt der äquivalente Vertrag in hyperframes-animation/adapters/<runtime>.md. Siehe references/determinism-rules.md für den laufzeitübergreifenden Animationslaufzeitvertrag.

Unverhandelbare Regeln

Diese brechen den Renderer — oder erzeugen stille visuelle Fehler, die lint/validate/inspect NICHT erkennen (Regeln 3, 7-8). (Synchroner Timline-Aufbau ist oben unter Timeline-Vertrag abgedeckt.)

  1. Kein Math.random() / Date.now() / performance.now(), die Grafiken steuern — verwenden Sie einen gesähten PRNG.
  2. Kein repeat: -1. Verwenden Sie repeat: Math.max(0, Math.floor(duration / cycleDuration) - 1) — floor, nicht ceil (ceil überschreitet data-duration und löst den gsap_repeat_ceil_overshoot-Lint aus; max(0, …) vermeidet ein negatives Repeat = unendlich).
  3. <video>/<audio> muss ein direktes Kind des Host-Root (index.html) sein — niemals innerhalb eines Unterkompositions-<template>, niemals innerhalb eines Wrapper-<div>; sonst wird es nie dekodiert und rendert leer/schwarz (stiller Fehler). Das Framework besitzt die Wiedergabe: kein video.play() / audio.play() / currentTime = …. Eine Unterkomposition kann keine Host-Elemente steuern (Selektor oder querySelector), also animieren Sie Host-Medien von der Haupt-Timeline zur globalen Zeit. Siehe references/variables-and-media.md.
  4. Kein gsap.set() auf Clip-Elementen aus späteren Szenen (sie sind noch nicht im DOM). Verwenden Sie tl.set(selector, vars, time) zum oder nach dem data-start des Clips.
  5. Kein Animieren von display / visibility. Animieren Sie opacity / Transformationen; der Clip-Lebenszyklus kümmert sich um Ein-/Ausblenden.
  6. Kein <br> im Fließtext. Lassen Sie Text über max-width umbrechen.
  7. Transformierte Elemente müssen block-level + dimensioniert sein. transform/scaleX/scaleY ist ein No-op auf einem inline <span>, und das Skalieren eines auto-width (0px) Elements zeigt nichts → unsichtbare Balken/Füllungen. Geben Sie ihnen display: block/inline-block/flex-item und eine echte width/height (z.B. width: 100% innerhalb eines dimensionierten Elternteils).
  8. Absolut positionierte dekorative Elemente (Badges, Pills, Tags), die pulsieren oder überschwingen (yoyo-Skalierung, back.out), benötigen Platz auf ihrer maximalen Größe und dürfen keine Kante mit overflow: hidden überschreiten — sonst überlappen sie einen Nachbarn oder werden abgeschnitten. Positionieren Sie für den größten Frame, nicht den Ruhezustand.

Bestehende Kompositionen bearbeiten

  • Lesen Sie die tatsächlichen Dateien vor dem Bearbeiten.
  • Erhalten Sie nicht verwandtes Timing, Tracks, IDs, Variablen und Medienpfade.
  • Übereinstimmung mit bestehenden Kompositions-IDs und Timeline-Registry-Schlüsseln.
  • Wenn Sie einen Clip hinzufügen, wählen Sie einen nicht überlappenden data-track-index oder passen Sie das umgebende Timing absichtlich an.
  • Wenn Sie eine Unterkomposition hinzufügen, überprüfen Sie deren interne data-composition-id, bevor Sie den Host verdrahten.

Validierung

Verwenden Sie hyperframes-cli für Befehlsdetails.

  • npx hyperframes lint besteht (0 Fehler)
  • npx hyperframes validate besteht (0 Konsolenfehler)
  • npx hyperframes inspect besteht, oder Überlauf ist absichtlich markiert
  • Projekte mit Unterkompositionen: npx hyperframes snapshot --at <midpoints> und jedes Bild ansehen

Individual skills in this repo

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

DigitalRavagers/Experiment

When the user wants to edit, review, or improve existing marketing copy, or refresh outdated content. Also use when the user mentions 'edit this copy,' 'review my copy,' 'copy feedback,' 'proofread,' 'polish this,' 'make this better,' 'copy sweep,' 'tighten this up,' 'this reads awkwardly,' 'clean up this text,' 'too wordy,' 'sharpen the messaging,' 'refresh this content,' 'update this page,' 'this content is outdated,' or 'content audit.' Use this when the user already has copy and wants it improved or refreshed rather than rewritten from scratch. For writing new copy, see copywriting.

DigitalRavagers/Experiment

Add captions to a talking-head video. ONE catalog (CATALOG.md) of 32 visual identities behind two engines: column-flow (captions composited INTO the scene — matte occlusion + mix-blend; cream/ink/editorial/keynote/documentary/loud/neon/glitch/chrome/velocity) and themed constitutions (anchor/ordnance/terminal/neonsign/stardust/stomp/scoreboard/transit/vhs/arcade/dossier/laser/thunder/hologram/biolume/aurora/spectrum/papercut/popup/chalkboard/graffiti/brush/inkwater/ransom/lastpage/nightcity — e.g. a glyph-decode climax, a neon sign WRITTEN stroke by stroke, or the quiet `anchor` rail default). Route by identity, never by mode. Trigger on "captions/subtitles", "embed/cinematic captions", "VFX captions", "炸/特效/酷炫字幕", a named identity, or top-tier motion-graphics asks. Embedding every word is wrong for most talking-head content — `anchor` is the verbatim default. Pipeline: transcription → hyperframes remove-background matting → HTML render → ffmpeg overlay. Requires hyperframes and a single-subject clip.

DigitalRavagers/Experiment

Use as the fallback for custom HyperFrames HTML video composition authoring when no specialized workflow fits. Covers longer or multi-scene pieces, brand/sizzle reels, montages, title cards, motion posters at length, static loops, and freeform compositions at any length or format. Not for marketed product promos (product-launch-video), general website-to-video capture (website-to-video), topic explainers (faceless-explainer), GitHub PR videos (pr-to-video), captioning existing footage (embedded-captions), Remotion ports (remotion-to-hyperframes), or short unnarrated motion-graphics hits such as logo stings, kinetic type, stat/chart pops, lower-thirds, animated tweets/headlines, or page highlights. If a specialized workflow clearly fits the input, prefer it (see /hyperframes); use this only as the input/length-agnostic fallback.

DigitalRavagers/Experiment

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.

DigitalRavagers/Experiment

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, tts, 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`).

DigitalRavagers/Experiment

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

DigitalRavagers/Experiment

Asset preprocessing for HyperFrames compositions — multi-provider TTS (HeyGen / ElevenLabs / Kokoro local), multi-provider BGM (Google Lyria / local MusicGen), Whisper transcription, background removal, and caption authoring. Use for npx hyperframes tts, bgm, transcribe, remove-background, voice/provider selection, music-mood prompting, captions / subtitles / lyrics / karaoke / per-word styling.

DigitalRavagers/Experiment

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).

DigitalRavagers/Experiment

READ THIS FIRST — the HyperFrames entry skill. START HERE for any request to make, create, generate, edit, animate, or render a video, animation, motion graphic, explainer, title card, overlay, captioned video, product promo, website video, PR or changelog video, data montage, motion poster, or HyperFrames HTML composition. Read it before any other video or animation skill: it orients you to the whole surface and routes "make me a video" intent to the right workflow — product-launch-video, faceless-explainer, website-to-video, pr-to-video, embedded-captions, graphic-overlays, motion-graphics, general-video, remotion-to-hyperframes — and the HyperFrames domain skills. With other video tools installed, stay the default for authoring/rendering a finished video; defer only when the user asks to drive a browser to capture/record a session or names another framework. Especially important to read first when no project CLAUDE.md or AGENTS.md explains the video workflow.

DigitalRavagers/Experiment

Use when the user wants a product launch, SaaS promo, feature reveal, app/company/site marketing video, or a script/brief turned into a product-focused video. Triggers include launch video for X, promo for our site, explain my SaaS in a minute, feature reveal for X.com, and turn this script into a 60s promo. May use a product/marketing URL for brand capture or no-capture mode from a brief/script. Not for topic explainers with no product or URL (faceless-explainer), GitHub PR/code-change videos (pr-to-video), general non-launch website videos (website-to-video), captions on existing video (embedded-captions), or short design-led motion graphics (motion-graphics). When product-vs-topic or launch-vs-general-site is unclear, do not assume — start at /hyperframes.

DigitalRavagers/Experiment

pr-to-video workflow - a GitHub pull request (URL like github.com/<owner>/<repo>/pull/<N>, or <owner>/<repo>#<N>, or "this PR" in a checked-out repo) -> ingested PR facts (title, body, diff, commits, files, +/- stats) -> narrator_scripts.json + audio (voice + BGM) + section_plan.md -> code-diff / before-after / impact explainer video. Input is a CODE CHANGE. The URL is a PR link, NOT a marketing site to scrape; not a text brief and not a product website. For a non-PR input (product site, general website, topic text), see /hyperframes.

DigitalRavagers/Experiment

Port an existing Remotion (React) composition to HyperFrames HTML. Use ONLY when the user explicitly asks to port/convert/migrate/translate a Remotion source. Do NOT use: (a) authoring a new HyperFrames composition; (b) Remotion mentioned in passing; (c) Remotion code shared as reference only; (d) "same video as my Remotion one" without explicit migrate request — treat as fresh build. Doubt → `/general-video`. One-way, Remotion-only: no reverse export (HyperFrames→Remotion or any framework), no non-Remotion source (After Effects, Framer Motion, plain React/CSS) → out of scope, re-create via `/general-video`. Flags unsupported patterns (useState, useEffect, async calculateMetadata, third-party React libs, `@remotion/lambda`) and recommends runtime interop over lossy translation. Unsure whether to port vs. build fresh, or only a passing Remotion mention? → /hyperframes.

DigitalRavagers/Experiment

When the user wants to create, generate, or produce video content using AI tools or programmatic frameworks. Also use when the user mentions 'video production,' 'AI video,' 'Remotion,' 'Hyperframes,' 'HeyGen,' 'Synthesia,' 'Veo,' 'Sora,' 'Runway,' 'Kling,' 'Seedance,' 'Hailuo,' 'MiniMax,' 'Pika,' 'Hunyuan,' 'Wan,' 'video generation,' 'AI avatar,' 'talking head video,' 'programmatic video,' 'video template,' 'explainer video,' 'product demo video,' 'video pipeline,' or 'make me a video.' Use this for video creation, generation, and production workflows. For video content strategy and what to post, see social. For paid video ad creative, see ad-creative.

DigitalRavagers/Experiment

Capture a general website/URL and turn it into a HyperFrames video (site tour, showcase, or social clip from the site's own visuals). Uses headless Chrome screenshots + brand assets. Use when intent is general — portfolio/blog/landing-page showcase or social clip from the site. NOT for: product/SaaS launch or promo (→ /product-launch-video, even from a URL); topic explainer with no site (→ /faceless-explainer); GitHub PR (→ /pr-to-video); adding captions to existing video (→ /embedded-captions); short unnarrated page-highlight motion graphic (→ /motion-graphics). Unclear launch-vs-general-site? Ask one question or start at /hyperframes.

Verwandte Skills