Communitygithub.com

dbillion/hermes-skills-public

Der HyperFrames-Kompositionsvertrag – baue ein renderbares Projekt. Verwendung für Kompositionsstruktur, die `data-*` Timing-Attribute, `class="clip"`, Tracks, Sub-Kompositionen, Variablen, framework-eigene Medienwiedergabe, deterministische Rendering-Regeln und Validierung. Deckt auch Tailwind-Projekte und die STORYBOARD.md / SCRIPT.md Planformate ab. Vor dem Schreiben von Kompositions-HTML lesen.

Was ist hermes-skills-public?

Dieser Skill definiert den technischen Vertrag für HyperFrames, ein Framework, das Video aus HTML rendert. Eine Komposition ist eine HTML-Datei, deren DOM die zeitliche Abfolge mittels `data-*` Attributen deklariert, deren Animationslaufzeit suchbar ist und deren Medienwiedergabe vom Framework gesteuert wird. Er richtet sich an Entwickler, die HyperFrames-Projekte erstellen – sei es eigenständig oder als Sub-Komposition – und deckt alle wesentlichen Aspekte ab: Kompositionsstruktur, Timing-Attribute, Tracks und Clips, Sub-Kompositionen, Variablen und Mediennutzung, sowie strikte Determinismus-Regeln, die ein suchbares und reproduzierbares Rendering gewährleisten. Der Skill listet detaillierte Referenzdokumente auf, die jeweils spezifische Themen wie minimale Kompositionen, Sub-Kompositionsverkabelung, Animationsattribute und Produktionsabläufe vertiefen. Er behandelt auch Tailwind v4 Projekte und die Formate `STORYBOARD.md` und `SCRIPT.md` für die Planung und Skripterstellung. Spezifische Validierungsschritte mit dem `hyperframes-cli` werden beschrieben, um sicherzustellen, dass Projekte lint-, layout-, animations- und kontrastkonform sind.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dbillion/hermes-skills-public/tree/HEAD/skills-external/hyperframes-core

In Ihrer bevorzugten KI fragen

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

Dokumentation

HyperFrames Kern

HyperFrames rendert Video aus HTML. Eine Komposition ist eine HTML-Datei, deren DOM mit data-* Attributen die zeitliche Abfolge deklariert, deren Animationslaufzeit suchbar ist und deren Medienwiedergabe vom Framework gesteuert wird.

Dieser 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/ (Index als nächstes), lese bei Bedarf nach. Andere Belange werden in den verwandten Domänen-Skills behandelt – hyperframes-animation, hyperframes-creative, media-use, hyperframes-cli, hyperframes-registry. Die Fähigkeitskarte in /hyperframes sagt, was jeder abdeckt.

Referenzen

DateiLies es, um…
references/minimal-composition.mdmit dem kleinsten renderbaren Kompositionsskelett zu beginnen
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-* (root / clip / sub-comp host / legacy Aliase) nachzuschlagen; class="clip" zu verwenden
references/tracks-and-clips.mddata-track-index zu wählen, Überlappungen / z-index auf demselben Track zu handhaben, einen Clip relativ zu einem anderen zu timen
references/sub-compositions.mdeine Sub-Komposition zu verdrahten (host-Attribute, <template>, pro-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 suchbare Zeitleiste zu bauen; Determinismus-Verbote; die Allowlist animierbarer Eigenschaften; Layout / Textanpassung
references/full-screen-motion.mdVollbild-Bewegung mit geteilten Hintergründen zu erstellen
references/storyboard-format.mdeinen STORYBOARD.md Plan zu erstellen (+ das geparste Manifest)
references/review-loop.mddie Plan → Skizze → Bau Review-Durchläufe auf einem Live-Board auszuführen – geteilt von jedem Storyboard-Planungs-Workflow
references/production-loop.mdeinen genehmigten Plan zu einem gelieferten Video zu führen – die Stufen-Abhängigkeiten (Audio, Frames, Assembly, Übergänge, Untertitel, Verifizieren, Liefern); ein freiformatierter Build folgt direkt
references/brief-contract.mddie Grundregeln des Briefings – Modus-Ableitung (kollaborativ / autonom), gemeinsames Feld-Register, Frage-Invarianten (das Fragen selbst lebt in /hyperframes → die Intentionsebene)
references/brief-format.mdBRIEF.md zu erstellen – das bestätigte Absichtsdokument, das der Setup eines Workflows schreibt und jeder spätere Schritt liest
references/script-format.mddas optionale SCRIPT.md fixierte Voiceover zu erstellen
references/subagent-dispatch.mdSubagenten-Dispatch-Verben (paralleles Fan-Out / Hintergrund / Warten) auf dein Harness abzubilden
references/tailwind.mdin einem Tailwind v4 Projekt zu arbeiten (init --tailwind; Laufzeitvertrag unterscheidet sich von Studios v3)

Für spezifische Animationslaufzeiten (GSAP API, Lottie, Three.js usw.) gehe zu hyperframes-animation → adapters/<runtime>.md.

Eine Komposition erstellen

Zwei Wurzelformen (nicht austauschbar)

  • Eigenständig (oberste Ebene index.html) – root <div data-composition-id="…"> sitzt direkt in <body>, kein <template>-Wrapper (das Einwickeln verbirgt alle Inhalte und bricht das Rendering).
  • Sub-Komposition (geladen über data-composition-src) – root muss in <template> eingewickelt sein.

⚠ Transport-Regel: die Laufzeit klont nur <template>-Inhalte; alles außerhalb (einschließlich <head>-Styles/Scripts) wird verworfen – platziere <style>/<script> innerhalb des Templates. ⚠ Host-ID-Regel: data-composition-id des Host-Slots muss exakt dem data-composition-id des inneren Templates und dem window.__timelines["<id>"]-Schlüssel entsprechen – kein -mount/-slot/-host-Suffix.

Dateistruktur, Host-Verkabelung und die Pre-Render-Checkliste → references/sub-compositions.md.

Root muss dimensioniert sein (stiller Layout-Fehler)

Der eigenständige Root benötigt eine explizite größenbestimmte Box (width/height in px), und jeder Vorfahre bis zu einem height:100%-Element muss eine aufgelöste Höhe haben – sonst kollabiert ein flex-/100%-Kind auf ~0 und Inhalte stapeln sich in der oberen linken Ecke. Verlasse dich nicht nur auf automatisierte Gates, um dies zu erkennen; überprüfe einen Schnappschuss. Skelett → references/minimal-composition.md.

Eine pausierte Zeitleiste

Jede Komposition registriert genau eine gsap.timeline({ paused: true }) bei window.__timelines["<id>"] (Schlüssel = root data-composition-id), die synchron beim Laden der Seite erstellt wird. Render-Dauer = root data-duration, nicht Zeitleistenlänge. Verschachtele nicht manuell Sub-Zeitleisten in den Host. Vollständiger Vertrag (einschließlich Nicht-GSAP-Laufzeiten) → references/determinism-rules.md + hyperframes-animation/adapters/.

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

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

  • Keine Renderzeit-Uhren / ungesätes Math.random / Netzwerk / Eingabezustand; kein repeat: -1 (endliche Anzahl verwenden). → determinism-rules.md
  • Nur die Allowlist visueller Eigenschaften animieren; niemals display oder rohes visibility tweenen. GSAP autoAlpha und Null-Dauer-Zeitleisten-Grenzen sind die einzigen Sichtbarkeitsausnahmen, und nur auf Nicht-Clip-Elementen oder Wrappern innerhalb eines Clips. Das Framework allein steuert die .clip-Sichtbarkeit. Nicht gsap.set für später erscheinende Clips beim Laden der Seite setzen. → determinism-rules.md
  • Kein <br> im Fließtext; transformierte Elemente müssen block-level + dimensioniert sein; pulsierende absolute dekorative Elemente benötigen Spitzenabstand. → determinism-rules.md
  • <video>/<audio> muss ein direktes Kind des Host-Roots sein (niemals innerhalb eines Sub-Kompositions-<template>/Wrappers); das Framework besitzt die Wiedergabe. → variables-and-media.md
  • Jede id muss auf der zusammengebauten Seite eindeutig sein; innerhalb einer Sub-Komposition IDs mit der Kompositions-ID präfixen (#<id>-hero. Doppelte <video>/<img>-IDs rendern leer – der Producer injiziert Frames per getElementById, und dateiübergreifende Duplikate entgehen lint. → composition-patterns.md
  • Eine full-screen Szenenfüllung gehört auf ein vollflächiges Kind (position:absolute; inset:0), niemals auf den Kompositions-Root selbst – die Rahmenkomposition des Producers kann den background des Root-Elements fallen lassen (der Rahmen rendert schwarz), selbst wenn die Vorschau/snapshot korrekt angezeigt wird. → composition-patterns.md

Vorhandene Kompositionen bearbeiten

  • Lies zuerst die Dateien. Erhalte nicht zusammenhängendes Timing, Tracks, IDs, Variablen, Medienpfade.
  • Gleiche vorhandene Kompositions-IDs und Zeitleisten-Schlüssel ab.
  • Hinzufügen eines Clips: wähle einen nicht überlappenden data-track-index oder passe das umgebende Timing bewusst an.
  • 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 vom Zeitleisten-Augen-Symbol von 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 erfolgreich (0 Ergebnisse über Lint, Laufzeit, Layout, Bewegung und Kontrast)
  • Projekte mit Sub-Kompositionen: npx hyperframes snapshot --at <midpoints> und überprüfe jedes Bild manuell
  • npx hyperframes preview für Review (der Benutzer kann alles in der Studio-Zeitleiste bearbeiten)
  • npx hyperframes render erst nach Genehmigung des Benutzers

Individual skills in this repo

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

dbillion/hermes-skills-public

Edit an existing image based on a text prompt.

dbillion/hermes-skills-public

Add `flutter_localizations` and `intl` dependencies, enable "generate true" in `pubspec.yaml`, and create an `l10n.yaml` configuration file. Use when initializing localization support for a new Flutter project.

dbillion/hermes-skills-public

Expert in video composition, editing, and format conversion. Use when the user wants to generate high-quality video, overlay images on video, concatenate clips, create GIFs, or sync audio to video using mcp-avtool-go and mcp-veo-go.

dbillion/hermes-skills-public

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.

dbillion/hermes-skills-public

Use the HyperFrames CLI development loop: init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, single or batch render, publish, cloud, cloudrun, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, auth, tts, and remove-background. Also use when diagnosing build or render failures. validate, inspect, and layout are deprecated aliases; use check. Covers local, HeyGen-hosted cloud, AWS Lambda, and Google Cloud Run rendering.

dbillion/hermes-skills-public

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

Verwandte Skills