Communitygithub.com

simpletibr/simplicio-loop-marketing

Übersetzt eine Marketing-Engine-Brief-Vorlage in die Eingabeform, die der Skill `hyperframes` erwartet (Kompositionsspezifikation) sowie die Flags, die der Skill `hyperframes-cli` zum Rendern benötigt. Wird von `video-prompt-builder` ausgewählt, wenn die Routing-Matrix auf den `hyperframes`-Provider verweist.

Was ist simplicio-loop-marketing?

Dieser Skill fungiert als Brücke zwischen dem Marketing-Engine-Piece-Modell (mit Feldern wie `brief`, `task_kind` und `provider_override`) und dem Kompositionsvertrag von HyperFrames. Er spiegelt in seiner Struktur die Skills `higgsfield-prompt-builder` und `topview-prompt-builder` wider – gleicher Dispatcher, andere Zielplattform – sodass `video-prompt-builder` Provider austauschen kann, ohne seine eigene Logik ändern zu müssen. Der Skill wird immer dann aufgerufen, wenn `video-prompt-builder` den Video-Provider auf `hyperframes` auflöst und die Aufgabe (task_kind) eine der natives HyperFrames-Aufgaben ist (z. B. `motion-typography`, `data-viz-reel` oder `programmatic-short`). Zentral ist die Fähigkeit, einen Brief (Brief) zu laden, die Markenkontexte aus client-spezifischen `design.md`-Dateien zu lesen und diese als Design-Tokens in die Komposition zu übernehmen. Anschließend wird die Aufgabe (task_kind) auf eine vordefinierte Kompositionsvorlage abgebildet, variable Inhalte werden als explizit typisierte Variablen deklariert, und es werden sowohl die Kompositionsspezifikation als auch die Render-Argumente für `hyperframes-cli` erstellt. Ein wichtiges Merkmal ist die Unterstützung eines Dry-Run-Modus, der die Erstellung des Render-Artefakts simuliert, ohne tatsächlich die CLI aufzurufen. Der Skill stellt sicher, dass alle Kompositionen auch ohne Codeänderungen nur durch neue Variablenwerte erneut gerendert werden können, und erzwingt eine strenge strikte Überprüfung (z. B. `--strict-variables`), um Tippfehler frühzeitig abzufangen. Kosten werden auf 0 USD geschätzt, da es sich um lokales Rendering handelt; stattdessen wird die Wandzeit als `latency_estimate_min` protokolliert. Dieser Skill ist ein wesentlicher Bestandteil eines modularen Video-Produktions-Workflows und ermöglicht nahtloses Zusammenspiel zwischen Content-Briefing und technischem Rendering.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

HyperFrames Prompt Builder

Spezialist, der das Marketing-Engine-Piece-Modell (brief, task_kind, provider_override) und den HyperFrames-Kompositionsvertrag verbindet. Spiegelt in der Struktur higgsfield-prompt-builder und topview-prompt-builder wider – gleicher Dispatcher, unterschiedliches Ziel – sodass video-prompt-builder Provider austauschen kann, ohne seine eigene Logik zu ändern.

Wann aufrufen

  • video-prompt-builder löst den Video-Provider auf hyperframes für ein Piece auf.
  • task_kind ist einer der Werte motion-typography, data-viz-reel, programmatic-short (die natives HyperFrames-Aufgaben in PROVIDERS.md).
  • Ein Piece deklariert provider_override.video: hyperframes in seinem Frontmatter.
  • Ein genehmigtes Standbild (Zitatkarte von gpt-image, Karussell von topview) wird zur Bewegung hochgestuft und das Typsystem muss bytegetreu zum Original bleiben.
  • Der Orchestrator benötigt die gleiche Komposition mit neuen Variablenwerten neu gerendert (wöchentlicher KPI-Reel, tägliches Preis-Update, A/B-Varianten-Text), ohne einen KI-Generator neu anzufragen.

Eingaben

  • brief: Objekt. Die Piece-Brief mit mindestens headline, body?, cta?, aspect, duration_seconds.
  • task_kind: "motion-typography" | "data-viz-reel" | "programmatic-short".
  • piece_path: Zeichenkette, optional. Pfad zu .specs/pieces/<piece-id>.md. Frontmatter kann provider_override, compliance_flags, variables enthalten.
  • client_slug: Zeichenkette. Wird verwendet, um .marketing-engine/clients/<slug>/design.md (oder clients/<slug>/design.md im Engine-Repo) zu laden.
  • output_dir: Zeichenkette. Wo das Projekt und die endgültige MP4-Datei liegen (Standard: outputs/<client>/<date>/<piece-id>/).
  • dry_run: Boolesch, optional. Wenn true, wird die Kompositionsspezifikation und die Render-Argumente zurückgegeben, ohne hyperframes-cli aufzurufen.

Ablauf

  1. Markenkontext laden. clients/<client_slug>/design.md lesen und { colors, type_pairing, spacing_scale, brand_voice } auflösen. Fehlt die Datei, wird die Verarbeitung verweigert – den fehlenden Pfad anzeigen. Markenverstöße können nachgelagert nicht behoben werden.
  2. Überschreibungen auflösen. Wenn piece_path gesetzt ist und das Frontmatter provider_override.video enthält, bestätigen, dass es hyperframes ist; andernfalls sollte dieser Skill nicht ausgeführt werden.
  3. Task-Kind auf eine Kompositionsvorlage abbilden.
    • motion-typography → kinetic-type-Vorlage, eine Szene, typgetrieben.
    • data-viz-reel → nyt-graph-Vorlage, Hauptszene mit deklarierten numerischen Variablen.
    • programmatic-short → play-mode-Vorlage, Hook/Body/CTA, der gesamte Kundentext als Variablen deklariert.
  4. Variablen deklarieren. Alles aus der Brief, das sich bei jedem Neurendern ändern könnte (Überschrift, Text, KPI-Zahlen, CTA, Datumsstempel), wandert in variables mit explizitem Typ + Bezeichnung + Standardwert. Hartcodierte Texte sind verboten, wenn eine Variable funktionieren würde.
  5. Kompositionsspezifikation erstellen in der Form, die hyperframes erwartet: { composition_id, aspect, duration_seconds, scenes, design_tokens, variables, assets, output_dir }. composition_id aus <piece-id> berechnen (slug-sicher).
  6. Render-Argumente erstellen in der Form, die hyperframes-cli erwartet: { project_path, mode: "render", render_opts: { fps, quality, format, variables, strict: true, strict_variables: true, output } }. quality: "high" für hochgestufte Pieces, "draft" für die Erstbegutachtung.
  7. Kostenschätzung. Lokales Rendern – Schätzung aus duration_seconds × workers × $0.00 (keine Auslagen; stattdessen Wandzeit in Minuten als latency_estimate_min melden).
  8. Auflösung protokollieren in data/video-usage.jsonl mit { ts, provider: "hyperframes", piece_id, task_kind, composition_id, dry_run }.
  9. Wenn dry_run, ohne Aufruf von hyperframes-cli zurückgeben. Andernfalls hyperframes aufrufen (um das Projekt zu erstellen), dann hyperframes-cli (Modus lint → inspect → render) in dieser Reihenfolge.

Ausgaben

  • provider_used: "hyperframes".
  • composition_spec: Objekt. Die Eingabe, die an den Skill hyperframes übergeben wird.
  • render_args: Objekt. Die Eingabe, die an den Skill hyperframes-cli übergeben wird (Modus render).
  • expected_artifact: Zeichenkette. Der MP4-Pfad, der nach dem Rendern existieren wird.
  • latency_estimate_min: Zahl. Geschätzte Wandzeit für das Rendern.
  • cost_estimate_usd: 0 (lokales Rendern; nur Betriebskosten).

Beispiele

Beispiel 1: Wöchentlicher KPI-Reel (programmatic-short)

Eingabe: { brief: { headline: "Semana 21 em números", aspect: "9:16", duration_seconds: 12 }, task_kind: "programmatic-short", client_slug: "saas-consultoria-imagem", piece_path: ".specs/pieces/2026-05-22-kpi.md" } Ausgabe: Kompositionsspezifikation mit composition_id: "kpi-weekly-2026-05-22", drei Szenen (Hook/Body/CTA), numerischen Variablen (leads, delta_pct); Render-Argumente mit --strict --strict-variables --quality high --variables '{"leads":42,"delta_pct":12}'.

Beispiel 2: Bewegte Zitatkarte (motion-typography)

Eingabe: { brief: { headline: "Coloque a sua marca onde os olhos já estão.", aspect: "1:1", duration_seconds: 6 }, task_kind: "motion-typography", client_slug: "saas-consultoria-imagem" } Ausgabe: Kompositionsspezifikation mit einer einzelnen kinetischen Typoszene, maskiertem Texteingang, Design-Tokens aus dem aktiven Client-design.md; Render-Argumente mit Ziel outputs/saas-consultoria-imagem/<date>/<piece-id>/final.mp4.

Beispiel 3: Provider-Überschreibung

Eingabe: Ein Piece mit provider_override.video: hyperframes, dessen task_kind nicht in der Matrix ist. Ausgabe: Trotzdem hierher geroutet, Standard-task_kind auf programmatic-short, Fallback protokollieren.

Unverhandelbare Regeln

  • Niemals Design-Tokens erfinden. Verarbeitung verweigern, wenn design.md fehlt.
  • Piecespezifischen Text immer als variable deklarieren, auch wenn er statisch erscheint – die Komposition muss ohne Code-Änderungen neurenderbar sein.
  • Immer --strict-variables in den Render-Argumenten übergeben. Ein Tippfehler in einer Variablen-ID ist ein harter Fehler.
  • Niemals hyperframes-cli direkt aufrufen, ohne die Reihenfolge lint → inspect → render einzuhalten.

Fehlermodi

  • Unbekannte task_kind: Standard auf programmatic-short, eine Warnung protokollieren und fortfahren.
  • design.md fehlt: Anhalten. Keine Farbpalette wählen; den Operator bitten, die Datei hinzuzufügen.
  • Brief enthält eine markenrechtlich unzulässige Behauptung (gemäß compliance-<aktiver Client>): Blockieren vor der Autorenschaft; Compliance läuft vorgelagert zum Rendern.
  • HyperFrames CLI nicht installiert: Installationsbefehl anzeigen (npm i -g hyperframes oder npx hyperframes@latest) und anhalten.

Verwandte Skills

  • hyperframes: Kompositions-Erstellungsregeln (von diesem Skill konsumiert).
  • hyperframes-cli: Ausführung von Lint/Inspect/Render (von diesem Skill konsumiert).
  • video-prompt-builder: Dispatcher, der diesen Skill auswählt.
  • qa-tech-specs: Wird gegen die fertige MP4 ausgeführt.
  • compliance-<aktiver Client> / compliance-generic: Wird gegen die aufgelösten Variablen und das gerenderte Artefakt ausgeführt.
  • llm-router: Wird hier nicht direkt verwendet, kann aber das LLM auswählen, das die Überschrift/den Text entwirft, bevor dieser Skill die Kompositionsspezifikation erstellt.

Individual skills in this repo

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

Verwandte Skills