Communitygithub.com

simpletibr/simplicio-loop-marketing

Erstellt HTML-basierte Motion-Compositions (Kinetische Typografie, Motion-Quote-Cards, programmatische Datenvisualisierungs-Reels) für den HyperFrames-Renderer. Wird verwendet, wenn der von der Routing-Matrix aufgelöste Video-Provider `hyperframes` ist.

Was ist simplicio-loop-marketing?

Diese Fähigkeit (`simpletibr/simplicio-loop-marketing`) ermöglicht es, deterministische Motion-Compositions ausschließlich über HTML, CSS und GSAP-Animationen zu definieren, die dann mit HyperFrames – einem Apache 2.0 lizenzierten HTML-zu-MP4-Renderer – gerendert werden. Der Arbeitsablauf beginnt stets mit dem Lesen der Marken-Tokens aus der client-spezifischen `design.md` (oder den übergebenen Design-Tokens), bevor das HTML geschrieben wird. Die erstellten Kompositionen bestehen aus einer narrativen Struktur (Hook, Body, CTA) mit festgelegten Szenen, Übergängen und parametrisierten Variablen, die zur Rendering-Zeit überschrieben werden können. Strikte Regeln erzwingen, dass alle Animationen über `paused: true` registrierte GSAP-Timelines laufen, keine Zufallslogik (`Math.random()`, `Date.now()`) enthalten und als Audio-Separation (Video stumm, Audio auf separatem <audio>-Element) erfolgen. Vor dem Rendern wird mit `npx hyperframes lint` und `npx hyperframes inspect` die Korrektheit validiert; erst nach bestandener Prüfung wird das Video ausgegeben. Die Fähigkeit wird auf allen gängigen Plattformen (Claude Code, Cursor, Codex etc.) eingesetzt, die SKILL.md-basierte Agenten-Skills ausführen können, und ist speziell für Marketing- und Datenvisualisierungs-Workflows ausgelegt, bei denen wiederholbare, pixelgenaue Ergebnisse gefordert sind.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

HyperFrames

HyperFrames ist ein HTML-zu-MP4-Renderer (Apache 2.0). Kompositionen sind einfache HTML-Dateien mit den Attributen data-start, data-duration, data-track-index; der Renderer steuert einen Headless-Chrome frame-genau durch die Timeline und leitet die Frames an FFmpeg weiter. Die Fähigkeit hyperframes-prompt-builder ist der Einstiegspunkt des Marketing-Engine-Dispatchers; diese Fähigkeit enthält die Autoren-Regeln.

Wann aufrufen

  • Ein Stück wird (über PROVIDERS.md oder mittels provider_override.video: hyperframes im Frontmatter) an den HyperFrames-Provider weitergeleitet.
  • Die Aufgabe ist motion-typography, data-viz-reel, programmatic-short oder eine beliebige Komposition, die eine deterministische Ausgabe aus deklarierten Variablen benötigt (z. B. wöchentliches KPI-Reel, das mit neuen Zahlen unverändert neu gerendert wird).
  • Ein genehmigtes Standbild (Quote-Card, Karussell-Slide) soll ohne Änderung des typografischen Systems zu einem kurzen Bewegtbildstück aufgewertet werden.
  • Der Orchestrator benötigt ein neurenderbares Artefakt: gleiche Komposition, andere --variables, byte-identische Baseline.

Eingaben

  • composition_id: string. Kurzer Slug, der für das Projektverzeichnis und data-composition-id verwendet wird.
  • aspect: 9:16 | 1:1 | 16:9 | 4:5.
  • duration_seconds: integer. Gesamtlänge der Komposition.
  • scenes: array. Jede Szene: { id, start_s, duration_s, role: "hook" | "body" | "cta", copy?, asset_ref? }.
  • design_tokens: object. Markenfarben, primäre/sekundäre Schriftfamilien, Abstandsskala. Stammen aus clients/<slug>/design.md, falls vorhanden.
  • variables: array, optional. Deklarierte Parameter, die Aufrufer zur Renderzeit überschreiben können: { id, type, label, default }.
  • assets: object, optional. { video?, audio?, images[] } – lokale Pfade unterhalb des Projekts.
  • output_dir: string. Pfad, in den der Renderer die MP4 schreibt (standardmäßig outputs/<client>/<date>/<piece-id>/).

Ablauf

  1. Zuerst den Markenkontext lesen. Lade clients/<active-client>/design.md (oder die übergebenen Design-Tokens). Weigere dich, HTML zu schreiben, bevor die Tokens bekannt sind – greife nur dann auf die Repository-Standards zurück, wenn der Kunde keine hat.
  2. Den narrativen Bogen laut planen (Szenen, Rhythmus, Übergänge, Beat), bevor das Markup geschrieben wird. Hook in den ersten 1,5 s, Body, CTA am Ende.
  3. Layout vor Animation. Schreibe zuerst das endgültige On-Screen-Layout – positioniere Elemente dort, wo sie enden. Animiere in diese Positionen mit gsap.from(); nur die letzte Szene darf gsap.to()-Ausgänge verwenden.
  4. Das HTML erstellen. Das Wurzel-<html> trägt data-composition-id, data-width, data-height. Jeder Clip trägt id, data-start, data-duration, data-track-index. Parametrisiere mit data-composition-variables (JSON-Array auf <html>); zur Laufzeit mit window.__hyperframes.getVariables() auslesen.
  5. Jede Timeline pausiert registrieren. const tl = gsap.timeline({ paused: true }); window.__timelines["<id>"] = tl; – das Framework steuert die Wiedergabe. Keine Endlosschleifen, kein Math.random(), keine zeitbasierte Logik, keine asynchrone Timeline-Erstellung.
  6. Übergänge zwischen jeder Szene. Keine harten Schnitte. Verwende die katalogisierten Übergänge (Fade, Wipe, Masked, Shader), die im übergeordneten references/transitions.md aufgelistet sind.
  7. Video und Audio. <video> muss stumm sein; Audio lebt in einem separaten <audio>-Element auf eigener Spur.
  8. Lokal validieren mit npx hyperframes lint, dann npx hyperframes inspect (Textüberlauf, Container-Clipping). Nur rendern, wenn beide Tests bestanden sind. Dies wird an die Fähigkeit hyperframes-cli delegiert.
  9. Das Manifest ausgeben. Schreibe manifest.json neben die MP4 mit { composition_id, aspect, duration_seconds, variables_resolved, lint_pass, inspect_pass, render_settings }. Erforderlich durch die Definition of Done in CLAUDE.md.

Ausgaben

  • project_path: string. Pfad zum HyperFrames-Projektverzeichnis.
  • composition_html: string. Der erstellte index.html-Inhalt (oder der Pfad dorthin unter project_path).
  • render_args: object. Die Flags, die an npx hyperframes render übergeben werden (--fps, --quality, --variables, --strict).
  • expected_artifact: string. Der MP4-Pfad, der nach dem Rendern unter output_dir erscheint.
  • cost_estimate_usd: number. Lokales Rendern – nur Rechenzeit; melde 0 für DRY_RUN, andernfalls Schätzung aus --workers × Dauer.

Nicht verhandelbare Regeln

  • Jedes Element hat eine Eingangsanimation (gsap.from()).
  • Alle Timelines starten pausiert und sind unter window.__timelines registriert.
  • Kein Math.random(), kein Date.now() in der Kompositionslogik, kein setTimeout-gesteuertes Animieren.
  • Videospuren stumm; niemals Audio in <video> einbetten.
  • Kunden-Kopien niemals direkt in das Markup einbauen, wenn sie eine Variable sein könnten – in data-composition-variables deklarieren, damit dieselbe Komposition für neue Stücke neu gerendert werden kann.
  • Niemals eine gerenderte MP4 unter outputs/ bearbeiten; stattdessen hyperframes render erneut ausführen.

Beispiele

Beispiel 1: wöchentliches KPI-Reel (programmatic-short)

Eingabe: { composition_id: "kpi-weekly-w21", aspect: "9:16", duration_seconds: 12, scenes: [{ id: "hook", start_s: 0, duration_s: 2, role: "hook", copy: "Semana 21" }, { id: "metric", start_s: 2, duration_s: 8, role: "body" }, { id: "cta", start_s: 10, duration_s: 2, role: "cta", copy: "Veja o detalhamento" }], variables: [{ id: "leads", type: "number", label: "Novos leads", default: 0 }, { id: "delta_pct", type: "number", label: "Variação %", default: 0 }] } Ausgabe: ein Projekt unter outputs/<client>/<date>/kpi-weekly-w21/, dessen index.html die beiden numerischen Variablen ausliest und animiert; render_args.--variables löst sie pro Stück auf.

Beispiel 2: Motion-Quote-Card (motion-typography)

Eingabe: { composition_id: "quote-marcos-2026-05", aspect: "1:1", duration_seconds: 6, scenes: [{ id: "main", start_s: 0, duration_s: 6, role: "body", copy: "Coloque a sua marca onde os olhos já estão." }] } Ausgabe: eine kinetische Typografie-Komposition, die die Typografie-Paarung des aktiven Kunden respektiert, mit maskiertem Texteingang und sanftem Halten des letzten Frames.

Fehlermodi

  • Fehlende design.md und keine Design-Tokens übergeben: anhalten und nachfragen. Keine Farbpalette erfinden.
  • npx hyperframes lint meldet Fehler (fehlendes data-composition-id, überlappende Spuren, nicht registrierte Timelines): Render blockieren, bis behoben.
  • npx hyperframes inspect meldet Textüberlauf in einer Szene: Layout umfließen dem Verkleinern der Schrift unter das Systemminimum vorziehen.
  • Audiospur länger als die duration_seconds der Komposition: Audio trimmen, niemals duration_seconds verlängern, um es anzupassen.
  • Komposition verwendet Math.random() oder Wanduhrzeit: vor dem Render in eine deklarierte Variable oder einen gesäten deterministischen Generator umwandeln.

Verwandte Fähigkeiten

  • hyperframes-cli: lint-, inspect-, preview-, render-Befehle. Wird immer nach dem Authoring aufgerufen.
  • hyperframes-prompt-builder: Marketing-Engine-Spezialist, der eine Stück-Briefing in die von dieser Fähigkeit erwartete Eingabeform übersetzt; aufgerufen von video-prompt-builder, wenn die Matrix auf hyperframes auflöst.
  • video-prompt-builder: generischer Dispatcher.
  • qa-tech-specs: Validiert die gerenderte MP4 gegen Plattform-Spezifikationen (Seitenverhältnis, Dauer, Safe Areas).
  • compliance-<active client>: Läuft nach dem Rendern gegen das gerenderte Artefakt und die aus den Variablen aufgelöste On-Screen-Kopie.

Referenz zum übergeordneten Skill

Kompletter übergeordneter Skill (Kompositionsmuster, Übergangskatalog, Audio-Reaktivität, Untertitel, Data-in-Motion): https://github.com/wesleysimplicio/hyperframes/tree/main/skills/hyperframes

Individual skills in this repo

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

Verwandte Skills