Communitygithub.com

Manavv007/S.A.R.A.L.-Schema-Zugriff-Abruf-Analyse-Schicht-

Der HyperFrames-Kompositionsvertrag: Erstelle ein renderbares Projekt. Nutze ihn für Kompositionsstruktur, die `data-*`-Timing-Attribute, `class="clip"`, Spuren, Unterkompositionen, Variablen, framework-eigene Medienwiedergabe, deterministische Renderregeln und Validierung. Lies dies, bevor du Kompositions-HTML schreibst.

Was ist S.A.R.A.L.-Schema-Zugriff-Abruf-Analyse-Schicht-?

Diese Fähigkeit definiert den technischen Vertrag von HyperFrames – einem Framework, das Video aus HTML rendert. Eine Komposition ist eine HTML-Datei, deren DOM das Timing über `data-*`-Attribute deklariert, deren Animationslaufzeit suchbar ist und deren Medienwiedergabe vom Framework verwaltet wird. Das Skill-Dokument beschreibt, wie ein HyperFrames-Projekt aufgebaut wird, und verweist für detaillierte Themen wie minimale Kompositionen, Datenattribute, Spuren und Clips, Unterkompositionen, Variablen und Medien, Determinismusregeln sowie Subagenten-Dispatch auf Referenzdateien im `references/`-Verzeichnis. Es unterstützt Standalone- und Unterkompositionsstrukturen, legt unverhandelbare Regeln für deterministisches Rendering fest (keine Laufzeituhren, kein ungeseeder `Math.random`, keine Endlosschleifen) und bietet eine Validierungs-Checkliste mit CLI-Befehlen wie `npx hyperframes lint`, `validate`, `inspect`, `snapshot`, `preview` und `render`. Entwickler sollten diese Anleitung lesen, bevor sie Kompositions-HTML schreiben, um häufige Fehler wie Layout-Kollaps, doppelte IDs und falsche Hintergrundwiedergabe zu vermeiden.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-/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 vom Framework verwaltet wird.

Dieses Skill ist der technische Vertrag – wie ein HyperFrames-Projekt aufgebaut wird. Der folgende Text ist die Bauanleitung; detaillierte Themen pro Thema befinden sich in references/ (Index folgt) und werden bei Bedarf gelesen. Andere Belange sind in den verwandten Domain-Skills zu finden – hyperframes-animation, hyperframes-creative, hyperframes-media, hyperframes-cli, hyperframes-registry. Die Fähigkeitskarte in /hyperframes gibt an, was jedes dieser Skills abdeckt.

Referenzen

DateiLies sie, um…
references/minimal-composition.mdmit dem kleinsten renderbaren Kompositionsgerüst zu beginnen
references/composition-patterns.mdmonolithisch vs. modular zu wählen; eine modulare index.html zu strukturieren; einen Unterkompositions-Archetyp zu wä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 auszuwählen, Überlappungen / Z-Index auf der gleichen Spur zu behandeln, einen Clip relativ zu einem anderen zu timen
references/sub-compositions.mdeine Unterkomposition zu verdrahten (Host-Attribute, <template>, Instanzvariablen) und darin zu animieren
references/variables-and-media.mdVariablen zu deklarieren; <video>/<audio> zu platzieren, die Lautstärke einzustellen, zu trimmen
references/determinism-rules.mdeine suchbare Zeitachse zu bauen; Determinismus-Verbote; die erlaubte Liste animierbarer Eigenschaften; Layout / Textanpassung
references/full-screen-motion.mdVollbild-Bewegung mit gemeinsamen Hintergründen zu erstellen
references/storyboard-format.mdeinen STORYBOARD.md-Plan zu erstellen (+ das geparste Manifest)
references/script-format.mddas optionale gesperrte SCRIPT.md-Narrativ zu erstellen
references/subagent-dispatch.mdSubagenten-Dispatch-Verben (paralleles Verteilen / Hintergrund / Warten) auf dein Harness abzubilden
references/tailwind.mdin einem Tailwind v4-Projekt zu arbeiten (init --tailwind; der Laufzeitvertrag unterscheidet sich von Studios v3)

Details zur Animationslaufzeit (GSAP-API, Lottie, Three.js usw.) findest du in hyperframes-animation → adapters/<runtime>.md.

Eine Komposition erstellen

Zwei Root-Formen (nicht austauschbar)

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

⚠ Transportregel: Die Laufzeit klont nur <template>-Inhalte; alles außerhalb (inkl. <head>-Styles/Skripte) 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-Fehler)

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 – andernfalls kollabiert ein Flex-/100%-Kind auf ~0 und der Inhalt stapelt sich in der oberen linken Ecke. lint/validate/inspect erkennen dies nicht. 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), die synchron beim Seitenaufbau erstellt wird. Renderdauer = 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/.

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

Hier aufgelistet; ausführliche Begründung in der verlinkten Referenz. Nicht verletzen:

  • Keine Laufzeituhren / ungeseeder Math.random / Netzwerk / Eingabezustand; kein repeat: -1 (verwende eine endliche Anzahl). → determinism-rules.md
  • Nur die visuelle Eigenschafts-Whitelist 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-Comp-<template>/Wrappers); das Framework besitzt die Wiedergabe. → variables-and-media.md
  • Jede id muss auf der zusammengesetzten Seite eindeutig sein; innerhalb einer Sub-Komposition die IDs mit der Kompositions-ID (#<id>-hero) versehen. Doppelte <video>/<img>-IDs rendern leer – der Producer injiziert Frames über getElementById, und dateiübergreifende Duplikate entgehen lint. → composition-patterns.md
  • Eine Vollbild-Szenenfüllung geht auf ein randloses Kind (position:absolute; inset:0), niemals auf den Kompositions-Root selbst – der Frame-Compositing des Producers kann den eigenen background des Root-Elements entfernen (der Frame rendert schwarz), auch wenn die Vorschau/snapshot es korrekt anzeigen. → composition-patterns.md

Vorhandene Kompositionen bearbeiten

  • Lies zuerst die Dateien. Erhalte nicht zusammenhängendes Timing, Spuren, IDs, Variablen, Medienpfade.
  • Gleiche vorhandene Kompositions-IDs und Timeline-Schlüssel ab.
  • Hinzufügen eines Clips: Wähle einen nicht überlappenden data-track-index oder passe das umgebende Timing bewusst an.
  • Hinzufügen einer Sub-Komposition: Überprüfe ihre interne data-composition-id, bevor du den Host verdrahtest.

Validierung

Nutze hyperframes-cli für Kommandodetails

  • npx hyperframes lint wird bestanden (0 Fehler)
  • npx hyperframes validate wird bestanden (0 Konsolenfehler)
  • npx hyperframes inspect wird bestanden (0 Fehler)
  • Projekte mit Sub-Kompositionen: npx hyperframes snapshot --at <midpoints> und jedes Frame visuell prüfen
  • npx hyperframes preview zur Überprüfung (der Benutzer kann alles in Studios Timeline bearbeiten)
  • npx hyperframes render erst nach Zustimmung des Benutzers ausführen

Individual skills in this repo

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

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

The fallback workflow for authoring custom HyperFrames video compositions at any length or format — longer or multi-scene pieces, brand / sizzle reels, montages, title cards, static loops, and freeform compositions. Input- and length-agnostic. If a specialized workflow clearly fits the input — a marketed product, a website, a topic explainer, a GitHub PR, existing footage, a short motion graphic, or a Remotion port — prefer it (see /hyperframes); use this only as the general fallback when none fit.

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

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.

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

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

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

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

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

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.

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

Audio and media assets for HyperFrames compositions, produced by one shared audio engine (`scripts/audio.mjs`) — multi-provider TTS (HeyGen / ElevenLabs / Kokoro local), background music + sound effects (HeyGen audio-library retrieval by default, with local Lyria / MusicGen BGM generation and a bundled SFX library as the no-credential fallback), Whisper transcription, background removal, and caption authoring. Use for voiceover / TTS, BGM, SFX / sound effects, transcription, captions / subtitles / lyrics / karaoke / per-word styling, voice + provider selection, and music-mood prompting.

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

S.A.R.A.L. is an advanced AI-powered platform designed to bridge the "information gap" between rural Indian citizens and government welfare. While thousands of schemes exist, the complex language of official PDFs often makes them inaccessible to the common man.

Verwandte Skills