Communitygithub.com

sansayan01/finance_app_zo

Der HyperFrames-Kompositionsvertrag – baue ein renderbares Projekt. Verwende diesen Skill für die Kompositionsstruktur, die `data-*`-Timing-Attribute, `class="clip"`, Tracks, Unterkompositionen, Variablen, framework-eigene Medienwiedergabe, deterministische Render-Regeln und Validierung. Deckt auch Tailwind-Projekte und die Planformate STORYBOARD.md / SCRIPT.md ab. Lies dies, bevor du Kompositions-HTML schreibst.

Was ist finance_app_zo?

Dieser Skill definiert den technischen Kernvertrag für HyperFrames, eine Engine, die Video aus HTML rendert. Eine Komposition ist eine HTML-Datei, deren DOM mit `data-*`-Attributen getimt wird, wobei die Animationslaufzeit suchbar und die Medienwiedergabe vom Framework kontrolliert wird. Der Skill beschreibt, wie man ein HyperFrames-Projekt aufbaut: von zwei unterschiedlichen Root-Formen (Standalone und Sub-Composition) über das Setzen von Größen, das Erstellen pausierter Timelines mit GSAP bis hin zu nicht verhandelbaren Regeln, die stille Fehler vermeiden. Er verweist auf eine umfangreiche Referenzsammlung (z. B. minimales Kompositions-Skelett, Datenattribute, Tracks & Clips, Unterkompositionen, Variablen & Medien, Determinismus-Regeln). Zudem behandelt er die Validierung mit der CLI (`npx hyperframes check`, `snapshot`, `preview`, `render`) und die Zusammenarbeit mit Tailwind-Projekten. Der Skill ist für Entwickler und KI-Agenten gedacht, die präzise, deterministisch renderbare Video-Kompositionen mit HyperFrames erstellen wollen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/sansayan01/finance_app_zo/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 das Timing mit data-*-Attributen deklariert, deren Animationslaufzeit suchbar ist und deren Medienwiedergabe dem Framework gehört.

Dieser Skill ist der technische Vertrag – wie man ein HyperFrames-Projekt erstellt. Der folgende Text ist der Bauleitfaden; detaillierte Themen leben in references/ (Index als nächstes), die bei Bedarf gelesen werden. Andere Belange sind in den zugehörigen Domän-Skills behandelt – hyperframes-animation, hyperframes-creative, media-use, hyperframes-cli, hyperframes-registry. Die Fähigkeitskarte in /hyperframes sagt, was jeder abdeckt.

Referenzen

DateiLesen, um…
references/minimal-composition.mdmit dem kleinsten renderbaren Kompositionsskelett zu beginnen
references/composition-patterns.mdmonolithisch vs. modular zu wählen; eine modulare index.html zu strukturieren; einen Sub-Kompositions-Archetyp zu wählen
references/data-attributes.mdjedes data-* (Root / Clip / Sub-Komp-Host / Legacy-Aliase) nachzuschlagen; class="clip" zu verwenden
references/tracks-and-clips.mddata-track-index auszuwählen, Überlappungen / z-Index innerhalb des gleichen Tracks zu handhaben, einen Clip relativ zu einem anderen zu timen
references/sub-compositions.mdeine Unterkomposition einzurichten (Host-Attribute, <template>, Instanzvariablen) und darin zu animieren
references/variables-and-media.mdVariablen zu deklarieren; <video>/<audio> zu platzieren, Lautstärke und Trimmung einzustellen
references/determinism-rules.mdeine suchbare Timeline zu bauen; Determinismus-Verbote; die Allowlist animierbarer Eigenschaften; Layout / Textanpassung
references/full-screen-motion.mdVollbild-Bewegung mit geteilten Hintergründen zu gestalten
references/storyboard-format.mdeinen STORYBOARD.md-Plan zu erstellen (+ das geparste Manifest)
references/brief-contract.mddie Erfassung eines Erstellungs-Workflows durchzuführen – Interaktionsmodus (kollaborativ / autonom), gemeinsame Brief-Felder, Frageregeln
references/script-format.mddas optionale, festgelegte SCRIPT.md-Erzähltext zu verfassen
references/subagent-dispatch.mdSubagent-Dispatch-Verben (paralleles Fan-out / Hintergrund / Warten) auf Ihre Umgebung abzubilden
references/tailwind.mdin einem Tailwind v4-Projekt zu arbeiten (init --tailwind; der Laufzeitvertrag unterscheidet sich von Studios v3)

Für Details zur Animationslaufzeit (GSAP-API, Lottie, Three.js usw.) siehe hyperframes-animation → adapters/<runtime>.md.

Eine Komposition erstellen

Zwei Root-Formen (nicht austauschbar)

  • Standalone (top-level index.html) – root <div data-composition-id="…"> steht direkt im <body>, kein <template>-Wrapper (ein Wrapper versteckt den gesamten Inhalt und bricht das Rendering).
  • Sub-Composition (geladen über data-composition-src) – root muss in <template> eingewickelt sein.

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

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

Root muss dimensioniert sein (stiller Layout-Bug)

Der Standalone-Root benötigt eine explizite dimensionierte Box (width/height in px), und jeder Vorfahre bis zu einem height:100%-Element muss eine aufgelöste Höhe haben – sonst fällt ein Flex-/100%-Kind auf ~0 zusammen und der Inhalt stapelt sich in der oberen linken Ecke. lint/validate/inspect fangen dies nicht. Skelett → 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), die synchron beim Seitenladen erstellt wird. Render-Dauer = root data-duration, nicht Timeline-Länge. Verschachtele keine Sub-Timelines manuell im Host. Vollständiger Vertrag (inkl. Nicht-GSAP-Laufzeiten) → references/determinism-rules.md + hyperframes-animation/adapters/.

Nicht verhandelbare Regeln (stille Fehler, die lint/validate/inspect nicht erkennen)

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

  • Keine Renderzeit-Uhren / ungesäter Math.random / Netzwerk / Eingabezustand; kein repeat: -1 (endliche Anzahl verwenden). → determinism-rules.md
  • Nur die visuelle Eigenschafts-Allowlist animieren; niemals display/visibility; kein gsap.set auf Clips späterer Szenen. → 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> muss ein direktes Kind des Host-Roots sein (niemals innerhalb eines Sub-Komp-<template>/Wrappers); das Framework besitzt die Wiedergabe. → variables-and-media.md
  • Jede id muss über die gesamte montierte Seite eindeutig sein; innerhalb einer Sub-Komp IDs mit der Kompositions-ID präfixieren (#<id>-hero). Doppelte <video>/<img>-IDs rendern leer – der Producer injiziert Frames per getElementById, und dateiübergreifende Dubletten entgehen lint. → composition-patterns.md
  • Ein Vollbild-Szenen-Fill gehört auf ein randloses Kind (position:absolute; inset:0), niemals auf den Kompositions-Root selbst – die Frame-Kompositionierung des Producers kann das eigene background des Root-Elements wegwerfen (das Frame rendert schwarz), obwohl Vorschau/snapshot es korrekt zeigen. → composition-patterns.md

Vorhandene Kompositionen bearbeiten

  • Lies zuerst die Dateien. Erhalte nicht zusammenhängende Zeitangaben, Tracks, IDs, Variablen, Medienpfade.
  • Stimme vorhandene Kompositions-IDs und Timeline-Schlüssel ab.
  • Einen Clip hinzufügen: wähle einen nicht überlappenden data-track-index oder passe die umgebende Zeit bewusst an.
  • data-hidden auf einem Kompositions-Element versteckt es sowohl in der VORSCHAU als auch im RENDER und überschreibt sein Zeitfenster; es ist nicht destruktiv/umkehrbar und wird vom 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 läuft durch (0 Funde bei lint, Laufzeit, Layout, Bewegung und Kontrast)
  • Projekte mit Sub-Kompositionen: npx hyperframes snapshot --at <midpoints> und jedes Bild begutachten
  • npx hyperframes preview zur Überprüfung (der Benutzer kann alles in der Timeline von Studio bearbeiten)
  • npx hyperframes render erst nach Zustimmung des Benutzers

Individual skills in this repo

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

sansayan01/finance_app_zo

Add captions to a talking-head video. ONE catalog (CATALOG.md) of 36 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. Runs locally end-to-end (transcribes and mattes the subject itself, no API key). Requires hyperframes and a single-subject clip (multi-shot clips ar...

sansayan01/finance_app_zo

The fallback workflow for authoring or editing any custom HyperFrames composition at any length or format — longer / multi-scene pieces, brand and sizzle reels, montages, title cards, static loops, freeform builds. Use only when no specialized workflow fits the input; routing table at /hyperframes.

sansayan01/finance_app_zo

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.

sansayan01/finance_app_zo

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, render, publish, cloud, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, tts, or remove-background (validate/inspect/layout are deprecated aliases covered by check), or when troubleshooting the HyperFrames build/render environment. Entry point for HeyGen-hosted cloud rendering (`hyperframes cloud render / list / get / delete`) and self-managed AWS Lambda rendering (`hyperframes lambda deploy / render / progress / destroy / policies / sites`).

sansayan01/finance_app_zo

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

sansayan01/finance_app_zo

Use when a HyperFrames composition needs seek-safe 2D/3D keyframes, GSAP timelines, 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.

sansayan01/finance_app_zo

MicroFlow Pro - MFI Staff Portal built with Flutter & Supabase

Verwandte Skills