Communitygithub.com

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

HyperFrames CLI-Entwicklungsloop. Verwenden, wenn `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` oder `remove-background` ausgeführt wird, oder bei der Fehlerbehebung der HyperFrames-Build-/Render-Umgebung. Einstiegspunkt für AWS Lambda-Cloud-Rendering (`hyperframes lambda deploy / render / progress / destroy / policies`).

Was ist S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-?

Die HyperFrames CLI ist ein zentrales Entwicklungswerkzeug für die HyperFrames-Videoplattform, das es Entwicklern ermöglicht, Videos auf Basis von HTML-Compositions zu erstellen, zu validieren und zu rendern. Alle Operationen laufen über `npx hyperframes` und erfordern Node.js >= 22 sowie FFmpeg. Der Workflow umfasst das Erstellen eines Projekts (z. B. mit `init`), das Authoring der HTML-Composition (unter Verwendung des `hyperframes-core`-Skills), gefolgt von statischen Prüfungen wie `lint`, `validate` und `inspect`, um typische Fehler zu erkennen, bevor eine Vorschau im integrierten Studio-Editor (`preview`) betrachtet wird. Das Rendern kann lokal mit verschiedenen Qualitätsstufen („draft“, „high“) oder in CI/Container-Umgebungen mit `--docker --strict` erfolgen. Für große oder lange Projekte steht die Cloud-Rendering-Option über AWS Lambda zur Verfügung (`lambda deploy`, `lambda render`, `lambda destroy`). Die CLI ist agenten- und CI-freundlich: Sie unterstützt `--json`-Ausgabe auf den meisten Befehlen, erkennt nicht-interaktive Modi automatisch, und erzwingt nach einem erfolgreichen Render eine Ausgabeprüfung. Ein Querverweis zu anderen HyperFrames-Skills (core, registry, media) stellt sicher, dass spezifische Funktionalitäten wie Tailwind-Integration, Registry-Blöcke oder Asset-Vorverarbeitung konsistent genutzt werden können.

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-cli

In Ihrer bevorzugten KI fragen

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

Dokumentation

HyperFrames CLI

Alles läuft über npx hyperframes, sofern die Projektanweisungen keinen lokalen Wrapper vorgeben. Halte dich genau an den lokalen Wrapper. Erfordert Node.js >= 22 und FFmpeg.

Arbeitsablauf

  1. Scaffold — npx hyperframes init my-video (oder capture von einer URL)
  2. Schreiben — HTML-Composition authoring (siehe Skill hyperframes-core)
  3. Lint — npx hyperframes lint
  4. Validieren — npx hyperframes validate (Laufzeitfehler + Kontrast)
  5. Visuelle Inspektion — npx hyperframes inspect
  6. Vorschau — npx hyperframes preview öffnet Studio, den Timeline-Editor, in dem der Benutzer alles manuell bearbeiten kann (nicht nur ansehen). Dort prüfen, dann vor dem Rendern nachfragen.
  7. Rendern — Variante wählen:
    • Iterieren: npx hyperframes render --quality draft
    • Ausliefern: npx hyperframes render --quality high --output out.mp4
    • CI / plattformübergreifende Reproduktion: npx hyperframes render --docker --strict --output out.mp4
    • Cloud (lang / groß): npx hyperframes lambda render ./my-project --width 1920 --height 1080 --wait (siehe Lambda unten)

Führe lint, validate und inspect vor der Vorschau aus. lint erkennt fehlende data-composition-id, überlappende Tracks und nicht registrierte Timelines. validate lädt die Composition in headless Chrome und meldet Laufzeit-Fehler in der Konsole sowie WCAG-Kontrastprobleme. inspect durchsucht die Timeline und meldet Text, der aus Blasen/Containern herausläuft oder über die Leinwand hinausgeht – und, wenn ein *.motion.json-Sidecar vorhanden ist, überprüft es die Bewegungsabsicht (Eingänge, die beim Suchen auslösen, Stagger-Reihenfolge, im Bild, Lebendigkeit) gegen dieselbe durchsuchte Timeline.

Für bewegungsintensive Arbeit bevorzuge Snapshot-basierte Iteration und ein *.motion.json-Sidecar – siehe references/lint-validate-inspect.md für die Disziplin und die Spezifikation zur Bewegungsüberprüfung.

Agenten-Konventionen

Übergreifende Regeln, die für jeden Befehl gelten:

  • --json ist bei jedem Befehl außer render, preview und play verfügbar. Verwende es für jede Agenten-/CI-Invokation der unterstützten Befehle; die Ausgabe enthält einen _meta-Umschlag (CLI-Version, letzte verfügbare Version, Update-Hinweis). render meldet den Status nur über stdout + Exit-Code – überprüfe den Erfolg mit der untenstehenden Prüfung nach dem Rendern; preview/play sind Server, kein JSON.
  • doctor --json beendet sich immer mit 0, auch wenn die Umgebung defekt ist. Prüfe das ok-Feld des Payloads: npx hyperframes doctor --json | jq -e '.ok' > /dev/null. Dies schützt Pipelines vor CLI-Versionsänderungen.
  • Nicht-TTY-Modus wird automatisch erkannt. Wenn stdout kein TTY ist (CI, Agenten, gepipte Ausgabe) wechselt die CLI automatisch in den nicht-interaktiven Modus; init erfordert dann --example. Verwende --non-interactive, um diesen Modus auch auf einem TTY zu erzwingen.
  • CI-Gating beim Rendern: --strict schlägt bei Lint-Fehlern fehl, --strict-all auch bei Warnungen, --strict-variables bei nicht deklarierten --variables-Schlüsseln.
  • Pfade in --json werden redigiert – $HOME wird zum wörtlichen $HOME, sodass die Ausgabe sicher in Fehlerberichte und Agenten-Kontexte eingefügt werden kann.
  • Das Rendern wird durch den Benutzer freigegeben. Starte niemals automatisch das Rendern, sobald die Prüfungen bestanden sind. Halte bei preview an, teile dem Benutzer mit, dass das Video in Studio bearbeitet werden kann, und rendere erst nach seiner Zustimmung.
  • Überprüfung nach dem Rendern. Nachdem render mit Exit-Code 0 beendet wurde, bestätige, dass die Ausgabedatei existiert und eine plausible Größe hat, bevor der Erfolg gemeldet wird: [ -s "$OUTPUT" ] || echo "render produced no output". Die CLI gibt bei Erfolg ◇ <Pfad> aus; bei langen Renderings überprüfe zusätzlich die Dauer mit ffprobe -i "$OUTPUT" -show_format -v error.

Weiterleitung

Was möchtest du tun…Lese
Ein Projekt erstellen (init, capture, skills)references/init-and-scaffold.md
Korrektheit prüfen (lint, validate, inspect, snapshot)references/lint-validate-inspect.md
Vorschau oder Rendern (preview, play, render, publish)references/preview-render.md
Umgebung diagnosticieren (doctor, browser)references/doctor-browser.md
Cloud-Rendering auf AWS Lambda (lambda deploy / sites / render / progress / destroy / policies)references/lambda.md
Alles andere (info, upgrade, compositions, docs, benchmark, telemetry, Asset-Vorverarbeitung)references/upgrade-info-misc.md

Skill-Übergaben

  • Tailwind-Projekte (init --tailwind) → verwende hyperframes-core (Tailwind-Referenz), bevor du Klassen oder Theme-Token bearbeitest.
  • Registry-Blöcke/Komponenten (hyperframes add, hyperframes catalog) → verwende hyperframes-registry für Installationspfade, Sub-Composition-Verkabelung und Snippet-Zusammenführung.
  • Asset-Vorverarbeitung (tts, transcribe, remove-background) → verwende hyperframes-media für Sprachauswahl, Whisper-Modellregeln, Untertitel und TTS-zu-Untertitel-Kette.
  • Parametrisierte Renderings (--variables) → deklariert über data-composition-variables auf <html>; siehe hyperframes-core für das vollständige Schema.

Lambda (Cloud-Rendering)

hyperframes lambda stellt verteiltes Rendering auf AWS Lambda bereit und steuert Renderings von deinem Laptop oder CI aus. Der vollständige Ablauf umfasst drei Befehle:

npx hyperframes lambda deploy                                             # SAM-Stack bereitstellen (Lambda + Step Functions + S3)
npx hyperframes lambda render ./my-project --width 1920 --height 1080 --wait
npx hyperframes lambda destroy                                            # abbauen (S3-Bucket bleibt erhalten)

Verwende Lambda, wenn ein Rendering zu lang / zu groß für einen Host ist (mehrminütige Videos, 4K, große parallele Batches) und AWS-Anmeldeinformationen konfiguriert sind. Für den Entwicklungsloop bleibe beim lokalen render.

Siehe references/lambda.md für Voraussetzungen, alle 6 Unterbefehle (deploy, sites create, render, progress, destroy, policies), IAM-Richtlinienvalidierung, Zustandsdateien und Kosten-/Bereinigungsregeln.

Minimales Abschluss-Gate

Statische Gates

npx hyperframes lint
npx hyperframes validate

Füge inspect für layout-sensible Arbeiten und render --strict in CI hinzu, um bei Lint-Fehlern zu scheitern.

Visueller Rauchtest – erforderlich, wenn das Projekt Sub-Compositions verwendet

lint / validate / inspect bewerten jede Composition isoliert. Sie laden niemals index.html und hängen Sub-Compositions über data-composition-src ein, daher können sie keine geräteübergreifenden Mount-Fehler erkennen (siehe hyperframes-core → references/sub-compositions.md, „Häufige Fallstricke“). Das einzige Gate, das sie erkennt, ist eines, das tatsächlich index.html lädt und die Timeline durchsucht.

Verwende hyperframes snapshot – es lädt das Projekt auf die gleiche Weise wie render (übt also den gleichen Mount-Pfad), erfasst aber nur die von dir angeforderten Zeitstempel, sodass es Sekunden statt eines vollständigen Renderings dauert:

# Erfasse einen Frame in der Mitte jeder Sub-Composition.
# Mittelpunkte = data-start + data-duration/2 für jeden Host-Slot in index.html.
npx hyperframes snapshot --at <t1>,<t2>,<t3>,...

# Oder, wenn keine Szenen-fokussierte Auswahl nötig ist, eine gleichmäßig verteilte Stichprobe:
npx hyperframes snapshot --frames 9

Die Ausgabe landet in snapshots/frame-NN-at-Xs.png. Überprüfe jeden Frame visuell anhand des Szenenplans.

Pro-Frame-Warnsignale (jedes zeigt auf einen bestimmten Fehlermodus, den die statischen Gates übersehen):

Was du siehstUrsache
Text erscheint winzig + ungestylt in der oberen linken Ecke<style>-Block blieb im <head> außerhalb von <template> (Fallstrick 1) – kein CSS erreichte das Live-DOM
SVG/Icon-Elemente auf Leinwandgröße aufgeblasenGleiche Ursache wie oben – keine Breiten-/Höhenbeschränkungen angewendet
Hero-Element der Szene fehlt vollständig; nur Hintergrund + Wasserzeichen sichtbarHost-id ≠ Template-id (Fallstrick 2) – Timeline wurde nie ausgeführt, Frame im Anfangszustand erfasst
Snapshot-Befehl protokolliert Sub-composition timelines not registered after 45000msFallstrick 2 – direkte Bestätigung

snapshots/ kann nach dem visuellen Überprüfen gelöscht werden; das endgültige, benutzerseitige Rendering erfolgt in einem separaten Durchlauf mit npx hyperframes render.

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-

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

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