Communitygithub.com

Elis3omndz/Claude_Skills

Der HyperFrames-Kompositionsvertrag – erstelle ein renderbares Projekt. Verwende ihn für Kompositionsstruktur, `data-*`-Timing-Attribute, `class="clip"`, Tracks, Sub-Kompositionen, Variablen, Framework-eigene Medienwiedergabe, deterministische Render-Regeln und Validierung. Vor dem Schreiben von Kompositions-HTML lesen.

Was ist Claude_Skills?

Diese Skill-Definition beschreibt den zentralen Vertrag von HyperFrames, einem Framework, das Video aus HTML rendert. Sie legt fest, wie eine HyperFrames-Komposition aufgebaut sein muss, damit die Laufzeitumgebung sie korrekt verarbeitet. Die Skill enthält alle technischen Regeln, um eine renderbare HTML-Datei zu erstellen: die Verwendung von `data-*`-Attributen für das Timing, die Struktur von Tracks und Clips, die Einbindung von Sub-Kompositionen, Variablen und Medien sowie die Regeln für deterministisches Rendering. Besonders wichtig sind die "Agent Pitfalls", die häufige Fehler wie Konflikte zwischen CSS-Transform und GSAP-Tweening oder das versehentliche Verstecken von Clips vermeiden. Die Skill verweist auf viele Referenzdokumente, die für spezifische Themen wie minimale Kompositionen, Muster, Datenattribute, Sub-Kompositionen und Determiniertheitsregeln zuständig sind. Sie richtet sich vor allem an Entwickler, die HyperFrames-Kompositionen in Claude Code, Cursor oder ähnlichen KI-Agenten-Tools erstellen oder bearbeiten.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Elis3omndz/Claude_Skills/tree/HEAD/.claude/skills/hyperframes-core

In Ihrer bevorzugten KI fragen

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

Dokumentation

Plugin-Installation: Bevor Setup- oder Aktualisierungsbefehle ausgeführt werden, befolge die Plugin-Installationsregeln, wenn sich diese Skill innerhalb eines HyperFrames-Plugins befindet. Bei eigenständigen Installationen gelten die untenstehenden Aktualisierungshinweise.

HyperFrames Core

Agent-Fallstricke (zuerst lesen):

  • Zentriere mit Flex/inset, nicht mit CSS transform: translate(-50%,-50%) auf einem Knoten, den du dann mit GSAP x/y animierst. Lint: gsap_css_transform_conflict. Verwende fromTo oder xPercent/yPercent.
  • Füge keinen Szenen-Exit tl.set(..., {visibility:"hidden"}) hinzu. Die Laufzeitumgebung blendet zeitgesteuerte Clips bereits aus. Deckkraft-Überblendungen auf inneren Knoten (oder opacity auf .clip) sind ausreichend. Caption-Hard-Kills unterliegen einer anderen Regel.
  • window.__timelines["id"] muss mit der Wurzel-data-composition-id übereinstimmen.
  • Nach dem render lies die zweite Zeile der Zusammenfassung: beginframe vs screenshot, GPU-Modus, Stage-Timings. screenshot + software gpu auf Linux ist der langsame Pfad.

HyperFrames rendert Video aus HTML. Eine Komposition ist eine HTML-Datei, deren DOM das Timing mit data-*-Attributen deklariert, deren Animations-Laufzeitumgebung durchsuchbar ist und deren Medienwiedergabe dem Framework gehört.

Diese Skill ist der technische Vertrag – wie man ein HyperFrames-Projekt erstellt. Der folgende Text ist der Bauleitfaden; detaillierte Informationen zu den einzelnen Themen befinden sich in references/ (siehe Index unten), bei Bedarf lesen. Prozessdokumente (Briefing, Storyboard, Review, Produktion, Dispatch, Frame-Worker) befinden sich in /hyperframes → references/. Andere Belange befinden sich in den benachbarten Domain-Skills – hyperframes-animation, hyperframes-creative, media-use, hyperframes-cli, hyperframes-registry. Die Fähigkeitskarte in /hyperframes zeigt, was jeder Bereich abdeckt.

Referenzen

DateiLies sie, um…
references/minimal-composition.mdmit dem kleinstmöglichen renderbaren Kompositionsskelett zu beginnen
references/composition-patterns.mdmonolithisch vs. modular zu wählen; eine modulare index.html zu strukturieren; einen Sub-Kompositions-Archetyp auszuwählen
references/data-attributes.mdjedes data-* (root / clip / sub-comp host / legacy Aliase) nachzuschlagen; class="clip" zu verwenden
references/tracks-and-clips.mdzu verstehen, was data-track-index steuert (und was nicht), z-index, einen Clip relativ zu einem anderen zu timen; jeden Track und Clip mit npx hyperframes timeline aufzulisten
references/creator-editing-recipes.mdwahrheitsgemäße Cut/Trim/Reorder/Retime/Freeze/Camera/Mask/Crossfade/Audio-Bearbeitungsrezepte und deren Grenzen zu kopieren
references/sub-compositions.mdeine Sub-Komposition einzurichten (Host-Attribute, <template>, Instanz-Variablen) und darin zu animieren
references/variables-and-media.mdVariablen zu deklarieren; <video>/<audio> zu platzieren, Lautstärke einzustellen, zu trimmen
references/determinism-rules.mdeine durchsuchbare Timeline zu erstellen; Determiniertheitsverbote; Layout / Textanpassung
references/full-screen-motion.mdVollbild-Bewegung mit gemeinsamen Hintergründen zu erstellen
references/tailwind.mdin einem Tailwind v4-Projekt zu arbeiten (init --tailwind; Laufzeitvertrag unterscheidet sich von Studio v3)

Informationen zu den Besonderheiten der Animations-Laufzeitumgebungen (GSAP-API, Lottie, Three.js usw.) findest du unter hyperframes-animation → adapters/<runtime>.md.

Eine Komposition erstellen

Zwei Wurzelformen (nicht austauschbar)

  • Eigenständig (top-level index.html): Die Wurzel <div data-composition-id="…"> befindet sich direkt im <body>, kein <template>-Wrapper. Wenn eine eigenständige Wurzel umschlossen wird, werden alle Inhalte ausgeblendet, und lint lehnt dies ab (standalone_composition_wrapped_in_template, error).
  • Sub-Komposition (geladen über data-composition-src): Umschließe die Wurzel mit <template>. Dies ist die zu schreibende Form: Der Loader akzeptiert auch ein vollständiges Dokument und greibt auf seinen <body> zurück, aber die Vorlagenform wird in den Beispielen und Tools vorausgesetzt.

⚠ Transportregel: Bei einer vorlagenbasierten Sub-Komposition verwirft der Assembler die eigenen <head> <style>/<script>-Elemente der Datei (packages/core/src/compiler/compositionAssembly.ts, der hasTemplate-Gate), also platziere <style>/<script> innerhalb des Templates. <link> wird in beiden Fällen nach oben gezogen. ⚠ Host-ID-Konvention: Gib dem Host-Slot, dem inneren Template und dem window.__timelines["<id>"]-Schlüssel die gleiche ID. Eine andere lokale ID wird unterstützt (der Assembler greift auf die erste Wurzel in der Datei zurück), aber die Abweichung ist still, also verwende identische IDs, es sei denn, du hast einen Grund dagegen.

Dateiform, Host-Verdrahtung und die Pre-Render-Checkliste → references/sub-compositions.md.

Wurzel muss dimensioniert sein (stiller Layout-Fehler)

Die eigenständige Wurzel verwendet width/height: 100%. Die Leinwandgröße wird durch data-width/data-height bestimmt. Die Laufzeitumgebung überträgt diese Pixel auf den Kompositionsstamm. Hardcodiere nicht 1920px/1080px auf #root. Gerüst → references/minimal-composition.md.

Eine pausierte Timeline

Jede Komposition registriert genau eine gsap.timeline({ paused: true }) bei window.__timelines["<id>"] (Schlüssel = root data-composition-id). Das Erstellen innerhalb eines asynchronen Callbacks (document.fonts.ready) wird unterstützt; wichtig ist, dass du erst nach Abschluss der Erstellung registrierst. Die Renderlänge ergibt sich aus der data-duration der Wurzel, nicht aus der Länge der Timeline: Eine Timeline, die darüber hinausläuft, wird abgeschnitten, und eine, die vorzeitig endet, behält ihren letzten Frame. Wenn die data-duration der Wurzel weggelassen wird, wird die Länge stattdessen abgeleitet (Timeline, Medienfenster oder Adapter). Du benötigst window.__timelines = window.__timelines || {} nicht: Die Laufzeitumgebung erstellt das Register, bevor deine Inline-Skripte ausgeführt werden, und lint verlangt es nicht mehr. Verschachtele Sub-Timelines nicht manuell in den Host; die Laufzeitumgebung verschachtelt registrierte Child-Timelines automatisch. Vollständiger Vertrag (inkl. Nicht-GSAP-Laufzeitumgebungen) → references/determinism-rules.md + hyperframes-animation/adapters/.

First-Pass-Lint-Fallen (garantierter erster Build-Fehler)

Regeln, die lint zwar abfängt, aber erst im Nachhinein. Schreibe sie gleich richtig:

  • Kombiniere niemals einen initialen CSS-transform mit einem GSAP-Tween auf der gleichen Eigenschaft – der CSS-Wert und der Start des Tweens kämpfen gegeneinander, und lint lehnt es mit gsap_css_transform_conflict ab. Setze den Anfangszustand innerhalb des Tweens mit gsap.fromTo(el, { x: -40 }, { x: 0 }) anstelle eines CSS transform: translateX(-40px).
  • Setze niemals crossorigin auf <video>/<audio>. lint lehnt es bedingungslos mit media_crossorigin_breaks_preview (error) ab, auch für Canvas/WebGL/WebAudio-Rücklese. Es gibt keine Unterdrückung.
  • Gib einem <video data-start> niemals einen Vorfahren, der ebenfalls data-start trägt. lint lehnt es mit video_nested_in_timed_element (error) ab. Time den Wrapper oder das Video, nicht beides.
  • Jedes <audio> benötigt eine id. lint lehnt es mit media_missing_id ab, und ein <audio> ohne ID wird vom Mischer nie erfasst, daher ist der Render stumm.
  • Tweene niemals einen .clip mit autoAlpha oder visibility – lint lehnt es mit gsap_animates_clip_element ab. Animierte stattdessen ein Kindelement.
  • Ein benannter CSS-font-family benötigt einen @font-face in der Datei, der auf eine ausgelieferte lokale Datei verweist, sonst wird font_family_without_font_face ausgelöst.
  • Sub-Komposition #root verwendet width/height: 100% (oder inset: 0), nicht hartcodierte 1920px/1080px. Die Leinwandgröße ist data-width/data-height.

Ein Lint-Error schaltet auch die Layout- und Kontrastprüfungen aus: check meldet dann 0 sample(s) und 0/0 text checks, was wie eine saubere Datei aussieht, aber bedeutet, dass nichts gelaufen ist. Behebe Lint-Fehler, bevor du diesen Zahlen vertraust.

Unverhandelbare Regeln (stille Fehler, die automatisierte Gates übersehen können)

Hier aufgeführt; vollständige Begründung in der verlinkten Referenz. Nicht verletzen:

  • Keine Laufzeituhren / ungesähtes Math.random / Netzwerk / Eingabezustand; repeat: -1 nur unter einer endlichen Wurzel-data-duration (exportiere Clips darauf – andernfalls verwende eine endliche Anzahl). → determinism-rules.md
  • Tweene niemals display, visibility oder autoAlpha auf einem .clip-Element. Das Framework verwaltet die Clip-Sichtbarkeit, und lint lehnt es ab (gsap_animates_clip_element). Animierte stattdessen ein Kindelement. → determinism-rules.md
  • Keine <br> im Fließtext; transformierte Elemente müssen blockartig + dimensioniert sein; pulsierende absolute Dekorationselemente benötigen Spitzenfreiheit. → determinism-rules.md
  • <video>/<audio> werden durch eine flache Dokumentabfrage gefunden, daher sucht und dekodiert das Framework sie in jeder Verschachtelungstiefe (auch innerhalb eines Sub-Kompositions-<template> oder Wrappers). Eine harte Grenze: lint meldet einen Fehler, wenn ein <video data-start> innerhalb eines anderen einfachen Elements mit ebenfalls data-start sitzt, und der Fehler ist real (falsche Quellframes, dann verschwindet der Clip mitten im Slot), also platziere das Timing auf dem Wrapper oder auf dem Video, niemals auf beiden. Sub-Kompositions-Hosts sind ausgenommen: Medien in einer Sub-Komposition werden korrekt gerendert. Die andere Einschränkung betrifft Timelines, nicht die Platzierung: Eine Sub-Kompositions-Timeline kann keine Host-Wurzel-Elemente animieren. → variables-and-media.md
  • Halte jede id über die assemblierte Seite hinweg eindeutig (präfixiere Sub-Kompositions-IDs mit der Kompositions-ID, #<id>-hero), damit deine eigenen #id-CSS- und getElementById-Aufrufe auflösen. Die Frame-Injektion hängt nicht mehr davon ab: Der Compiler stempelt eine dokumenteindeutige data-hf-render-id auf jedes video[src]/audio[src]/img[src]. Medien, die <source>-Kinder anstelle eines src-Attributs verwenden, werden nicht gestempelt, daher sind eindeutige IDs dort weiterhin wichtig. → composition-patterns.md
  • Eine Vollbildfüllung auf dem Kompositions-stamm ist bei einem normalen Render in Ordnung. Sie wird nur auf dem geschichteten Composite-Pfad (HDR-Inhalt oder eine Komposition mit Shader-Übergängen) entfernt, wo die Engine jeden Kompositionsstamm transparent macht, damit die darunter liegende Schicht durchscheint. Wenn deine Komposition Shader-Übergänge oder HDR-Medien verwendet, setze die Füllung auf ein vollflächiges Kind (position:absolute; inset:0). → composition-patterns.md

Vorhandene Kompositionen bearbeiten

  • Lies die Dateien zuerst. Erhalte nicht verwandte Timings, Tracks, IDs, Variablen, Medienpfade.
  • Um zu erfahren, was sich auf der Timeline eines Projekts befindet (Tracks, Clips, Start, Ende, was abgespielt wird), führe npx hyperframes timeline [--json] aus, anstatt index.html und jede Sub-Kompositionsdatei zu lesen.
  • Verwende bestehende Kompositions-IDs und Timeline-Schlüssel.
  • Einen Clip hinzufügen: Setze sein data-start/data-duration absichtlich in Bezug auf die umliegenden Clips. data-track-index ist eine Studio-Anzeigespur, keine Timing-Einschränkung, daher muss sie nicht frei sein.
  • Ein Clip, der nach der Wurzel-data-duration endet, wird abgeschnitten: Erweitere die Wurzel-data-duration bis zum Ende des Clips in derselben Bearbeitung (lint warnt clip_ends_past_root_duration).
  • data-hidden auf einem Kompositionselement blendet es sowohl in der Vorschau als auch im Render aus und überschreibt sein Zeitfenster; es ist nicht destruktiv/umkehrbar und wird durch das Timeline-Augen-Symbol von Studio umgeschaltet.
  • Eine Sub-Komposition hinzufügen: Überprüfe ihre interne data-composition-id, bevor du den Host verdrahtest.

Validierung

Verwende hyperframes-cli für Befehlsdetails

  • npx hyperframes check bestanden (0 Befunde bei Lint, Laufzeit, Layout, Bewegung und Kontrast)
  • Projekte mit Sub-Kompositionen: npx hyperframes snapshot --at <midpoints> und jedes Bild überprüfen
  • npx hyperframes preview --background zur Überprüfung (der Benutzer kann alles in der Studio-Timeline bearbeiten, und der Server überlebt den aufrufenden Befehl)
  • npx hyperframes render erst nach Zustimmung des Benutzers

Individual skills in this repo

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

Elis3omndz/Claude_Skills

Add captions or subtitles to an existing single-subject talking-head video without editing the footage. Use for plain verbatim captions, cinematic captions embedded behind the subject, VFX captions, “炸/特效/酷炫字幕,” or a named identity from the 35-style catalog. Route by visual identity, not by backend engine. The quiet `anchor` rail is the default; embed every word only when the user explicitly wants a fully cinematic treatment. The workflow runs locally end to end, including transcription and subject matting; split multi-shot footage before applying it.

Elis3omndz/Claude_Skills

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

Elis3omndz/Claude_Skills

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). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

Elis3omndz/Claude_Skills

Use when audio already placed in a HyperFrames composition needs to be mixed: fade-in/fade-out, crossfade, track gain or volume, volume automation, ducking, a music bed that fights a voiceover (voiceover carve), effects on a track (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), automation envelopes drawn on a track's volume or any effect parameter, or one submix bus carrying a chain, a fader and an automation clock for several tracks at once (`<hf-audio-group>`). Don't use for sourcing or generating audio — finding BGM, SFX, or making a voiceover is `/media-use`. Don't use for clip timing or track layout, which is `/hyperframes-core`.

Elis3omndz/Claude_Skills

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

Elis3omndz/Claude_Skills

Use when a HyperFrames composition needs a punch-in, punch-out, zoom, reframe, Ken Burns treatment, camera move, visual match/whip handoff, or other seek-safe 2D/3D keyframes; also for GSAP, CSS keyframes, Anime.js, WAAPI, FLIP, paths, masks, SVG morph/draw, text trails, 3D depth, or `hyperframes keyframes` diagnostics. Don't use for broad scene strategy, brand design, media sourcing, captions, or general video planning.

Elis3omndz/Claude_Skills

Use when working with a person on a HyperFrames project in Studio: first, whether their message asks for a change at all (questions, loose ideas and "don't change anything" get an answer and a plan, not an edit); for a new film, the plan, storyboard and build order that the HyperFrames launch films follow; and how the timeline should be laid out so it reads well (one caption track, one element kind per track, every scene a sub-composition) and where captions and key content may sit (safe zones). Don't use for how to perform an individual edit (split, trim, retime, volume, copy, swap): that is `creator-editing-recipes.md` in `/hyperframes-core`.

Elis3omndz/Claude_Skills

A short, design-led motion graphic where motion is the message — kinetic typography, stat count-up, chart/data-viz hit, logo sting / brand lockup, lower-third / callout / social overlay, animated map (highlight regions, connect places, zoom to a location), animated tweet / news-article / headline, webpage / UI animation (scroll, cursor, callouts), or fusing a real image's geometry into a chart. Usually under 10s (up to ~30s), no narration or live-action subject; renders to MP4 or transparent overlay. Longer / narrated / multi-scene → /general-video. Unclear → /hyperframes.

Elis3omndz/Claude_Skills

Turn a music track (an audio file, a video to pull audio from, or a track generated from a mood brief) into a beat-synced video — lyric video, slideshow, or kinetic promo. The music drives all pacing; any user-supplied images/videos are cut onto the same beat grid, and a complete video needs zero assets. Narrated pieces → the input-matched workflow (see /hyperframes). Unclear → /hyperframes.

Elis3omndz/Claude_Skills

Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.

Elis3omndz/Claude_Skills

Turn a GitHub pull request (a PR URL, owner/repo#N, or 'this PR' in a checked-out repo) into a code-change explainer video — changelog, feature reveal, fix, or refactor walkthrough built from the diff, commits, and files: the input is a code change, not a website. Not a product promo (/product-launch-video) or a no-PR topic explainer (/faceless-explainer). Unclear → /hyperframes.

Verwandte Skills