Communitygithub.com

simpletibr/simplicio-loop-marketing

Führt den HyperFrames CLI-Entwicklungszyklus aus – init, lint, inspect, preview, render – für Kompositionen, die unter der `hyperframes`-Fähigkeit erstellt wurden. Wird aufgerufen, nachdem das Kompositions-HTML auf der Festplatte liegt und bevor das Stück als abgeschlossen markiert wird.

Was ist simplicio-loop-marketing?

Diese Fähigkeit (Skill) automatisiert den vollständigen Entwicklungs-Workflow der HyperFrames CLI für Marketing-Kompositionen. Sie stellt sicher, dass Kompositionen validiert (lint, inspect), lokal in der Vorschau betrachtet (preview) und schließlich als MP4-Video gerendert werden (render). Die Fähigkeit ist eng mit den Skills `hyperframes` (Kompositionserstellung), `hyperframes-prompt-builder` (Brief zu Spezifikation) und `qa-tech-specs` (Qualitätssicherung) verknüpft. Sie unterstützt Node.js >= 22 und FFmpeg, arbeitet standardmäßig im DRY_RUN-Modus und setzt auf nicht verhandelbare Regeln, wie z. B. dass vor einem Render immer ein erfolgreicher Lint- und Inspect-Durchlauf erforderlich ist und dass Variablenüberladungen streng validiert werden. Die Fähigkeit behandelt verschiedene Modi wie `lint`, `inspect`, `preview`, `render` und `doctor` und gibt strukturierte JSON-Ausgaben zurück. Sie ist für die Verwendung in orchestrierten Pipelines konzipiert, bei denen Fehler explizit gemeldet und behoben werden müssen, bevor der nächste Schritt ausgeführt wird.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/simpletibr/simplicio-loop-marketing/tree/HEAD/.skills/hyperframes-cli

In Ihrer bevorzugten KI fragen

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

Dokumentation

HyperFrames CLI

Kapselt npx hyperframes für die Marketing-Engine-Pipeline. Erfordert Node.js >= 22 und FFmpeg im Pfad (Überprüfung mit npx hyperframes doctor). Alle Befehle werden standardmäßig im DRY_RUN-sicheren Modus ausgeführt – die Lint-/Inspect-Durchläufe haben keine externen Aufrufe; nur render schreibt eine MP4-Datei.

Wann aufrufen

  • Unmittelbar nachdem hyperframes-prompt-builder ein Projekt unter outputs/<client>/<date>/<piece-id>/ erstellt hat.
  • Immer wenn eine Komposition vor der Veröffentlichung validiert werden muss (lint + inspect).
  • Für die lokale Vorschau während der Iteration an einem Stück (preview).
  • Für den finalen Render, der das Artefakt erzeugt, das vom Veröffentlichungsschritt aufgenommen wird (render).
  • Zur Umgebungsfehlerbehebung, wenn der Render fehlschlägt (doctor, browser, info).

Eingaben

  • project_path: Zeichenkette. Pfad zum HyperFrames-Projekt (muss index.html und composition.json enthalten).
  • mode: "lint" | "inspect" | "preview" | "render" | "doctor".
  • render_opts: Objekt, optional, nur für mode = "render". Erkannte Schlüssel:
    • fps: 24 | 30 | 60 (Standard 30).
    • quality: "draft" | "standard" | "high" (Standard "standard"; während der Iteration "draft" verwenden).
    • format: "mp4" | "webm" (Standard "mp4").
    • variables: Objekt. JSON-Objekt, das nach Variablen-ID gruppiert ist und die Standardwerte von data-composition-variables überschreibt.
    • strict: Boolescher Wert. Bildet auf --strict ab. Standardmäßig true in der Pipeline – Render bei Lint-Fehlern abbrechen.
    • strict_variables: Boolescher Wert. Bildet auf --strict-variables ab. Standardmäßig true für Piece-Läufe.
    • workers: Ganzzahl 1-8 oder "auto". Standard "auto".
    • output: Zeichenkette. Ausgabedateipfad innerhalb von outputs/<client>/<date>/<piece-id>/.

Ablauf

  1. Umgebung überprüfen beim ersten Start einer Sitzung: npx hyperframes doctor. Fehlendes FFmpeg oder Chrome als hartes Hindernis melden – nicht versuchen zu rendern.
  2. Lint. npx hyperframes lint <project_path> --json. Alle Fehler der Stufe error als Hindernisse behandeln. Warnungen werden an den Orchestrator weitergegeben; der Bediener entscheidet.
  3. Inspect. npx hyperframes inspect <project_path> --json. Gemeldete Textüberläufe oder Canvas-Eskapaden vor dem Render beheben. Wenn der Überlauf für einen Ein-/Ausgang beabsichtigt ist, das Element mit data-layout-allow-overflow markieren (oder den Vorfahren für dekorative Elemente mit data-layout-ignore) – die Regel nicht global unterdrücken.
  4. Preview (nur Bediener). npx hyperframes preview <project_path> --port <port>. Die Studio-Projekt-URL (http://localhost:<port>/#project/<project-name>) zurückgeben, nicht den Quellpfad index.html.
  5. Render. npx hyperframes render <project_path> mit den Flags aus render_opts. Das --variables-Argument aus render_opts.variables mit einem einzeiligen JSON-String erstellen. Für Piece-Läufe immer --strict und --strict-variables übergeben.
  6. Ausgabe überprüfen. Nach dem Render prüfen, ob die MP4 existiert und nicht null ist. In data/video-usage.jsonl protokollieren mit { ts, provider: "hyperframes", composition_id, render_args, duration_seconds, file_bytes, latency_ms }.

Ausgaben

  • lint: { pass: boolean, errors: [...], warnings: [...] }.
  • inspect: { pass: boolean, findings: [...] }.
  • render: { artifact_path: string, duration_s: number, file_bytes: number, render_ms: number }.
  • preview: { url: string }.

Befehlsspickzettel

npx hyperframes init <name>                            # Gerüst erstellen (einmal pro Stück vom Prompt-Builder verwendet)
npx hyperframes lint <path>                            # Markup validieren
npx hyperframes inspect <path>                         # Layout-/Überlaufprüfung
npx hyperframes preview <path> --port 3017             # Lokale Entwicklung
npx hyperframes render <path> \
  --fps 30 --quality standard --strict --strict-variables \
  --variables '{"leads":42,"delta_pct":12}' \
  --output outputs/<client>/<date>/<piece-id>/final.mp4
npx hyperframes doctor                                 # Umgebungsprüfung
npx hyperframes info                                   # Versions-/Umgebungsdetails

Nicht verhandelbare Regeln

  • Niemals ohne einen bestandenen lint- und inspect-Durchlauf rendern. Die Pipeline hat keinen Wiederherstellungspfad für eine fehlerhafte Komposition.
  • Niemals einen Lint- oder Inspect-Befund global unterdrücken – das Markup korrigieren oder das spezifische Element mit data-layout-allow-overflow / data-layout-ignore auf die Whitelist setzen.
  • Bei Stücken mit deklarierten Variablen immer --strict-variables übergeben. Ein Tippfehler in einer Variablen-ID muss laut scheitern, nicht stillschweigend auf den Standardwert zurückfallen.
  • Für finale Auslieferungs-Render: --quality high. Für Iterationsschleifen: --quality draft, um Rechenleistung zu sparen.
  • Asset-Vorverarbeitung (tts, transcribe, remove-background) liegt außerhalb des Rahmens dieser Fähigkeit – diese über eine zukünftige hyperframes-media-Fähigkeit aufrufen, anstatt sie hier einzubetten.

Fehlermodi

  • doctor meldet fehlendes FFmpeg oder Chrome: über die Setup-Anweisungen des Projekts installieren; keine Umgehung.
  • render schlägt fehl mit unknown variable: ein über --variables übergebener Schlüssel ist nicht in data-composition-variables deklariert. Markup korrigieren oder die Überschreibung entfernen.
  • render überschreitet das Wandzeit-Budget: --quality auf standard reduzieren oder die Komposition in Unterkompositionen aufteilen und über --workers parallelisieren.
  • Ausgabe-MP4 hat null Bytes: doctor erneut ausführen; fast immer ein Chrome-Absturz während der Aufnahme.

Verwandte Fähigkeiten

  • hyperframes: Kompositionserstellungsregeln; erzeugt das Projekt, das diese Fähigkeit validiert und rendert.
  • hyperframes-prompt-builder: Brief → Kompositionsspezifikation; läuft vor dieser Fähigkeit.
  • qa-tech-specs: Läuft nach dieser Fähigkeit gegen das gerenderte MP4, um Plattformspezifikationen zu validieren.

Upstream-Referenz

Vollständige Upstream-Fähigkeit (jedes Flag, Fehlerbehebungsmatrix, parametrisierte Render): https://github.com/wesleysimplicio/hyperframes/tree/main/skills/hyperframes-cli

Individual skills in this repo

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

Verwandte Skills