Communitygithub.com

rbrown101010/codex-marketing-skills

HyperFrames CLI-Tool — hyperframes init, lint, inspect, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark. Verwenden Sie es beim Erstellen eines Projekts, Linting, Validieren, Inspizieren des visuellen Layouts in Kompositionen, Vorschau im Studio, Rendern zu Video, Transkribieren von Audio, Generieren von TTS oder Fehlersuche in der HyperFrames-Umgebung.

Was ist codex-marketing-skills?

Diese Fähigkeit stellt die vollständige HyperFrames-CLI zur Verfügung, ein Befehlszeilenwerkzeug zur Erstellung, Bearbeitung, Prüfung und Ausgabe von HTML-basierten Videokompositionen. Es läuft über `npx hyperframes` und erfordert Node.js >= 22 sowie FFmpeg. Der Workflow umfasst das Erstellen eines Projekts (`init`), das Schreiben von HTML-Kompositionen (unterstützt durch eine separate Fähigkeit), das Linting (`lint`) zur Erkennung von Problemen wie fehlenden `data-composition-id` Attributen oder überlappenden Tracks, die visuelle Inspektion (`inspect`) zur Überprüfung von Layout-Fehlern wie Text, der aus Containern oder der Leinwand austritt, die Vorschau (`preview`) mit Hot-Reload im Studio, das Rendern (`render`) in MP4 oder WebM mit verschiedenen Qualitätsstufen sowie Hilfsfunktionen wie Transkription (`transcribe`), Text-to-Speech (`tts`), Umgebungsdiagnose (`doctor`) und Benchmarking (`benchmark`). Die Fähigkeit ist besonders nützlich für Entwickler und KI-Agenten, die automatisiert Videoprojekte in HyperFrames erstellen, validieren und rendern möchten.

Funktioniert mit~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/rbrown101010/codex-marketing-skills/tree/HEAD/plugin-workflows/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.

Arbeitsablauf

  1. Erstellen — npx hyperframes init my-video
  2. Schreiben — HTML-Komposition verfassen (siehe die hyperframes-Fähigkeit)
  3. Linten — npx hyperframes lint
  4. Visuell prüfen — npx hyperframes inspect
  5. Vorschau — npx hyperframes preview
  6. Rendern — npx hyperframes render

Linten und prüfen Sie vor der Vorschau. lint erkennt fehlende data-composition-id, überlappende Tracks und nicht registrierte Zeitachsen. inspect öffnet die gerenderte Komposition in headless Chrome, durchsucht die Zeitachse und meldet Text, der aus Sprechblasen/Containern oder der Leinwand herausragt.

Projekterstellung

npx hyperframes init my-video                        # interaktiver Assistent
npx hyperframes init my-video --example warm-grain   # ein 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 --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-Programmierfähigkeiten. Verwenden Sie es, anstatt Dateien von Hand zu erstellen.

Linting

npx hyperframes lint                  # aktuelles Verzeichnis
npx hyperframes lint ./my-project     # bestimmtes Projekt
npx hyperframes lint --verbose        # Informationen auf Info-Ebene
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).

Visuelle Inspektion

npx hyperframes inspect                 # gerendertes Layout über die Zeitachse prüfen
npx hyperframes inspect ./my-project    # bestimmtes Projekt
npx hyperframes inspect --json          # agentenlesbare Ergebnisse
npx hyperframes inspect --samples 15    # dichterer Zeitachsendurchlauf
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 außerhalb des nächstgelegenen visuellen Containers oder der Sprechblase liegt
  • Text, der durch das eigene Feld mit fester Breite/Höhe abgeschnitten wird
  • Text, der außerhalb der Kompositionsleinwand liegt
  • Kindelemente, die aus den Clip-Containern entkommen

Fehler sollten vor dem Rendern behoben werden. Warnungen werden zur Agentenprüfung angezeigt; fügen Sie --strict hinzu, um auch bei Warnungen abzubrechen. Wiederholte statische Probleme werden standardmäßig zusammengefasst, sodass die JSON-Ausgabe für LLM-Kontextfenster kompakt bleibt. Wenn ein Überlauf für eine Ein-/Ausblendanimation 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 Quellpfad index.html:

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

Verwenden Sie den tatsächlichen Port aus der Vorschau-Ausgabe und den Projektverzeichnisnamen. Beispielsweise 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 Vorschau-Oberflä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 Renderzeit
--qualitydraft, standard, highstandarddraft zum Iterieren
--formatmp4, webmmp4WebM unterstützt Transparenz
--workers1-8 oder autoautoJeder startet Chrome
--dockerFlagausReproduzierbare Ausgabe
--gpuFlagausGPU-beschleunigte Kodierung
--strictFlagausBei Lint-Fehlern abbrechen
--strict-allFlagausBei Fehlern UND Warnungen abbrechen

Qualitätsrichtlinie: draft während des Iterierens, standard für die Überprüfung, high für die finale Auslieferung.

Transkription

npx hyperframes transcribe audio.mp3
npx hyperframes transcribe video.mp4 --model medium.en --language en
npx hyperframes transcribe subtitles.srt   # vorhandene importieren
npx hyperframes transcribe subtitles.vtt
npx hyperframes transcribe openai-response.json

Text-to-Speech

npx hyperframes tts "Text hier" --voice af_nova --output narration.wav
npx hyperframes tts script.txt --voice bf_emma
npx hyperframes tts --list  # alle Stimmen anzeigen

Fehlerbehebung

npx hyperframes doctor       # Umgebung prüfen (Chrome, FFmpeg, Node, Speicher)
npx hyperframes browser      # gebündelten 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, niedriger Speicher.

Sonstiges

npx hyperframes compositions   # Kompositionen im Projekt auflisten
npx hyperframes docs           # Dokumentation öffnen
npx hyperframes benchmark .    # Renderleistung benchmarken

Individual skills in this repo

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

Verwandte Skills