Communitygithub.com

simpletibr/simplicio-loop-marketing

Einmaliges Bootstrap-Skill, das HyperFrames (https://github.com/wesleysimplicio/hyperframes) als erstklassigen Video-Provider in einen marketing-engine Clone einbindet – die drei Laufzeit-Skills, die Provider-Klasse + Mock, die Routing-Matrix-Zeilen, Umgebungsvariablen und CLAUDE.md-Updates. Idempotent. Nutze es, wenn ein frischer Clone HyperFrames benötigt oder nach einem Rebase, der Teile der Integration entfernt hat.

Was ist simplicio-loop-marketing?

Dieses Skill installiert und integriert HyperFrames, einen lokalen HTML-zu-MP4-Renderer, in ein marketing-engine Repository. Es führt in einem einzigen Durchlauf die gesamte Integration durch: Es erstellt drei Laufzeit-Skills (hyperframes, hyperframes-cli, hyperframes-prompt-builder), erweitert die Provider-Schicht um eine HyperframesVideoProvider-Klasse mit Mock, aktualisiert die Routing-Matrix in PROVIDERS.md, ergänzt Umgebungsvariablen in .env.example und passt CLAUDE.md an. Der Prozess ist idempotent – bei erneuter Ausführung werden nur fehlende Artefakte ergänzt. Das Skill ist speziell für das marketing-engine Repository konzipiert und setzt voraus, dass bestimmte Dateien (z. B. CLAUDE.md mit der Sektion 'How to Add a New Provider') vorhanden sind. Es unterstützt die Plattformen der marketing-engine (Node.js, TypeScript) und kann sowohl bei der Ersteinrichtung als auch nach einem Rebase verwendet werden, um die Integration vollständig und konsistent zu halten.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

HyperFrames installieren

Stellt in einem Durchgang die Integration her, die HyperFrames als Video-Provider gemäß dem Drei-Schritte-Vertrag Neuen Provider hinzufügen in der CLAUDE.md einbindet. Eine eigenständige Checkliste aller Artefakte, die vorhanden sein müssen; prüft jedes einzelne und erstellt nur, was fehlt.

Führe dieses Skill aus, anstatt die Integration von Grund auf neu abzuleiten. Es ist die kanonische Aufzeichnung davon, was „HyperFrames ist eingebunden“ in diesem Repository bedeutet.

Wann verwenden

  • Frischer marketing-engine Clone, der noch keine HyperFrames-Unterstützung hat.
  • Ein Rebase oder Merge hat eines der unten genannten Artefakte entfernt (router:check meldet Fehler, Video-Routing fällt für Typografie-Aufgaben auf higgsfield zurück, oder .skills/hyperframes*/ fehlen).
  • Ein neuer Kunde wünscht programmatische Kurzfilme / Bewegttypografie / Datenvisualisierungs-Clips und die Matrix muss die drei Aufgabenarten einbinden.
  • Ein neuer Operator wird eingearbeitet und benötigt ein einziges befehlssetzerbares Playbook anstatt drei Commits zum Lesen.

Eingaben

  • repo_root: Zeichenkette. Absoluter Pfad zum marketing-engine Clone. Standard: process.cwd().
  • branch: Zeichenkette, optional. Branch, auf dem committet werden soll. Standard: claude/install-hyperframes. Erstellt den Branch, falls er nicht existiert; committet nie auf main.
  • dry_run: Boolesch, optional. Bei true werden die geplanten Änderungen ausgegeben und das Skill wird ohne Schreibzugriff beendet.

Ablauf

Jeden Schritt in Reihenfolge ausführen. Jeder Schritt ist idempotent – eine erneute Ausführung in einem bereits integrierten Repository bewirkt für diesen Schritt nichts.

Schritt 1 – Vorprüfung

  1. Bestätigen, dass repo_root eine CLAUDE.md mit der Zeile ## How to Add a New Provider enthält. Ausführung verweigern, falls fehlend – dies ist kein marketing-engine Repository.
  2. Bestätigen, dass lib/providers/video.ts, lib/providers/matrix.ts, lib/providers/types.ts und lib/providers/__mocks__/video.ts existieren. Ausführung verweigern, falls eine davon fehlt.
  3. Bestätigen, dass der aktive Branch nicht main ist. Falls auf main, zuerst branch erstellen und auschecken.

Schritt 2 – Die drei Laufzeit-Skills hinzufügen

Diese drei Verzeichnisse mit den SKILL.md-Dateien erstellen. Jede Datei existiert bereits in der kanonischen Version im Baum – aus dem unten stehenden Referenz-Artefaktsatz wörtlich kopieren. Eine Datei überspringen, wenn sie bereits existiert und ihr Frontmatter name übereinstimmt.

  • .skills/hyperframes/SKILL.md – Regeln für die Erstellung von Kompositionen (Layout-vor-Animation, abgespielte Zeitachsen + auf window.__timelines registriert, kein Math.random()/zeitbasierte Logik, Variablen deklariert über data-composition-variables).
  • .skills/hyperframes-cli/SKILL.md – npx hyperframes Lint → Inspect → Render-Entwicklungsschleife. Rendert immer mit --strict --strict-variables.
  • .skills/hyperframes-prompt-builder/SKILL.md – Spezialist, der von video-prompt-builder aufgerufen wird, wenn die Matrix auf hyperframes auflöst; lädt Markentoken aus clients/<slug>/design.md, wählt eine Vorlage pro task_kind und gibt eine Kompositionsspezifikation + Render-Argumente zurück.

Schritt 3 – Das Dispatcher-Skill aktualisieren

In .skills/video-prompt-builder/SKILL.md:

  1. hyperframes-prompt-builder zur Spezialistenliste im Eröffnungsabsatz und im Abschnitt Verwandte Skills hinzufügen.
  2. Die task_kind-Eingabe-Enum um motion_typography, data_viz_reel, programmatic_short erweitern.
  3. Im Ablauf-Schritt, der Umgebungsvariablen prüft, HYPERFRAMES_ACTIVE zur Liste hinzufügen.
  4. In der Provider→Spezialist-Zuordnung die Zeile Hyperframes -> hyperframes-prompt-builder hinzufügen.
  5. Ein Beispiel hinzufügen: ein wöchentlicher KPI-Clip, der an Hyperframes mit task_kind: programmatic_short weitergeleitet wird.

Jeden Unterschritt überspringen, dessen Zielzeichenfolge bereits vorhanden ist.

Schritt 4 – Die Provider-Schicht erweitern

In lib/providers/types.ts drei Mitglieder zur VideoTask-Vereinigung hinzufügen:

| "motion-typography"
| "data-viz-reel"
| "programmatic-short"

In lib/providers/matrix.ts:

  • Drei Zeilen zu EMBEDDED_DEFAULTS.video hinzufügen: motion-typography, data-viz-reel, programmatic-short – jeweils standardmäßig auf hyperframes.
  • Label-Aliase zu TASK_LABEL_MAP hinzufügen: "motion typography", "kinetic typography", "data viz reel", "data-viz reel", "programmatic short", "parametrized short".

In lib/providers/video.ts:

  • Eine HyperframesVideoProvider-Klasse hinzufügen, die RealVideoBase erweitert, geschützt durch process.env.HYPERFRAMES_ACTIVE === "true", die in realGenerate einen Fehler „local CLI render required in caller context; stub“ auslöst (entsprechend dem bestehenden higgsfield/topview-Stub-Muster).
  • hyperframes: () => new HyperframesVideoProvider() in REAL_VIDEO_REGISTRY registrieren.

In lib/providers/__mocks__/video.ts:

  • Einen MockHyperframesVideoProvider hinzufügen, der BaseMockVideo mit name = "hyperframes" erweitert.
  • hyperframes: () => new MockHyperframesVideoProvider() in MOCK_VIDEO_REGISTRY registrieren.

Schritt 5 – Die Routing-Matrix-Datei aktualisieren

In .specs/architecture/PROVIDERS.md drei Zeilen an die Video-Routing-Tabelle anhängen:

| Motion typography | hyperframes | HTML/GSAP kinetic type, brand-faithful, deterministic |
| Data viz reel | hyperframes | declared variables → re-renderable charts (NYT-style) |
| Programmatic short | hyperframes | parametrized HTML composition; byte-identical re-renders |

Schritt 6 – .env.example aktualisieren

Nach WAVESPEED_API_KEY= anhängen:

# HyperFrames is a local HTML→MP4 renderer; no API key needed.
# Set HYPERFRAMES_ACTIVE=true once `npx hyperframes doctor` passes locally
# (Node >= 22, FFmpeg on PATH). See https://github.com/wesleysimplicio/hyperframes
HYPERFRAMES_ACTIVE=false

Schritt 7 – CLAUDE.md aktualisieren

  1. In der Stack-Tabelle die Provider-Zelle der Video-Zeile um hyperframes (local HTML→MP4) ergänzen.
  2. In Verfügbare Skills drei Zeilen nach wavespeed-batch einfügen:
    • hyperframes – HTML-as-source-of-truth motion composition authoring.
    • hyperframes-cli – runs npx hyperframes lint/inspect/preview/render.
    • hyperframes-prompt-builder – selected by video-prompt-builder when the matrix resolves to hyperframes.

Schritt 8 – Verifizieren

  1. .specs/architecture/PROVIDERS.md mit dem untenstehenden Test parsen und bestätigen, dass motion-typography, data-viz-reel, programmatic-short alle auf hyperframes auflösen.
  2. npm run typecheck ausführen – bestehende Fehler vor der Änderung akzeptieren (z. B. fehlendes @types/node); abbrechen, wenn ein neuer TS-Fehler auf die Provider-Schicht verweist.
  3. npm run router:check ausführen, falls eine .env im Repository existiert; sonst überspringen (das Skript benötigt .env und ist nicht mit der Integrationsform verwandt).
  4. Bestätigen, dass git status nur die erwarteten Dateien anzeigt.
node --input-type=module -e "
import { readFileSync } from 'node:fs';
const text = readFileSync('.specs/architecture/PROVIDERS.md', 'utf8');
const expected = ['motion-typography', 'data-viz-reel', 'programmatic-short'];
for (const key of expected) {
  if (!text.toLowerCase().includes(key.replace(/-/g, ' '))) {
    console.error('MISSING:', key); process.exit(1);
  }
}
console.log('PROVIDERS.md OK');
"

Schritt 9 – Committen und pushen

  1. Genau die Dateien stagen, die dieses Skill berührt hat. Niemals git add -A.
  2. Mit der kanonischen Nachricht committen:
    feat(skills): wire HyperFrames as a video provider
    
    plus einem Body, der die Ausführung des Drei-Schritte-Vertrags beschreibt (siehe den gemergten Referenz-Commit für den Wortlaut).
  3. Nach origin <branch> pushen. Einen Draft-PR öffnen, falls für den Branch noch keiner existiert.

Ausgaben

  • branch: Zeichenkette. Der Branch, der den Commit enthält.
  • pr_url: Zeichenkette. Die Draft-PR-URL, falls eine erstellt wurde oder bereits existierte.
  • files_written: Array relativer Pfade, die tatsächlich erstellt oder geändert wurden.
  • files_skipped_idempotent: Array relativer Pfade, die bereits korrekt waren.
  • verification: { providers_md_pass: boolean, typecheck_pass: boolean, router_check: "pass" | "skipped" | "fail" }.

Unverhandelbare Regeln

  • Idempotent. Erneute Ausführung in einem bereits integrierten Repository berührt keine Dateien.
  • Nie auf main committen. Zuerst einen Feature-Branch erstellen; die Branch-Richtlinie der Engine wird upstream durchgesetzt.
  • Kein Skill-Body erwähnt hyperframes außerhalb des Vertrags. Die Provider-Auswahl erfolgt weiterhin über PROVIDERS.md + lib/router.ts. Dieses Skill ist das Bootstrap; die Laufzeitauswahl bleibt provider-unabhängig.
  • Kein bearbeitetes MP4 oder eine Datei unter outputs/ ändern. Dieses Skill ändert nur die Engine-Infrastruktur.
  • Niemals ein bestehendes compliance-<aktiver Kunde>-Skill oder ein kundenspezifisches Artefakt löschen. Die Integration ist additiv.

Fehlermodi

  • Schritt-1-Vorprüfung schlägt fehl (kein marketing-engine Repository): Die fehlende Datei anzeigen und anhalten. Nicht versuchen, sie zu „reparieren“.
  • Eine Datei existiert bereits mit widersprüchlichem Inhalt (z. B. .skills/hyperframes/SKILL.md wurde manuell bearbeitet): Diff gegen den kanonischen Inhalt durchführen; den Diff anzeigen; den Operator vor dem Überschreiben fragen.
  • npm run typecheck meldet einen neuen TS-Fehler in lib/providers/: Anhalten, den Fehler anzeigen, nicht committen.
  • git push schlägt aus nicht-networkbedingten Gründen fehl: Anhalten. Netzwerkfehler werden gemäß der Git-Richtlinie des Projekts wiederholt (2s, 4s, 8s, 16s Backoff, bis zu 4 Versuche).

Verwandte Skills

  • hyperframes: Laufzeit-Authoring (in Schritt 2 von diesem Skill installiert).
  • hyperframes-cli: Laufzeit-Lint/Inspect/Render (in Schritt 2 von diesem Skill installiert).
  • hyperframes-prompt-builder: Laufzeit-Spezialist (in Schritt 2 von diesem Skill installiert).
  • video-prompt-builder: Dispatcher, der in Schritt 3 von diesem Skill aktualisiert wird.
  • llm-router: Nicht verwandt; LLM-Provider-Routing ist ein paralleler Dispatcher.

Referenz-Artefaktsatz

Die kanonischen Inhalte aller Dateien, die dieses Skill schreibt, befinden sich im gemergten Commit auf main:

  • Skills: .skills/hyperframes/SKILL.md, .skills/hyperframes-cli/SKILL.md, .skills/hyperframes-prompt-builder/SKILL.md
  • Provider-Schicht: lib/providers/types.ts, lib/providers/matrix.ts, lib/providers/video.ts, lib/providers/__mocks__/video.ts
  • Routing-Matrix: .specs/architecture/PROVIDERS.md
  • Umgebung: .env.example
  • Charter: CLAUDE.md

Im Zweifelsfall einen Diff gegen origin/main im gemergten Referenz-Commit durchführen und die kanonische Version wörtlich kopieren. Nicht aus dem Gedächtnis neu tippen.

Upstream-Referenz

Individual skills in this repo

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

Verwandte Skills