Communitygithub.com

simpletibr/simplicio-loop-marketing

Stellt einen Prompt zur Videogenerierung zusammen, indem der Anbieter über PROVIDERS.md ausgewählt und an den entsprechenden anbieterspezifischen Builder delegiert wird.

Was ist simplicio-loop-marketing?

Diese Skill fungiert als generischer, anbieterunabhängiger Verteiler für Videogenerierungs-Prompts. Sie liest die Routing-Matrix in `.specs/architecture/PROVIDERS.md`, entscheidet anhand der Aufgabe (`task_kind`), welcher Anbieter (Higgsfield, Topview, Wavespeed, Hyperframes) das Video generieren soll, und delegiert dann an die spezialisierte Builder-Skill (z. B. `higgsfield-prompt-builder`, `topview-prompt-builder`, `wavespeed-batch`, `hyperframes-prompt-builder`). Der Skill verarbeitet einen visuellen Brief (`brief`) mit Feldern wie Motiv, Bewegung, Stimmung, Seitenverhältnis und Dauer, übersetzt diese in das vom jeweiligen Anbieter erwartete Eingabeformat und ruft dann das entsprechende MCP-Tool auf. Er unterstützt auch einen `dry_run`-Modus, der nur den ausgewählten Anbieter und die Parameter zurückgibt, ohne das MCP tatsächlich aufzurufen. Zu den typischen Anwendungsszenarien gehören die Erstellung von Kinoreels, User-Generated-Content (UGC), Produktdemos, Sprachaufnahmen, Bewegungsgrafiken und programmatischen Kurzvideos. Der Skill protokolliert jeden Durchlauf in einer JSONL-Datei und behandelt Fehler wie fehlende Umgebungsvariablen oder unbekannte Aufgabentypen mit definierten Fallbacks.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Video-Prompt-Builder

Generischer, anbieterunabhängiger Verteiler für Videogenerierungs-Prompts. Liest die Routing-Matrix in .specs/architecture/PROVIDERS.md, entscheidet, welcher Anbieter den Auftrag ausführen soll, und delegiert an den richtigen Spezialisten (higgsfield-prompt-builder, topview-prompt-builder, wavespeed-batch, hyperframes-prompt-builder).

Wann aufrufen

  • Jeder Videogenerierungsschritt in der Pipeline (Brief -> Skript -> Creative, wenn der Creative-Typ Video ist).
  • Wenn ein Piece type: video in .specs/pieces/*.md deklariert.
  • A/B-Tests von Video-Hooks über mehrere Anbieter hinweg und der Orchestrator benötigt einen einheitlichen Einstiegspunkt.
  • Erneute Ausführung desselben Briefs auf einem anderen Anbieter, nachdem ein A/B-Gewinner ermittelt wurde.
  • Wenn ein vorgeschalteter Agent einen Brief hat, aber nicht weiß, welchen Anbieter er wählen soll.

Eingaben

  • brief: Objekt. Visueller Brief mit mindestens subject, motion, mood, aspect, duration_seconds.
  • task_kind: Zeichenkette. Einer von cinematic_reel, motion_control, ugc_product_holder, product_demo, talking_head, batch_hook_test, motion_typography, data_viz_reel, programmatic_short.
  • piece_path: Zeichenkette, optional. Pfad zur Piece-Datei. Kann provider_override.video enthalten.
  • dry_run: Boolesch, optional. Wenn wahr, wird der aufgelöste Anbieter und die Parameter zurückgegeben, ohne das MCP aufzurufen.

Ablauf

  1. .specs/architecture/PROVIDERS.md lesen und die Video-Matrix in eine task_kind -> provider-Zuordnung parsen.
  2. Wenn piece_path gesetzt ist und provider_override.video enthält, wird der Überschreibungswert verwendet.
  3. Sonst task_kind in der Matrix nachschlagen. Bei Unbekanntheit auf den Matrix-Standardwert für cinematic_reel zurückfallen.
  4. Überprüfen, ob die Umgebungsvariablen für den ausgewählten Anbieter gesetzt sind (HIGGSFIELD_MCP_ACTIVE, TOPVIEW_API_KEY, WAVESPEED_API_KEY, HYPERFRAMES_ACTIVE).
  5. Anbieter auf Spezialisten-Skill abbilden: Higgsfield -> higgsfield-prompt-builder, Topview -> topview-prompt-builder, Wavespeed -> wavespeed-batch, Hyperframes -> hyperframes-prompt-builder.
  6. brief-Felder in die vom Spezialisten erwartete Eingabeform übersetzen.
  7. Den Spezialisten aufrufen und dessen params und mcp_tool-Ausgabe erfassen.
  8. Wenn dry_run, den aufgelösten Anbieter, die Parameter und das MCP-Tool zurückgeben. Andernfalls das MCP aufrufen und die Artefakt-Referenz zurückgeben.
  9. Den Lauf mit Zeitstempel, Anbieter, task_kind und Ergebnis in data/video-usage.jsonl protokollieren.

Ausgaben

  • provider_used: Zeichenkette.
  • params: Objekt. Endgültiges Parameterobjekt für den MCP-Aufruf.
  • mcp_tool: Zeichenkette. Der Name des MCP-Tools.
  • artifact_ref: Zeichenkette, wenn nicht im dry_run-Modus. Pfad oder URL zum generierten Video.
  • cost_estimate_usd: Zahl.

Beispiele

Beispiel 1: Kinoreel an Higgsfield weitergeleitet

Eingabe: { brief: { subject: "Model im Leinenanzug", motion: "Tracking Shot", mood: „redaktionell“, aspect: “9:16”, duration_seconds: 6 }, task_kind: „cinematic_reel“ } Ausgabe: { provider_used: “higgsfield“, mcp_tool: “higgsfield_seedance_generate“, params: {...} }

Beispiel 2: UGC-Anzeige an Topview weitergeleitet

Eingabe: { brief: { subject: “Hautpflegeflasche, gehalten von Avatar“, motion: “statisch”, mood: “freundlich”, aspect: “9:16”, duration_seconds: 15 }, task_kind: “ugc_product_holder” } Ausgabe: { provider_used: “topview“, mcp_tool: “topview_avatar_generate“, params: {...} }

Beispiel 3: Wöchentlicher KPI-Reel an Hyperframes weitergeleitet

Eingabe: { brief: { headline: “Semana 21 em números”, aspect: “9:16”, duration_seconds: 12, variables: { leads: 42, delta_pct: 12 } }, task_kind: “programmatic_short” } Ausgabe: { provider_used: “hyperframes”, mcp_tool: “hyperframes_render”, params: { composition_spec: {...}, render_args: {...} } } — lokales Rendering über die Skills hyperframes + hyperframes-cli.

Fehlermodi

  • task_kind nicht in der Matrix: Eine Warnung protokollieren und den Standardwert cinematic_reel verwenden.
  • Erforderliche Umgebungsvariable für den ausgewählten Anbieter fehlt: zum nächsten Anbieter in der Matrix wechseln und eine Warnung ausgeben.
  • Spezialisten-Skill gibt einen Fehler zurück: Fehler weiterleiten und nicht automatisch auf einem anderen Anbieter wiederholen, es sei denn, der Aufrufer stimmt zu.
  • Dauer überschreitet das Anbieter-Limit: auf das Maximum des Anbieters kürzen und einen Hinweis ausgeben.

Verwandte Skills

  • higgsfield-prompt-builder: Spezialist für Soul, DoP, Seedance.
  • topview-prompt-builder: Spezialist für UGC- und Avatar-gesteuerte Anzeigen.
  • wavespeed-batch: Spezialist für günstige Batch-Hook-Tests.
  • hyperframes-prompt-builder: Spezialist für HTML-gerenderte Bewegungsgrafiken, Datenvisualisierungs-Reels und parametrisierte programmatische Kurzvideos.
  • llm-router: Separater Verteiler für Textgenerierung; gleiches Muster, andere Domäne.
  • qa-tech-specs: Validiert das endgültige Video gegen die Plattformspezifikation.

Individual skills in this repo

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

Verwandte Skills