Communitygithub.com

HyperFrames CLI

Entwicklungs-Workflow für HyperFrames – Scaffolding, Linting, visuelle Inspektion, Vorschau und Rendering über die CLI `npx hyperframes`.

Was ist HyperFrames CLI?

Diese Fähigkeit definiert den vollständigen Entwicklungs-Workflow für HyperFrames-Projekte über die CLI `npx hyperframes`. Sie umfasst das initiale Gerüstbau (`init`), die statische Code-Analyse (`lint`), die visuelle Überprüfung des gerenderten Layouts (`inspect`), eine Live-Vorschau mit Hot-Reload (`preview`) sowie die finale Ausgabe als Video (`render`). Das Tool erfordert Node.js ≥ 22 und FFmpeg. Der `init`-Befehl erstellt nicht nur die richtige Dateistruktur, sondern kopiert auch Medien, transkribiert Audio (Whisper) und installiert KI-Entwicklungsfähigkeiten. Der `inspect`-Befehl öffnet die Komposition in einem Headless-Chrome, sucht das Timeline ab und meldet Text, der aus Blasen, Containern oder der Leinwand ragt. Der `render`-Befehl bietet zahlreiche Optionen für FPS, Qualität, Format (MP4/WebM), Docker-Reproduzierbarkeit und GPU-Beschleunigung. Die Fähigkeit wird für Entwickler und KI-Agenten empfohlen, die HyperFrames-Kompositionen erstellen, debuggen und rendern. Für Asset-Vorverarbeitung (TTS, Transkription, Hintergrundentfernung) ist die separate `hyperframes-media`-Fähigkeit zuständig.

Funktioniert mit~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/delorenj/skills/tree/HEAD/hyperframes-cli

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht HyperFrames CLI?

Alles läuft über npx hyperframes. Erfordert Node.js >= 22 und FFmpeg.

Workflow

  1. Gerüst bauen – npx hyperframes init mein-video
  2. Schreiben – HTML-Komposition verfassen (siehe die hyperframes-Fähigkeit)
  3. Linten – npx hyperframes lint
  4. Visuell inspizieren – npx hyperframes inspect
  5. Vorschau – npx hyperframes preview
  6. Rendern – npx hyperframes render

Vor der Vorschau linten und inspizieren. lint erkennt fehlende data-composition-id, überlappende Tracks und nicht registrierte Timeline-Elemente. inspect öffnet die gerenderte Komposition in headless Chrome, durchsucht die Timeline und meldet Text, der aus Blasen/Containern oder der Leinwand ragt.

Gerüst bauen

npx hyperframes init mein-video                        # interaktiver Assistent
npx hyperframes init mein-video --beispiel warm-grain  # Beispiel auswählen
npx hyperframes init mein-video --video clip.mp4       # mit Videodatei
npx hyperframes init mein-video --audio track.mp3      # mit Audiodatei
npx hyperframes init mein-video --beispiel blank --tailwind # mit Tailwind v4 Browser-Laufzeit
npx hyperframes init mein-video --nicht-interaktiv      # keine Eingabeaufforderung (CI/Agenten)

Vorlagen: blank, warm-grain, play-mode, swiss-grid, vignelli, decision-tree, kinetic-type, product-promo, nyt-graph.

init erstellt die richtige Dateistruktur, kopiert Medien, transkribiert Audio mit Whisper und installiert KI-Entwicklungsfähigkeiten. Verwende es anstatt Dateien von Hand zu erstellen.

Bei Verwendung von --tailwind rufe die tailwind-Fähigkeit auf, bevor du Klassen oder Theme-Token bearbeitest. Das Gerüst verwendet Tailwind v4.2 über die Browser-Laufzeit, nicht Tailwind v3 von Studio.

Linting

npx hyperframes lint                  # aktuelles Verzeichnis
npx hyperframes lint ./mein-projekt   # bestimmtes Projekt
npx hyperframes lint --ausführlich    # Info-Stufen-Funde
npx hyperframes lint --json           # maschinenlesbar

Lintet index.html und alle Dateien in compositions/. Meldet Fehler (müssen behoben werden), Warnungen (sollten behoben werden) und Info (mit --ausführlich).

Visuelle Inspektion

npx hyperframes inspect                 # gerendertes Layout über die Timeline inspizieren
npx hyperframes inspect ./mein-projekt  # bestimmtes Projekt
npx hyperframes inspect --json          # agentenlesbare Funde
npx hyperframes inspect --samples 15    # dichtere Timeline-Abtastung
npx hyperframes inspect --um 1.5,4,7.25 # explizite Hero-Frame-Zeitstempel

Verwende dies nach lint und validate, besonders bei Kompositionen mit Sprechblasen, Karten, Untertiteln oder enger Typografie. Es meldet:

  • Text, der außerhalb des nächsten sichtbaren Containers oder der Blase liegt
  • Text, der durch die eigene feste Breite/Höhe abgeschnitten wird
  • Text, der außerhalb der Kompositionsleinwand liegt
  • Kinder, die aus beschneidenden Containern entkommen

Fehler sollten vor dem Rendern behoben werden. Warnungen werden für die Agentenprüfung angezeigt; füge --streng hinzu, um auch bei Warnungen fehlzuschlagen. Wiederholte statische Probleme werden standardmäßig zusammengefasst, damit die JSON-Ausgabe für LLM-Kontextfenster kompakt bleibt. Wenn ein Überlauf für eine Ein-/Ausgangsanimation beabsichtigt ist, markiere das Element oder den Vorfahren mit data-layout-allow-overflow. Wenn ein dekoratives Element nie geprüft werden soll, markiere es mit data-layout-ignore.

npx hyperframes layout bleibt als Kompatibilitätsalias für denselben visuellen Inspektionsdurchlauf verfügbar.

Vorschau

npx hyperframes preview                   # aktuelles Verzeichnis bereitstellen
npx hyperframes preview --port 4567       # eigener Port (Standard 3002)

Hot-Reload bei Dateiänderungen. Öffnet das Studio automatisch im Browser.

Wenn du ein Projekt an den Benutzer zurückgibst, verwende die Studio-Projekt-URL, nicht den Pfad zur index.html-Quelle:

http://localhost:<port>/#projekt/<projektname>

Verwende den tatsächlichen Port aus der Vorschau-Ausgabe und den Projektverzeichnisnamen. Beispiel: Nach npx hyperframes preview --port 3017 in codex-openai-video melde http://localhost:3017/#projekt/codex-openai-video.

Behandle index.html nur als Quellcode-Kontext. Es ist in Ordnung, sie als Implementierungsdatei zu verlinken, aber bezeichne sie nicht als Projekt- oder Vorschauoberfläche.

Rendern

npx hyperframes render                                # Standard-MP4
npx hyperframes render --ausgabe final.mp4            # benannte Ausgabe
npx hyperframes render --qualität entwurf             # schnelle Iteration
npx hyperframes render --fps 60 --qualität hoch       # endgültige Auslieferung
npx hyperframes render --format webm                  # transparentes WebM
npx hyperframes render --docker                       # byte-identisch
FlagOptionenStandardHinweise
--ausgabePfadrenders/name_zeitstempel.mp4Ausgabepfad
--fps24, 30, 603060fps verdoppelt die Renderzeit
--qualitätentwurf, standard, hochstandardentwurf zum Iterieren
--formatmp4, webmmp4WebM unterstützt Transparenz
--arbeiter1-8 oder autoautoJeder startet Chrome
--dockerFlagausReproduzierbare Ausgabe
--gpuFlagausGPU-beschleunigte Codierung
--strengFlagausFehlschlag bei Lint-Fehlern
--streng-allesFlagausFehlschlag bei Fehlern UND Warnungen
--variablenJSON-Objekt—Überschreibt in data-composition-variables deklarierte Variablen
--variablen-dateiPfad—JSON-Datei mit Variablenwerten (Alternative zu --variablen)
--streng-variablenFlagausRendern bei nicht deklarierten Schlüsseln oder Typkonflikten abbrechen

Qualitätsrichtlinie: entwurf während des Iterierens, standard für die Überprüfung, hoch für die endgültige Auslieferung.

Parametrisierte Render: Die Komposition deklariert ihre Variablen auf dem <html>-Root mit data-composition-variables – einem JSON-Array von Deklarationen ({id, typ, label, standard} pro Eintrag), das das Schema definiert. Skripte darin lesen die aufgelösten Werte über window.__hyperframes.getVariables(). Die CLI --variablen '{"titel":"Q4-Bericht"}' ist ein JSON-Objekt, das nach ID schlüsselt und die deklarierten Standardwerte für einen Render überschreibt; fehlende Schlüssel fallen durch, sodass dieselbe Komposition unverändert in der Entwicklungsvorschau und in der Produktion läuft. (Sub-Comp-Hosts können auch pro Instanz mit data-variable-values überschreiben – dieselbe Objektform, beschränkt auf eine Einbindung der Sub-Komposition. Siehe die hyperframes-Fähigkeit für das vollständige Muster.)

Asset-Vorverarbeitung

npx hyperframes tts, transcribe und remove-background erzeugen Assets (Erzähl-Audio, Wort-für-Wort-Transkripte, transparentes Video), die in eine Komposition eingefügt werden. Jedes lädt beim ersten Durchlauf ein eigenes Modell herunter. Für Sprachauswahl, Whisper-Modellregeln (die .en-übersetzt-Nicht-Englisch-Falle), Ausgabeformatwahl (VP9-Alpha-WebM vs. ProRes) und die Kette TTS → Transkribieren → Untertitel rufe die hyperframes-media-Fähigkeit auf.

Fehlerbehebung

npx hyperframes doctor       # Umgebung prüfen (Chrome, FFmpeg, Node, Speicher)
npx hyperframes browser      # gebündeltes Chrome verwalten
npx hyperframes info         # Versions- und Umgebungsdetails
npx hyperframes upgrade      # nach Updates suchen

Führe zuerst doctor aus, wenn das Rendern fehlschlägt. Häufige Probleme: fehlendes FFmpeg, fehlendes Chrome, zu wenig Arbeitsspeicher.

Sonstiges

npx hyperframes compositions   # Kompositionen im Projekt auflisten
npx hyperframes docs           # Dokumentation öffnen
npx hyperframes benchmark .    # Render-Performance benchmarken

Individual skills in this repo

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

delorenj/skills

Plan and generate terminal ASCII animations/screensaver-style output (FPS, refresh rules, loop policy, low-flicker guidance), with a static poster frame and an optional local demo script.

delorenj/skills

ASCII video: convert video/audio to colored ASCII MP4/GIF.

delorenj/skills

Plan, build and quality-check a premium short commercial for a real business (roofing, property, ecommerce, B2B software) using AI-generated footage, code-built motion (HTML/GSAP), selective Three.js and an independent-critic "Gauntlet" loop. Use when asked to make a launch-style / SaaS-style video, business ad, explainer, sample reel or pitch video, or to review and improve one. Encodes motion principles distilled from 28 professional launch films, a quality bar, audio rules and a business-offer playbook.

delorenj/skills

CSS animation adapter patterns for HyperFrames. Use when authoring CSS keyframes, animation-delay based timing, animation-fill-mode, animation-play-state, or CSS-only motion that HyperFrames must seek deterministically during preview and rendering.

delorenj/skills

Generate professional voiceovers using ElevenLabs AI. Use when the user needs to create voiceovers for videos, audio narration, or text-to-speech content. Supports multiple voices with character presets (narrator, salesperson, expert) for natural delivery. Includes single scene regeneration for fine-tuning.

delorenj/skills

Asset preprocessing for HyperFrames compositions — text-to-speech narration (Kokoro), audio/video transcription (Whisper), and background removal for transparent overlays (u2net). Use when generating voiceover from text, transcribing speech for captions, removing the background from a video or image to use as a transparent overlay, choosing a TTS voice or whisper model, or chaining these (TTS → transcribe → captions). Each command downloads its own model on first run.

delorenj/skills

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

delorenj/skills

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For dev-loop CLI commands (init, lint, inspect, preview, render) see the hyperframes-cli skill; for asset preprocessing commands (tts, transcribe, remove-background) see the hyperframes-media skill.

delorenj/skills

Manim CE animations: 3Blue1Brown math/algo videos.

delorenj/skills

Join a Google Meet or Zoom call as a video meeting agent via PikaStreaming. Trigger: user drops a Google Meet or Zoom link, or asks to join a meeting.

delorenj/skills

Translate an existing Remotion (React-based) video composition into a HyperFrames HTML composition. Use ONLY when the user explicitly asks to port, convert, migrate, translate, or rewrite a Remotion composition as HyperFrames (e.g. "port my Remotion project to HyperFrames"). Do NOT use when (a) authoring a NEW HyperFrames composition (even if A/B-testing a Remotion video); (b) Remotion is mentioned in passing; (c) Remotion code is shared as reference, not for translation; (d) the user wants "the same video as my Remotion one" without explicitly asking to migrate the source — treat as a fresh HyperFrames build. When in doubt, default to the `hyperframes` skill. Detects unsupported patterns (useState, useEffect side effects, async calculateMetadata, third-party React component libraries, `@remotion/lambda`) and recommends the runtime interop escape hatch instead of a lossy translation.

delorenj/skills

Generate speech using the self-hosted voxxy (vox) TTS service at https://vox.delo.sh. Use when the user asks to speak, say, narrate, synthesize speech, clone a voice, create a voice, add or register a voice, pipe TTS, or control voice qualities by description (e.g. "a young woman with a cheerful voice"). Handles HTTP API usage, voice profile management, description-based voice design, cloning, MCP registration, and integration patterns for new platforms.

delorenj/skills

Capture a website and create a HyperFrames video from it. Use when: (1) a user provides a URL and wants a video, (2) someone says "capture this site", "turn this into a video", "make a promo from my site", (3) the user wants a social ad, product tour, or any video based on an existing website, (4) the user shares a link and asks for any kind of video content. Even if the user just pastes a URL — this is the skill to use.

delorenj/skills

YouTube transcripts to summaries, threads, blogs.

Verwandte Skills