Communitygithub.com

HyperFrames CLI

Nutze den HyperFrames CLI-Entwicklungszyklus: init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, single oder batch render, publish, cloud, cloudrun, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, auth, tts und remove-background. Auch nützlich zur Diagnose von Build- oder Render-Fehlern. validate, inspect und layout sind veraltete Aliase; benutze check. Deckt lokales, HeyGen-gehostetes Cloud-, AWS Lambda- und Google Cloud Run-Rendering ab.

Was ist HyperFrames CLI?

Die HyperFrames CLI ist ein umfassendes Werkzeug für die Entwicklung und das Rendering von KI-gestützten Videokompositionen. Sie bietet einen vollständigen Entwicklungszyklus von der Initialisierung über das Authoring und Linting bis hin zum abschließenden Check und Rendering. Die CLI unterstützt mehrere Rendering-Plattformen: lokal (mit Docker), HeyGen-gehostetes Cloud-Rendering, AWS Lambda und Google Cloud Run. Sie ist für die Verwendung mit Node.js 22+ und FFmpeg konzipiert. Besondere Merkmale sind die Storyboard-Vorschau vor der Kompositionsprüfung, die finale Vorschau vor dem Rendering, Snapshot-Tests für Unterkompositionen und ein umfangreiches System von Referenzdokumenten, die vor der Ausführung spezifischer Befehle gelesen werden müssen. Die CLI bietet JSON-Ausgabe für CI/CD-Integrationen, strenge Prüfmodi und ein integriertes Feedbacksystem. Entwickler können damit Videos mit variablengetriebenen Batch-Renderings, Untertitel, TTS und Hintergrundentfernung erstellen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dbillion/hermes-skills-public/tree/HEAD/skills-external/hyperframes-cli

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht HyperFrames CLI?

Führe Befehle als npx hyperframes ... aus, sofern die Projektanweisungen keinen Wrapper bereitstellen. Befolge den Wrapper, falls vorhanden. Die CLI erfordert Node.js 22 oder neuer und FFmpeg.

Entwicklungszyklus

  1. Gerüst: npx hyperframes init <Projekt> oder eine Seite erfassen. Im Nicht-TTY-Modus übergib --non-interactive --example=<Name>.
  2. Autor: Schreibe die Komposition mit /hyperframes-core.
  3. Schnelles Feedback beim Bearbeiten: Führe npx hyperframes lint nach dem ersten HTML-Durchlauf und nach strukturellen Änderungen aus.
  4. Führe das finale Gate aus: Führe npx hyperframes check aus; es führt lint vor dem Öffnen des Browsers erneut aus. Füge keinen redundanten eigenständigen lint-Aufruf hinzu. Füge --snapshots für kommentierte Übersichtsbilder und zum Auffinden von Ausschnitten hinzu.
  5. Überprüfe Unterkompositionen: Wenn index.html data-composition-src einbindet, erfasse Zwischenschnappschüsse und überprüfe jede eingebundene Szene.
  6. Öffne die finale Studio-Vorschau: Führe npx hyperframes preview aus, übergib dem Benutzer die Timeline-Projekt-URL und frage, ob überarbeitet oder gerendert werden soll.
  7. Rendere nur nach Freigabe: Verwende Entwurfsqualität für Iterationen und hohe Qualität für die Auslieferung.
  8. Überprüfe die Ausgabe: Stelle sicher, dass die Datei existiert, nicht leer ist und eine plausible Dauer hat.
# Schnelle Iterationsprüfung; bei Bedarf während des Authorings wiederholen.
npx hyperframes lint

# Erforderliches finales Gate; enthält lint.
npx hyperframes check
npx hyperframes preview
npx hyperframes render --quality high --output out.mp4
test -s out.mp4
ffprobe -v error -show_format out.mp4

check führt zuerst lint aus, verwendet dann eine Browsersitzung und einen Suchdurchlauf, um Laufzeitfehler, fehlgeschlagene Anfragen, Layout, *.motion.json-Assertions und WCAG-Kontrast zu prüfen. Dauerhafte Befunde blockieren den Exit-Code; vorübergehende Ein- oder Ausgangsbefunde sind informativ. Verwende --strict, um Warnungen zu blockieren. validate, inspect und layout bleiben aus Kompatibilitätsgründen Aliase, sollten aber nicht in neuen Anweisungen oder Skripten vorkommen.

Zwei verschiedene Vorschauoberflächen

Verwechsle diese Zustände nicht:

OberflächeWann sie geöffnet werden darfZweck
Storyboard-BoardVor Kompositionsprüfungen, nur wenn storyboard: yesÜberprüfung der Planungskarten und Drahtgitterskizzen. Öffne ?view=storyboard#project/<Name>.
Finale KompositionsvorschauNach bestandenem checkÜberprüfung der zusammengebauten Timeline vor dem Rendern. Öffne #project/<Name>.

Das frühe Board ist keine Freigabe des finalen Videos. Rendering erfordert immer die finale Freigabe, wie in hyperframes-core/references/review-loop.md definiert.

Rauchtest für Unterkompositionen

Statische Prüfungen können nicht jeden Einbettungsfehler erkennen. Wenn das Projekt Unterkompositionen verwendet, erfasse mindestens einen sichtbaren Mittelpunkt für jeden Host-Slot:

npx hyperframes snapshot --at <t1>,<t2>,<t3>

Behandle winzigen ungestylten Inhalt, leinwandgroße Symbole, fehlende Hero-Elemente oder Timeout bei der Timeline-Registrierung als renderverschlechternde Einbettungsfehler. Siehe hyperframes-core/references/sub-compositions.md für die entsprechenden Korrekturen.

Agentenkonventionen

  • Bevorzuge --json für Agenten- und CI-Aufrufe. Servermodus render, preview und play liefern keine normale JSON-Ausgabe; preview --selection --json und preview --context --json sind Ausnahmen im Abfragemodus.

  • doctor --json beendet sich immer mit Exit-Code 0. Prüfe auf sein Payload:

    npx hyperframes doctor --json | jq -e '.ok' >/dev/null
    
  • Der Nicht-TTY-Modus ist automatisch. init erfordert dort --example; verwende --non-interactive, um deterministisches Verhalten auf einem TTY zu erzwingen.

  • Verwende eine HYPERFRAMES_RUN_ID für alle Befehle im selben Verifizierungszyklus.

  • Verwende --strict, --strict-all und --strict-variables, wenn die entsprechenden Warnungen, Variablen oder CI-Bedingungen das Rendern blockieren müssen.

  • JSON-Pfade redigieren das Home-Verzeichnis als $HOME; versuche nicht, die Redaktion rückgängig zu machen.

  • Rendere niemals nur, weil Prüfungen bestanden wurden. Halte bei der finalen Vorschau an und warte auf Freigabe.

Studio-gesteuerte Bearbeitungen

Wenn der Benutzer sich auf „dieses Element“ oder die aktuelle Auswahl bezieht, frage Studio ab, anstatt zu raten:

npx hyperframes preview --context --json --context-fields selection

Verwende selection.target.hfId, wenn verfügbar, andernfalls seinen Selektor und die Quelldatei. Wenn das Ergebnis no-selection meldet, bitte den Benutzer, auf das Element zu klicken und den Befehl erneut auszuführen. Fordere nur die benötigten Kontextausschnitte an; verwende --context-detail full nur für berechnete Stile oder bearbeitbare Textmetadaten. Vollständiges Verhalten und Fehlercodes befinden sich in references/preview-render.md.

Render-Optionen

BedarfBefehl
Schnelle lokale Iterationnpx hyperframes render --quality draft
Finale lokale Auslieferungnpx hyperframes render --quality high --output out.mp4
Reproduzierbarer Container-Rendernpx hyperframes render --docker --strict --output out.mp4
Lokaler variablengetriebener Batch-Rendernpx hyperframes render --batch rows.json --output "renders/{name}.mp4"
HeyGen-gehostetes Null-Infrastruktur-Rendernpx hyperframes cloud render
Selbstverwalteter verteilter AWS-Rendernpx hyperframes lambda render <Projekt> --width 1920 --height 1080 --wait
Selbstverwalteter verteilter GCP-Rendernpx hyperframes cloudrun render <Projekt> --width 1920 --height 1080 --wait

Verwende Cloud-Rendering, wenn der Benutzer gehostetes Rendering ohne lokales Chrome, FFmpeg oder AWS wünscht. Verwende Lambda nur, wenn AWS-Besitz Anforderung ist. Verwende Cloud Run nur, wenn GCP-Besitz Anforderung ist. Lies die passende Referenz, bevor du einen Cloud-Pfad ausführst.

Nach der Überprüfung eines erfolgreichen Renderings sende einen Feedback-Bericht, es sei denn, Telemetrie ist deaktiviert oder der Benutzer hat abgelehnt:

npx hyperframes feedback --rating <0-10> --comment "<spezifisches Ergebnis oder Reibung>"

Halte sauberes Lauffeedback kurz. Erfasse bei Fehlern oder Reibungen ein Reproduktionspaket, bevor du es einreichst; sende nicht nur eine Symptomzusammenfassung. Füge den wiederholbaren Befehl und das Arbeitsverzeichnis, erwartetes vs. tatsächliches Verhalten, genauen Fehler, ob die Ausgabe abgeschlossen/zurückgefallen/fehlgeschlagen ist, Workaround und Reproduktionsprojektstatus hinzu. Wenn das Problem nicht reproduziert werden konnte, sage das und füge dennoch den letzten fehlgeschlagenen Befehl und die Logs bei. Verwende --file-issue nur mit Zustimmung: Es veröffentlicht eine minimale Reproduktion auf eine öffentliche URL. Das erforderliche Paketformat und den Datenschutzhinweis findest du in references/preview-render.md.

Lies die passende Referenz, bevor du einen Befehl ausführst

Die folgenden Referenzen und zugehörigen Fähigkeiten sind verbindliche Befehlsverträge, keine optionale Hintergrundlektüre. Bevor du einen Befehl in der Tabelle ausführst, lies die entsprechende Zeile.

BedarfReferenz
init, capture, skillsreferences/init-and-scaffold.md
lint, check, Motion-Seitendateien, snapshotreferences/lint-validate-inspect.md
compare, grade-compare, variablengetriebenes render --batchreferences/compare-and-batch.md
beats für das Studio-Beat-Raster eines bestehenden Projektsreferences/beats.md
preview, play, render, publish, Studio-Kontext, Feedbackreferences/preview-render.md
doctor, Browser-Verwaltungreferences/doctor-browser.md
auth, HeyGen-gehostetes Cloud-Rendering und Vorlagenvariablenreferences/cloud.md
AWS Lambda-Bereitstellung und -Renderingreferences/lambda.md
Google Cloud Run-Bereitstellung und -Renderingreferences/cloudrun.md
info, upgrade, compositions, docs, benchmark, Telemetrie, Medienvorverarbeitungreferences/upgrade-info-misc.md

Für Kompositionsvariablen lies auch /hyperframes-core → references/variables-and-media.md. Für hyperframes add und hyperframes catalog verwende /hyperframes-registry. Vor hyperframes present lies /slideshow; vor hyperframes keyframes lies /hyperframes-keyframes. Für TTS, Transkription, Untertitel oder Hintergrundentfernungsoptionen verwende /media-use.

Die spezialisierten Befehle sind absichtlich von ihren zugehörigen Workflows dokumentiert:

npx hyperframes present <Projekt-Verzeichnis> --port 3004 --no-open
npx hyperframes beats <Projekt-Verzeichnis> --json
npx hyperframes keyframes <Projekt-Verzeichnis> --json

present dient ein navigierbares Deck mit Präsentator- und Publikumssynchronisation. beats ist das eigenständige Studio-Beat-Raster-Werkzeug, definiert in references/beats.md. keyframes liefert suchsichere Animations- und Bewegungspfad-Diagnosen.

Individual skills in this repo

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

dbillion/hermes-skills-public

Edit an existing image based on a text prompt.

dbillion/hermes-skills-public

Add `flutter_localizations` and `intl` dependencies, enable "generate true" in `pubspec.yaml`, and create an `l10n.yaml` configuration file. Use when initializing localization support for a new Flutter project.

dbillion/hermes-skills-public

Expert in video composition, editing, and format conversion. Use when the user wants to generate high-quality video, overlay images on video, concatenate clips, create GIFs, or sync audio to video using mcp-avtool-go and mcp-veo-go.

dbillion/hermes-skills-public

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). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

dbillion/hermes-skills-public

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. Also covers Tailwind projects and the STORYBOARD.md / SCRIPT.md plan formats. Read before writing composition HTML.

dbillion/hermes-skills-public

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

Verwandte Skills