Communitygithub.com

Zuhair-01/claude-skills-and-systems

Der HyperFrames-Kompositionsvertrag – erstelle ein renderbares Projekt. Verwende dies für die Kompositionsstruktur, die `data-*`-Timing-Attribute, `class="clip"`, Tracks, Sub-Kompositionen, Variablen, framework-eigenes Media-Playback, deterministische Render-Regeln und Validierung. Lese dies vor dem Schreiben von Kompositions-HTML.

Was ist claude-skills-and-systems?

Dieses Skill beschreibt den technischen Vertrag von HyperFrames – einem Framework, das Video aus HTML rendert. Eine Komposition ist eine HTML-Datei, deren DOM-Timing mit `data-*`-Attributen deklariert wird, deren Animations-Laufzeit seekbar ist und deren Media-Playback vom Framework verwaltet wird. Der Skill enthält eine umfassende Build-Anleitung mit Referenzen zu minimalen Kompositions-Skeletten, Datenattributen, Tracks und Clips, Sub-Kompositionen, Variablen und Medien sowie Determinismus-Regeln. Besonders wichtig sind die vermiedenen Agenten-Fallstricke, wie der Konflikt zwischen CSS-Transform und GSAP-Tween, das korrekte Setzen von Compositing-IDs und die Beachtung von Lint-Regeln, die viele typische Fehler abfangen. Das Skill unterstützt sowohl eigenständige Kompositionen als auch Sub-Kompositionen und stellt sicher, dass alle Render deterministisch und korrekt sind.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

HyperFrames Kern

Agenten-Fallstricke (zuerst lesen):

  • Zentriere mit flex/inset, nicht mit CSS transform: translate(-50%,-50%) auf einem Knoten, den du dann per 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 Laufzeit blendet getimte Clips bereits aus. Opazitäts-Überblendungen auf inneren Knoten (oder opacity auf .clip) sind ausreichend. Caption-Hard-Kills folgen einer anderen Regel.
  • window.__timelines["id"] muss mit der Root data-composition-id übereinstimmen.
  • Nach render lies die zweite Zeile der Zusammenfassung: beginframe vs. screenshot, GPU-Modus, Stufen-Timings. screenshot + software gpu unter 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-Laufzeit seekbar ist und deren Media-Playback vom Framework verwaltet wird.

Dieses Skill ist der technische Vertrag – wie man ein HyperFrames-Projekt erstellt. Der folgende Text ist der Build-Leitfaden; detaillierte Themen finden sich in references/ (Index siehe nächster Abschnitt), auf Abruf lesen. Prozessdokumente (Briefing, Storyboard, Review, Produktion, Dispatch, Frame-Worker) leben in /hyperframes → references/. Andere Belange leben in den benachbarten Domain-Skills – hyperframes-animation, hyperframes-creative, media-use, hyperframes-cli, hyperframes-registry. Die Fähigkeitskarte in /hyperframes sagt, was jedes Skill abdeckt.

Referenzen

DateiLies es, um…
references/minimal-composition.mdvom kleinsten renderbaren Kompositions-Skelett zu starten
references/composition-patterns.mdmonolithisch vs. modular zu wählen; ein modulares index.html zu strukturieren; einen Sub-Kompositions-Archetyp auszuwählen
references/data-attributes.mdjedes data-*-Attribut (Root / Clip / Sub-Komp-Host / Legacy-Alias) nachzuschlagen; class="clip" zu verwenden
references/tracks-and-clips.mdzu verstehen, was data-track-index (nicht) steuert, z-index, einen Clip relativ zu einem anderen zu timen; jeden Track und Clip mit npx hyperframes timeline aufzulisten
references/creator-editing-recipes.mdwahrheitsgetreue Cut/Trim/Reorder/Retime/Freeze/Camera/Mask/Crossfade/Audio-Bearbeitungsrezepte und ihre Grenzen zu kopieren
references/sub-compositions.mdeine Sub-Komposition zu verdrahten (Host-Attribute, <template>, Instanz-Variablen) und darin zu animieren
references/variables-and-media.mdVariablen zu deklarieren; <video>/<audio> zu platzieren, Lautstärke und Trimmung einzustellen
references/determinism-rules.mdeine seekbare Timeline zu bauen; Determinismus-Verbote; Layout / Textfit
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)

Für Details zur Animations-Laufzeit (GSAP API, Lottie, Three.js, etc.) gehe zu hyperframes-animation → adapters/<runtime>.md.

Eine Komposition erstellen

Zwei Root-Formen (nicht austauschbar)

  • Eigenständig (Top-Level index.html): Root <div data-composition-id="…"> direkt im <body>, kein <template>-Wrapper. Das Umwickeln einer eigenständigen Root versteckt den gesamten Inhalt und lint lehnt es ab (standalone_composition_wrapped_in_template, Fehler).
  • Sub-Komposition (geladen via data-composition-src): Wickle die Root in <template>. Dies ist die zu schreibende Form: der Loader akzeptiert auch ein reines vollständiges Dokument und fällt auf dessen <body> zurück, aber die getemplatete Form wird von den Beispielen und Tools erwartet.

⚠ Transportregel: Bei einer getemplateten Sub-Komposition verwirft der Assembler die eigenen <head>-<style>/<script> des Compilers (packages/core/src/compiler/compositionAssembly.ts, das hasTemplate-Gate). Platziere daher <style>/<script> innerhalb des Templates. <link> wird in beiden Fällen nach oben gehievt. ⚠ Host-ID-Konvention: Gib dem Host-Slot, dem inneren Template und dem window.__timelines["<id>"]-Schlüssel dieselbe ID. Eine andere lokale ID wird unterstützt (der Assembler fällt auf die erste Root in der Datei zurück), aber die Diskrepanz ist still, also stimme sie überein, es sei denn, du hast einen Grund dagegen.

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

Root muss dimensioniert sein (stiller Layout-Bug)

Die eigenständige Root setzt width/height: 100%. Die Leinwandgröße ist data-width/data-height. Die Laufzeit drückt diese Pixel auf die Kompositions-Root. Harte 1920px/1080px nicht auf #root setzen. Skelett → references/minimal-composition.md.

Eine pausierte Timeline

Jede Komposition registriert genau eine gsap.timeline({paused: true}) unter window.__timelines["<id>"] (Schlüssel = Root data-composition-id). Der Aufbau innerhalb eines asynchronen Callbacks (document.fonts.ready) wird unterstützt; wichtig ist, dass du erst registrierst, nachdem der Aufbau abgeschlossen ist. Die Renderlänge ist die Root data-duration, nicht die Timeline-Länge: eine Timeline, die darüber hinausläuft, wird abgeschnitten, und eine, die vorzeitig endet, hält ihren letzten Frame. Fehlt die Root data-duration, wird die Länge stattdessen inferiert (Timeline, Media-Fenster oder Adapter). Du brauchst kein window.__timelines = window.__timelines || {}: die Laufzeit erstellt das Register, bevor deine Inline-Skripte laufen, und lint verlangt es nicht mehr. Verschachtle keine Sub-Timelines manuell im Host; die Laufzeit verschachtelt registrierte Child-Timelines automatisch. Vollständiger Vertrag (inkl. Nicht-GSAP-Laufzeiten) → references/determinism-rules.md + hyperframes-animation/adapters/.

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

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

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

Ein lint-Fehler schaltet auch die Layout- und Kontrast-Audits 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 Bugs, die automatisierte Gates übersehen können)

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

  • Keine Laufzeit-Uhren / ungesäter Math.random / Netzwerk / Eingabezustand; kein repeat: -1 (endliche Anzahl verwenden). → determinism-rules.md
  • Tweene niemals display, visibility oder autoAlpha auf einem .clip-Element. Das Framework besitzt die Clip-Sichtbarkeit, und lint lehnt es ab (gsap_animates_clip_element). Animiere stattdessen ein Kind. → determinism-rules.md
  • Kein <br> im Fließtext; transformierte Elemente müssen block-level + dimensioniert sein; pulsierende absolute Dekorationen benötigen Spitzenabstand. → determinism-rules.md
  • <video>/<audio> werden durch eine flache Dokumentabfrage gefunden, das Framework sucht und dekodiert sie in jeder Verschachtelungstiefe (auch innerhalb eines Sub-Komp-<template> oder Wrappers). Eine harte Grenze: lint meldet einen Fehler, wenn ein <video data-start> in einem anderen einfachen Element sitzt, das ebenfalls data-start hat, und der Fehler ist real (falsche Quellframes, dann verschwindet der Clip mitten im Slot). Setze das Timing auf den Wrapper oder auf das Video, niemals auf beide. Sub-Kompositions-Hosts sind ausgenommen: Medien innerhalb einer Sub-Komposition rendern korrekt. Die andere Einschränkung betrifft Timelines, nicht die Platzierung: eine Sub-Komp-Timeline kann keine Host-Root-Elemente animieren. → variables-and-media.md
  • Halte jede id über die assemblierte Seite hinweg eindeutig (präfixiere Sub-Komp-IDs mit der Kompositions-ID, #<id>-hero), damit deine eigenen #id-CSS- und getElementById-Aufrufe funktionieren. Frame-Injektion hängt nicht mehr davon ab: der Compiler drückt 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 Vollbild-Füllung auf der Kompositions-Root ist bei einem normalen Render in Ordnung. Sie wird nur auf dem Layered-Composite-Pfad (HDR-Inhalt oder eine Komposition mit Shader-Übergängen) fallengelassen, wo die Engine jede Kompositions-Root transparent macht, damit die darunterliegende Ebene durchscheint. Wenn deine Komposition Shader-Übergänge oder HDR-Medien verwendet, platziere die Füllung auf einem vollflächigen Child (position:absolute; inset:0). → composition-patterns.md

Vorhandene Kompositionen bearbeiten

  • Lese zuerst die Dateien. Behalte nicht verwandtes Timing, Tracks, IDs, Variablen, Medienpfade bei.
  • Um zu erfahren, was sich auf der Timeline eines Projekts befindet (Tracks, Clips, Starts, Enden, was läuft), führe npx hyperframes timeline [--json] aus, anstatt index.html und jede Sub-Kompositionsdatei zu lesen.
  • Stimme vorhandene Kompositions-IDs und Timeline-Schlüssel ab.
  • Hinzufügen eines Clips: setze sein data-start/data-duration bewusst gegen die umliegenden Clips. data-track-index ist eine Studio-Anzeigespalte, keine Timing-Einschränkung, muss also nicht frei sein.
  • data-hidden auf jedem 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 im Studio umgeschaltet.
  • Hinzufügen einer Sub-Komposition: überprüfe ihre interne data-composition-id, bevor du den Host verdrahtest.

Validierung

Verwende hyperframes-cli für Befehlsdetails

  • npx hyperframes check besteht (0 Befunde über Lint, Laufzeit, Layout, Bewegung und Kontrast)
  • Projekte mit Sub-Kompositionen: npx hyperframes snapshot --at <midpoints> und jedes Frame begutachten
  • npx hyperframes preview --background für die Ü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 9 individual skills — each has its own dedicated page.

Zuhair-01/claude-skills-and-systems

Create AI avatar videos with precise control over avatars, voices, scripts, scenes, and backgrounds using HeyGen's v2 API. Use when: (1) Choosing a specific avatar and voice for a video, (2) Writing exact scripts for an avatar to speak, (3) Building multi-scene videos with different backgrounds per scene, (4) Creating transparent WebM videos for compositing, (5) Using talking photos as video presenters, (6) Integrating HeyGen avatars with Remotion, (7) Batch video generation with exact specs, (8) Brand-consistent production videos with precise control.

Zuhair-01/claude-skills-and-systems

Generate Mandarin and multilingual narration with Volcengine Doubao Speech 2.0. Use when creating Chinese voiceovers, when the user prefers Doubao/Volcengine/火山引擎/豆包 TTS, or when narration needs character-level timestamp metadata for subtitles.

Zuhair-01/claude-skills-and-systems

Edit existing videos using AI — remix style, upscale, remove background, and add audio via fal.ai's hosted video models.

Zuhair-01/claude-skills-and-systems

Video and audio processing with FFmpeg. Use for format conversion, resizing, compression, audio extraction, and preparing assets for Remotion. Triggers include converting GIF to MP4, resizing video, extracting audio, compressing files, or any media transformation task.

Zuhair-01/claude-skills-and-systems

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.

Zuhair-01/claude-skills-and-systems

Read-only queue dashboard for workspace-aware ship. (gstack)

Zuhair-01/claude-skills-and-systems

Generate HeyGen presenter videos via the v3 Video Agent pipeline — handles Frame Check (aspect ratio correction), prompt engineering, avatar resolution, and voice selection. Required for any HeyGen video generation. Replaces deprecated endpoints with v3. Use when: (1) generating any HeyGen video (via API or otherwise), (2) sending a personalized video message (outreach, update, announcement, pitch, knowledge), (3) creating a HeyGen presenter-led explainer, tutorial, or product demo with a human face, (4) "make a video of me saying...", "send a video to my leads", "record an update for my team", "create a video pitch", "make a loom-style message", "I want to appear in this video", "generate a HeyGen video", "make a talking head video". Accepts avatar_id from heygen-avatar for identity-first HeyGen videos, or uses a stock presenter. Returns video share URL + HeyGen session URL for iteration. Chain signal: when the user wants to create/design an avatar AND make a video in the same request, run heygen-avatar f...

Zuhair-01/claude-skills-and-systems

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.

Zuhair-01/claude-skills-and-systems

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

Verwandte Skills