Communitygithub.com

sq-cm/claude-template

HyperFrames CLI-Entwicklungsloop – `npx hyperframes` für Scaffolding (init), Validierung (lint, validate, inspect), Vorschau, Rendern und Umgebungsdiagnose (doctor, browser, info, upgrade). Wird beim Ausführen dieser Befehle oder bei der Fehlerbehebung der HyperFrames-Build-/Render-Umgebung verwendet. Für Asset-Vorverarbeitungsbefehle (`tts`, `transcribe`, `remove-background`) stattdessen das `hyperframes-media`-Skill aufrufen.

Was ist claude-template?

Dieses Skill definiert den vollständigen Entwicklungs-Workflow der HyperFrames-CLI. Es umfasst alle Schritte von der Projekterstellung (`init`) über Linting und Validierung (`lint`, `validate`, `inspect`) bis zur Vorschau (`preview`) und zum finalen Rendern (`render`). Es unterstützt außerdem die Umgebungsdiagnose mit Befehlen wie `doctor`, `browser`, `info` und `upgrade`, um Probleme mit Chrome, FFmpeg oder Node.js zu identifizieren. Das Skill ist für die Nutzung mit Node.js >= 22 und FFmpeg optimiert und integriert sich nahtlos in die HyperFrames-Plattform. Die Dokumentation enthält detaillierte Beispiele für alle Befehle, Parameter-Tabellen und Best Practices für Entwickler, die programmatische Videos mit HyperFrames erstellen. Asset-Vorverarbeitung (TTS, Transkription, Hintergrundentfernung) wird an das separate `hyperframes-media`-Skill delegiert.

Funktioniert mit✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/sq-cm/claude-template/tree/HEAD/.claude/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. Erfordert Node.js >= 22 und FFmpeg.

Workflow

  1. Scaffold — npx hyperframes init my-video
  2. Schreiben — HTML-Komposition erstellen (siehe das hyperframes-Skill)
  3. Linten — npx hyperframes lint
  4. Laufzeitvalidierung — npx hyperframes validate
  5. Visuelle Inspektion — npx hyperframes inspect
  6. Vorschau — npx hyperframes preview
  7. Rendern — npx hyperframes render

Vor der Vorschau linten und inspizieren. lint erkennt fehlende data-composition-id, überlappende Tracks und nicht registrierte Timelines. inspect öffnet die gerenderte Komposition in einem Headless-Chrome, durchsucht die Timeline und meldet Text, der aus Sprechblasen/Containern herausragt oder den Canvas verlässt.

Scaffolding

npx hyperframes init my-video                        # interaktiver Assistent
npx hyperframes init my-video --example warm-grain   # Beispiel auswählen
npx hyperframes init my-video --video clip.mp4        # mit Videodatei
npx hyperframes init my-video --audio track.mp3       # mit Audiodatei
npx hyperframes init my-video --example blank --tailwind # mit Tailwind v4 Browser-Laufzeit
npx hyperframes init my-video --non-interactive       # Eingabeaufforderungen überspringen (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-Codierungs-Skills. Verwenden Sie es anstatt Dateien von Hand zu erstellen.

Bei Verwendung von --tailwind ist zu beachten, dass das Gerüst Tailwind v4.2 über die Browser-Laufzeit verwendet, nicht das Tailwind v3-Setup von Studio – überprüfen Sie die Syntax von Klassen und Theme-Token anhand der v4-Dokumentation, bevor Sie Änderungen vornehmen.

Linting

npx hyperframes lint                  # aktuelles Verzeichnis
npx hyperframes lint ./my-project     # spezifisches Projekt
npx hyperframes lint --verbose        # Info-Level-Ergebnisse
npx hyperframes lint --json           # maschinenlesbar

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

Laufzeitvalidierung

npx hyperframes validate                  # aktuelles Verzeichnis
npx hyperframes validate ./my-project     # spezifisches Projekt
npx hyperframes validate --json           # maschinenlesbar
npx hyperframes validate --timeout 5000   # langsame Skripte/Medien (Standard 3000 ms)

Lädt die Komposition in Headless-Chrome und meldet JS-Konsolenfehler, fehlende Assets und WCAG-Kontrastprobleme (--no-contrast zum Überspringen des Kontrastdurchlaufs). Führen Sie es nach lint und vor inspect aus.

validate ist im Upstream zugunsten von npx hyperframes check deprecated, das Linting, Laufzeit, Layout, Bewegung und Kontrastüberprüfung in einer Browsersitzung kombiniert – beide erfüllen einen „lint and validate“-Checklisteneintrag.

Visuelle Inspektion

npx hyperframes inspect                 # inspiziert gerendertes Layout über die Timeline
npx hyperframes inspect ./my-project    # spezifisches Projekt
npx hyperframes inspect --json          # agentenlesbare Ergebnisse
npx hyperframes inspect --samples 15    # dichterer Timeline-Durchlauf
npx hyperframes inspect --at 1.5,4,7.25 # explizite Hero-Frame-Zeitstempel

Verwenden Sie dies nach lint und validate, insbesondere bei Kompositionen mit Sprechblasen, Karten, Untertiteln oder enger Typografie. Es meldet:

  • Text, der über den nächstgelegenen visuellen Container oder die Sprechblase hinausragt
  • Text, der durch seine eigene feste Breite/Höhe abgeschnitten wird
  • Text, der über die Kompositionsleinwand hinausragt
  • Kind-Elemente, die aus schneidenden Containern entkommen

Fehler sollten vor dem Rendern behoben werden. Warnungen werden zur Agentenprüfung angezeigt; mit --strict auch bei Warnungen fehlschlagen. Wiederholte statische Probleme werden standardmäßig zusammengefasst, sodass die JSON-Ausgabe für LLM-Kontextfenster kompakt bleibt. Wenn ein Überlauf für eine Ein-/Ausgangsanimation beabsichtigt ist, markieren Sie das Element oder den Vorfahren mit data-layout-allow-overflow. Wenn ein dekoratives Element nie geprüft werden soll, markieren Sie 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       # benutzerdefinierter Port (Standard 3002)

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

Wenn Sie ein Projekt an den Benutzer zurückgeben, verwenden Sie die Studio-Projekt-URL, nicht den index.html-Quellpfad:

http://localhost:<port>/#project/<project-name>

Verwenden Sie den tatsächlichen Port aus der Vorschauausgabe und den Projektverzeichnisnamen. Beispiel: Nach npx hyperframes preview --port 3017 in codex-openai-video melden Sie http://localhost:3017/#project/codex-openai-video.

Behandeln Sie index.html nur als Quellcode-Kontext. Es ist in Ordnung, es als Implementierungsdatei zu verlinken, aber bezeichnen Sie es nicht als Projekt oder Vorschauoberfläche.

Rendern

npx hyperframes render                                # Standard-MP4
npx hyperframes render --output final.mp4             # benannte Ausgabe
npx hyperframes render --quality draft                # schnelle Iteration
npx hyperframes render --fps 60 --quality high        # finale Auslieferung
npx hyperframes render --format webm                  # transparentes WebM
npx hyperframes render --docker                       # byte-identisch
FlagOptionenStandardHinweise
--outputPfadrenders/name_timestamp.mp4Ausgabepfad
--fps24, 30, 603060fps verdoppelt die Renderzeit
--qualitydraft, standard, highstandarddraft für Iterationen
--formatmp4, webmmp4WebM unterstützt Transparenz
--workers1-8 oder autoautoJeder spawnet Chrome
--dockerFlagausReproduzierbare Ausgabe
--gpuFlagausGPU-beschleunigte Codierung
--strictFlagausFehlschlagen bei Lint-Fehlern
--strict-allFlagausFehlschlagen bei Fehlern UND Warnungen
--variablesJSON-Objekt—Überschreibt in data-composition-variables deklarierte Variablenwerte
--variables-filePfad—JSON-Datei mit Variablenwerten (Alternative zu --variables)
--strict-variablesFlagausRender-Fehler bei nicht deklarierten Schlüsseln oder Typkonflikten in --variables

Qualitätsleitfaden: draft während der Iteration, standard für Überprüfungen, high für die finale Auslieferung.

Parametrisierte Renderings: Die Komposition deklariert ihre Variablen auf dem <html>-Root mit data-composition-variables – einem JSON-Array von Deklarationen ({id, type, label, default} pro Eintrag), das das Schema definiert. Skripte im Inneren lesen die aufgelösten Werte über window.__hyperframes.getVariables(). Die CLI --variables '{"title":"Q4-Bericht"}' ist ein JSON-Objekt, das nach ID Schlüsseln über die deklarierten Standardwerte legt und diese 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 – dasselbe Objektformat, beschränkt auf eine Einbindung der Sub-Komposition. Das vollständige Muster finden Sie im hyperframes-Skill.)

Asset-Vorverarbeitung

npx hyperframes tts, transcribe und remove-background produzieren Assets (Narration-Audio, Wort-für-Wort-Transkripte, transparentes Video), die in eine Komposition eingefügt werden. Jedes lädt sein eigenes Modell beim ersten Start herunter. Für Stimmenauswahl, Whisper-Modellregeln (die .en-übersetzt-nicht-Englisch-Falle), Ausgabeformatwahl (VP9-Alpha-WebM vs. ProRes) und die Kette TTS → Transkribieren → Untertitel rufen Sie das hyperframes-media-Skill auf.

Fehlerbehebung

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

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

Sonstiges

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

Verwandte Skills