Communitygithub.com

mertz1999/luma-assistant

Erstelle kinoreife SaaS-Demovideoseiten und bildschirmaufnahmefähige Produktpräsentationen. Verwende dies, wenn Codex aufgefordert wird, eine /demo-Route, eine animierte Produktdurchlauf, eine SaaS-Promo-Präsentation, eine Bildschirmaufnahmeseite, eine erzählte Produktdemo, eine cursor-gesteuerte UI-Geschichte oder ein wiederverwendbares Demovideo-System für eine App oder Website zu erstellen.

Was ist luma-assistant?

Dieser Skill ermöglicht die Erstellung einer vollbildschirmfüllenden, automatisch ablaufenden Demoseite, die als poliertes SaaS-Produktvideo aufgenommen werden kann. Er folgt einer bewährten Storyboard-Struktur: Problemhaken, Admin-Aktion, Kundenmoment, Ergebnisenthüllung, Geschäftsergebnis und abschließender Call-to-Action. Der Skill unterstützt Plattformen wie Next.js mit Framer Motion für Szenenübergänge, Cursorbewegungen und Enthüllungseffekte. Er erfordert die Angabe von Produktnamen, Domäne, Zielgruppe, Markenassets und Arbeitsablaufbeschränkungen und generiert eine Seite mit steuerbarer Zeitleiste, optionaler Sprachausgabe und visuellen Hinweisen wie Browser- und Telefonrahmen. Die Validierung umfasst lokale Tests, Typecheck, Lint, Build und Playwright-Prüfungen auf verschiedenen Bildschirmgrößen.

Funktioniert mit~Claude Code✓Codex CLI✓Cursor
npx skills add https://github.com/mertz1999/luma-assistant/tree/HEAD/skills/saas-demo-video

In Ihrer bevorzugten KI fragen

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

Dokumentation

SaaS-Demovideo

Ergebnis

Erstelle eine vollbildschirmfüllende, automatisch bewegte Demoseite, die als poliertes SaaS-Produktvideo aufgenommen werden kann. Bevorzuge eine kurze Kundengeschichte gegenüber einer Feature-Tour: Problemhaken, Produktaktion, Kundenmoment, Ergebnisenthüllung, Geschäftsergebnis, abschließender CTA.

Verwende diesen Skill, um Routen wie /demo, /presentation, /video-demo oder entsprechende eigenständige HTML/React-Seiten zu erstellen oder zu verbessern.

Erforderliche Eingaben

Sammle oder leite diese vor der Implementierung ab. Frage nur nach Blockern.

  • Produktname, Domäne, Zielgruppe und Hauptversprechen.
  • Zieldauer und Seitenverhältnis, normalerweise 30-60 Sekunden und 16:9.
  • Vorhandene App-Routen zum Anzeigen: Anmeldung, Dashboard, Produkterstellung, Linkerstellung, Kundenseite, Analysen.
  • Markenassets: Logo, Farben, Schriftarten, Produktbilder, Kundenbilder, Screenshots, Symbole, Telefonrahmen.
  • Echte Arbeitsablaufbeschränkungen: was die App tatsächlich tut, was manuell ist, was automatisch ist, welche Daten verfügbar sind.
  • Voiceover-Skript oder Zeitplan. Wenn der Benutzer Audio generiert hat, verwende die genauen Zeitstempel.
  • Abschließender CTA und Aufnahme-URL.

Erfinde niemals ein Verhalten, das das Produkt nicht unterstützt. Wenn ein Geschäft manuell einen Link kopiert, sage das, anstatt zu sagen, dass die App ihn automatisch sendet.

Storyboard

Standardstruktur von 30-50 Sekunden:

  1. Problemhaken: Zeige eine realistische Kundenfrage oder einen Schmerzpunkt.
  2. Admin-Aktion: Produkt hinzufügen, privaten Link erstellen, Nachricht kopieren.
  3. Kundenmoment: Kunde erhält Link, öffnet ihn, lädt Bild hoch, startet Generierung.
  4. Ergebnisenthüllung: Vorher/Produkt/Ergebnis nebeneinander mit einer sauberen Enthüllungsanimation.
  5. Geschäftsergebnis: Dashboard-Metriken, die wichtig sind.
  6. Abschließender CTA: Kurzes Produktversprechen und Domäne.

Verwende die echte Domäne der App und echte Produktsprache. Für Social Commerce zeige Instagram-ähnliche DM-UI nur als visuelles Story-Gerät, es sei denn, das Produkt integriert tatsächlich Instagram-APIs.

Implementierungsmuster

Verwende den vorhandenen Stack der App. Für Next.js-Apps bevorzuge:

  • Eine Route wie src/app/demo/page.tsx.
  • Eine Client-Komponente für die zeitgesteuerte Präsentation.
  • Framer Motion für Szenenübergänge, Cursorbewegung, Enthüllungseffekte, Schimmer und Zoom.
  • Vorhandene UI-Komponenten, Logo, Palette und Assets.
  • Query-Parameter-Szenenvorschau, z.B. /demo?scene=resultReveal.

Kernverhalten der Demo-Komponente:

  • Definiere Szenen als Daten: id, title, caption, durationMs, cursor und optionale visuelle Fokus-/Kamera-Metadaten.
  • Berechne Szenenstartzeiten aus durationMs.
  • Verwende eine Wanduhr-Zeitleiste, sodass Hot Reloads oder Neu-Renderings die Wiedergabe nicht unerwartet zurücksetzen.
  • Füge Steuerelemente für Wiedergabe, Pause, Neustart, Zurück und Weiter hinzu, es sei denn, der Benutzer möchte eine reine Aufnahmeseite.
  • Wenn die Synchronisierung mit generiertem Audio erfolgt, lasse die Szenendauern exakt mit den Audio-Zeitstempelbereichen übereinstimmen.
  • Füge data-demo-cursor-target-Attribute zu wichtigen UI-Steuerelementen hinzu und berechne Cursorpositionen aus getBoundingClientRect(). Vermeide hartcodierte Cursorkoordinaten, wenn ein tatsächliches Ziel existiert.
  • Verwende ResizeObserver und requestAnimationFrame, um Cursorziele über verschiedene Viewport-Größen hinweg genau zu halten.
  • Respektiere die Einstellungen für reduzierte Bewegung.

Visuelle Richtung

Sorge dafür, dass es sich wie ein modernes SaaS-Launch/Demo-Video anfühlt:

  • Vollbildschirm-Bühne, keine normale Dokumentationsseite.
  • Kinoreife Zooms auf wichtige Klicks.
  • Sanfte Cursorbewegung, die von der vorherigen Cursorposition fortgesetzt wird.
  • Kurze Overlay-Beschriftungen: "1. Produkt hinzufügen", "2. Link senden", "3. Kunde probiert es aus".
  • Echte App-Screenshots oder realistische UI-Mockups in Browser-/Telefonrahmen.
  • Ein Ergebnisenthüllungsmoment mit Blitz, Wischen, Unschärfe-zu-Scharf oder Nebeneinander-Vergleich.
  • Sauberes Dashboard-Ergebnis-Shot mit 2-4 hochsignifikanten Metriken.
  • Keine dichten Absätze, keine Entwickler-Logs, kein falscher Fachjargon.

Verwende für mobile Kundenabläufe einen Telefonrahmen. Stelle sicher, dass der Inhalt darin auf Desktop- und Mobilansichts-Viewports lesbar bleibt.

Erzählung und Timing

Wenn der Benutzer ein Voiceover benötigt, stelle einen Prompt für ein Sprachmodell bereit:

  • Ton: selbstbewusst, warmherzig, hochwertig, klar, nicht roboterhaft.
  • Tempo: an die Zieldauer anpassen.
  • Aussprachehinweise für den Produktnamen.
  • Zeitgestempeltes Skript nach Szene.

Wenn der Benutzer generierte Audio-Zeitstempel bereitstellt, aktualisiere die Szenendauern auf diese genauen Bereiche und überprüfe die Gesamtdauer.

Siehe references/storyboard-and-voiceover.md für wiederverwendbare Timing- und Erzählvorlagen.

Validierung

Überprüfe vor dem Abschluss:

  • Führe die App lokal aus oder bestätige den vorhandenen Entwicklungs-/Produktionsserver.
  • Führe relevante Prüfungen durch: Typecheck, Lint, Build oder Framework-Äquivalent.
  • Verwende Playwright/Browser-Prüfungen bei Desktop- und Mobilgrößen.
  • Stelle sicher, dass kein horizontaler Überlauf vorhanden ist.
  • Stelle sicher, dass der Telefonrahmen-Inhalt sichtbar ist.
  • Stelle sicher, dass der Cursor auf den beabsichtigten Schaltflächen landet, indem du DOM-Zielmessungen verwendest.
  • Stelle sicher, dass jede Vorschauszene über Query-Parameter funktioniert, falls implementiert.
  • Stelle sicher, dass die endgültige öffentliche URL oder lokale URL 200 OK zurückgibt.
  • Wenn ein Video-Iframe eingebettet ist, stelle sicher, dass der Iframe im gerenderten HTML vorhanden ist.

Melde alle bekannten entwicklerspezifischen Warnungen separat, wie z.B. Next HMR WebSocket-Fehler auf öffentlichen IP-Entwicklungsservern.

Lieferung

Gib zurück:

  • Demo-Seiten-URL.
  • Welche Route/Dateien hinzugefügt oder geändert wurden.
  • Szenendauertabelle.
  • Voiceover-Prompt, falls angefordert.
  • Validierungsbefehle/-ergebnisse.
  • Alle Aufnahmehinweise, wie empfohlene Viewport-Größe und ob Steuerelemente ausgeblendet werden sollen.

Verwandte Skills