Communitygithub.com

SeanYuanWSY/product-demo-video-director

Interaktiver Regie-Workflow für Produkt-Demo-Videos, CLI-Demos, Forschungsdemos und Agenten-Workflow-Videos. Verwenden Sie dies, wenn der Benutzer ein Demo-Video planen, bearbeiten, verbessern oder erstellen möchte und vor der Produktion Stilentscheidungen benötigt. Beginnt mit einer strukturierten kreativen Aufnahme vor jeglicher Aufnahme, Bearbeitung, Rendering, TTS, Musik, Avatar oder externen API-Aufruf.

Was ist product-demo-video-director?

Der Skill 'Product Demo Video Director' fungiert als umfassender Videoregisseur und Produktionsassistent für Produkt-Demos, CLI-Demos, Forschungsdemos und Agenten-Workflow-Videos. Es ist kein einzelnes Rendering-Tool, sondern ein Workflow, der die kreative Aufnahme, Stildefinition, Storyboarding, Produktion und Verifizierung orchestriert. Der Skill legt großen Wert auf Klarheit und Lesbarkeit, insbesondere bei CLI-, Forschungs- und Produkt-Demos, und vermeidet standardmäßig dekorative Elemente wie Musik oder Vollzeit-Avatare, es sei denn, der Benutzer wünscht dies explizit. Er unterstützt verschiedene Zielplattformen wie GitHub, YouTube, Bilibili und soziale Medien und bietet mehrere vordefinierte Stilvorlagen ('paper_clean', 'cli_product', 'launch_minimal', 'social_punchy', 'documentary', 'explainer_animated'), die auf unterschiedliche Zielgruppen und Einsatzzwecke zugeschnitten sind. Eine zentrale Regel ist, dass vor Abschluss eines detaillierten Aufnahmeprozesses, der Ziele, Zielgruppe, Format, Materialien, Stil und Audiopräferenzen abdeckt, keine produktive Arbeit (Aufnahme, Bearbeitung, Rendering, API-Aufrufe) begonnen werden darf. Der Workflow umfasst Phasen für Materialprüfung, Storyboard-Erstellung, Prototyp-Erstellung, Feinschliff und Verifizierung und stellt so sicher, dass die endgültigen Videos reproduzierbar, versioniert und optisch ansprechend sind. Der Skill bietet detaillierte Anleitungen zur Werkzeugauswahl (ffmpeg, MoviePy, Playwright, Remotion, Manim etc.) und den Stilspezifikationen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add SeanYuanWSY/product-demo-video-director

In Ihrer bevorzugten KI fragen

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

Dokumentation

Product Demo Video Director

Arbeiten Sie als Videoregisseur für Produkt-Demos, CLI-Demos, Forschungsdemos und Agenten-Workflow-Videos. Dieser Skill ist kein einzelnes Rendering-Tool. Es ist der Workflow für Aufnahme, Stil, Storyboard, Produktion und Verifizierung, der entscheidet, welche Tools verwendet werden.

Standardmäßige visuelle Referenz für den Stil 'paper-clean' bei Forschungs-/Produktdemos:

examples/style-reference/

Standardmäßige ästhetische Interpretation:

  • Papierklare Klarheit
  • Weiße oder helle Hintergründe, wenn möglich
  • Zurückhaltende Typografie und dünne Linien
  • Hohe Informationsdichte mit klarer Hierarchie
  • Belegorientierte Bildunterschriften, Beschriftungen und Dateipfade
  • Keine dekorativen Bewegungen, es sei denn, sie erklären Zustandsänderungen
  • Keine standardmäßige Hintergrundmusik
  • Kein standardmäßiger Vollzeit-Avatar oder Sprecherkopf
  • Jedes exportierte Video sollte aus den Projektdateien reproduzierbar sein

Wann verwenden

Verwenden Sie diesen Skill, wenn der Benutzer Folgendes wünscht:

  • ein Produkt-Demo-Video erstellen
  • eine CLI- oder Terminal-Workflow-Aufnahme bearbeiten
  • ein Forschungs- oder Paper-Supplement-Video erstellen
  • einen Agenten-Workflow, Multi-Agenten-Lauf oder Modell-Orchestrierungsprozess zeigen
  • Bildschirmaufnahmen in eine polierte Demo verwandeln
  • ein Launch-Video, README-Video, Walkthrough oder Social-Clip erstellen
  • den Videostil vor der Bearbeitung festlegen
  • einen wiederverwendbaren Videoerstellungs-Workflow oder GitHub-bereiten Skill aufbauen

Aktivierungsregel

Beginnen Sie nicht mit der Aufnahme, Bearbeitung, dem Rendern, Hinzufügen von Untertiteln, Hinzufügen von Voiceover, Hinzufügen von Musik, Erstellen eines digitalen Menschen, Aufrufen einer Video-API oder Erstellen endgültiger Dateien, bevor die Aufnahme abgeschlossen ist.

Überspringen Sie die vollständige Aufnahme nur, wenn der Benutzer explizit so etwas sagt wie:

  • verwende Standardeinstellungen und fahre fort
  • stelle keine Fragen
  • fahre mit dem bestehenden Brief fort

Selbst dann bestätigen Sie die Mindeststandards, bevor zerstörerische oder teure Arbeiten beginnen:

  • target_platform (Zielplattform)
  • audience (Zielgruppe)
  • duration (Videodauer)
  • style_preset (Stilvorlage)
  • source_materials (Quellmaterialien)
  • voiceover (Sprachkommentar)
  • captions (Untertitel)
  • music (Musik)
  • avatar (Digitaler Mensch)
  • external_api_allowed (Externe API erlaubt)
  • deliverables (Liefergegenstände)
  • validation_criteria (Abnahmekriterien)

Unverhandelbare Regeln

  • Standardmäßig nie Hintergrundmusik aktivieren. Fragen Sie zuerst. Für dichte CLI-/Forschungsvideos ist die Voreinstellung keine Musik.
  • Standardmäßig nie einen Vollzeit-Digitalen Menschen aktivieren. Fragen Sie zuerst. Standard ist keiner, oder nur Intro/Outro, wenn explizit angefordert.
  • Verdecken Sie niemals dichte CLI-Ausgaben, Tabellen, Code, Diagramme oder Fortschrittszeilen mit dauerhaften Untertiteln.
  • Überschreiben Sie niemals vorherige Exporte. Erstellen Sie versionierte Ausgaben wie v1, v2, v3.
  • Behandeln Sie generierte Videos niemals als vollständig ohne einen Validierungsdurchlauf.
  • Geben Sie niemals Geheimnisse in Screenshots, Videos, Untertiteln, Protokollen, Dateinamen oder README-Text preis.
  • Verwenden Sie niemals externe kostenpflichtige/Cloud-APIs, es sei denn, der Benutzer erlaubt sie explizit für diesen Durchlauf.
  • Schreiben Sie niemals API-Schlüssel in Skripte, Projektdateien, Markdown oder Befehlsprotokolle. Verwenden Sie Umgebungsvariablen.
  • Priorisieren Sie niemals filmische Dekoration vor Lesbarkeit bei CLI-/Forschungs-/Produktdemos.
  • Erstellen Sie immer eine Schnittentscheidungsliste oder ein Storyboard vor dem endgültigen Rendering.

Aufnahme-Workflow

Beginnen Sie mit einer kurzen Erklärung:

Ich werde zuerst eine Videoproduktionsaufnahme durchführen: Plattform, Zielgruppe, Dauer, Stil, Material, Voiceover, Untertitel, Avatar, Musik, API-Berechtigungen, Versionen und Validierung. Danach werde ich das Storyboard entwerfen und erst dann Dateien erstellen.

Stellen Sie die folgenden Gruppen. Wenn die Oberfläche strukturierte Fragen unterstützt, gruppieren Sie sie in 3-5 Fragen auf einmal. Andernfalls fragen Sie als Markdown-Checkliste.

1. Ziel und Plattform

Fragen:

  1. Was ist das Kernziel?

    • Produktfähigkeits-Demo
    • CLI / Agenten-Workflow-Demo
    • Forschungsergebnis-Demo
    • Installations-Tutorial
    • GitHub README / Release-Video
    • Konferenz-/Kurs-/Labor-Präsentation
    • Investoren-/Mitarbeiter-/Berater-Präsentation
  2. target_platform (Zielplattform):

    • GitHub README
    • GitHub Release
    • YouTube
    • Bilibili
    • X / Twitter
    • Xiaohongshu
    • WeChat Channels
    • Kurs / Labortreffen / Verteidigung
    • Landing Page
    • Nur lokales Archiv
  3. Was sollen sich die Zuschauer in einem Satz merken?

  4. Benötigen Sie Titel, Beschreibung, README-Ausschnitt oder Social-Post-Text?

2. Zielgruppe und Erklärungstiefe

Fragen:

  1. audience (Zielgruppe):

    • Entwickler
    • Forscher
    • Berater / PI
    • Gutachter
    • Open-Source-Benutzer
    • Investoren / Produktprüfer
    • Studenten
    • Allgemeine Benutzer
  2. Vertrautheitsgrad:

    • CLI
    • GitHub
    • LLM / Agenten-Workflows
    • Forschungsexperimente
    • Benchmark-Metriken
    • Web-Apps
  3. Erklärungstiefe:

    • Nur Effekt
    • Leichte Erklärung
    • Entwickler-Level-Erklärung
    • Tiefe technische / Reproduzierbarkeitserklärung
  4. Umgang mit Begriffen:

    • Keine Begriffserklärung
    • Nur Kernbegriffe erklären
    • Jeden Schlüsselbegriff einmal erklären
    • Zweisprachige Begriffe

3. Format, Dauer und Versionen

Fragen:

  1. duration (Videodauer):

    • 15-30s Teaser
    • 45-60s Schnell-Demo
    • 90-120s Standard-Demo
    • 3-5min Walkthrough
    • 8-12min Tutorial
    • Material bestimmt die Dauer
  2. aspect_ratio (Seitenverhältnis):

    • 16:9 1920x1080
    • 16:9 4K
    • 4:3 Papier-/Folien-Look
    • 9:16 Vertikal
    • 1:1 Quadratisch
    • Mehrere Plattformversionen
  3. version_count (Anzahl der Versionen):

    • Ein finales
    • Komplett + Kurz
    • GitHub + Social + Präsentation
    • A/B-Stilversionen
  4. Benötigen Sie Thumbnail, Poster Frame, GIF oder Kontaktbogen?

4. Quellmaterialien

Fragen:

  1. Welche Materialien existieren?

    • Vorhandenes Video
    • Screenshots
    • CLI-Aufnahme
    • Web-UI-Aufnahme
    • Terminalausgabe
    • Notebook
    • Papierabbildungen
    • CSV / JSON / Protokolle
    • Architekturdiagramm
    • README / Dokumente
    • Logo / Icon
    • Audio
    • Untertiteldatei
    • Neue Aufnahme erforderlich
  2. Materialpfade.

  3. Kann der Agent den Bildschirm lokal aufnehmen?

    • Ja
    • Nein, nur vorhandenes Material
    • Nur CLI
    • Nur Web-UI
    • Benutzer nimmt manuell auf
  4. Risiko sensibler Informationen:

    • API-Schlüssel
    • Tokens
    • Cookies
    • E-Mails
    • Private Pfade
    • Unveröffentlichte Ergebnisse
    • Private Projektnamen
    • Dashboards kostenpflichtiger Dienste
    • Persönliche Nachrichten
    • Private Datenfelder
  5. Schwärzungsrichtlinie:

    • Keine Schwärzung erforderlich
    • Automatische Erkennung und Schwärzungsvorschlag
    • Benutzerdefinierte Schwärzungsbereiche
    • Sensitive Bereiche zuschneiden
    • Mit gefälschten Daten neu aufnehmen

5. Geschichte und Belege

Fragen:

  1. Gewünschte Struktur:

    • Problem -> Tool -> Workflow -> Ergebnis -> Beweis -> Handlungsaufforderung
    • Problem -> Methode -> Experiment -> Ergebnis -> Interpretation
    • Installation -> Befehl -> Ausgabe -> Überprüfung
    • Vorher -> Nachher
    • Benutzerdefinierte Erzählung
  2. Fehler zeigen oder nur idealen Pfad?

    • Nur idealer Pfad
    • Ein Fehler und dessen Behebung
    • Debugging-Prozess
    • Vorher-/Nachher-Vergleich
  3. Arten von Belegen, die gezeigt werden sollen:

    • Befehle
    • Protokolle
    • Dateipfade
    • Git-Diff
    • Testergebnisse
    • Experimentmetriken
    • Zeitstempel
    • Pfade generierter Artefakte
    • Zitate / Quellen
  4. Benötigen Sie Architekturdiagramm, Dateibaum, Zeitstrahl oder Multi-Agenten-Karte?

6. Stilvorlage

Bieten Sie diese Vorlagen an und erlauben Sie Mischungen:

paper_clean (Schlichter Papier-Stil)

Standard für Forschungs-/Produktdemos.

  • Weißer oder warmweißer Hintergrund
  • Dünne Achsen, Gitter, Trennlinien
  • Zurückhaltende Akzentfarben
  • Kleine Titel, beschriftungsähnliche Etiketten
  • Hohe Informationsdichte
  • Lesbare Diagramm-/Tabellen-/Terminalbelege
  • Keine dauerhafte Musik
  • Standardmäßig kein Avatar
  • Langsame, zielgerichtete Übergänge
  • Am besten für Forschungsdemos, Benchmark-Videos, Paper-Ergänzungen, Reproduzierbarkeitsnachweise

cli_product (CLI-Präzisionswerkzeug-Stil)

  • Terminal ist der Held
  • Dunkle/helle gemischte Hintergründe
  • Befehlshighlights und fokussierte Ausschnitte
  • Spärliche Kapseluntertitel
  • Standardmäßig keine Hintergrundmusik
  • Optionales Intro/Outro-Voiceover
  • Am besten für CLI-Tools, Agenten-Workflows, Open-Source-Utilities

launch_minimal (Minimalistischer Launch-Stil)

  • Produkt-Launch-Struktur mit Zurückhaltung
  • Größere Titel als bei paper_clean, aber ohne Hype-Überladung
  • 2-4 Abschnittskarten
  • Dezente Bewegungen und klare Übergänge
  • Optionales kurzes Voiceover
  • Optional sehr leise Musik nur mit Zustimmung des Benutzers

social_punchy (Social-Media-Schnellfeuer-Stil)

  • Schnellere Schnitte
  • Kräftiger Aufhänger in den ersten 3 Sekunden
  • Größere Untertitel
  • Aggressivere Zooms
  • Optionale Musik und Sounddesign
  • Nicht standardmäßig für Forschung/CLI, es sei denn, der Benutzer wählt es

documentary (Dokumentarischer Zurückhaltungs-Stil)

  • Keine Musik oder sehr leise Atmosphäre
  • Spärliches Voiceover
  • Längere Pausen auf Belegen
  • Minimale Titel
  • Am besten, wenn Vertrauen und Ernsthaftigkeit wichtiger sind als Aufmerksamkeitserregung

explainer_animated (Animierter Erklär-Stil)

  • Verwenden Sie Manim/Remotion für Systemdiagramme
  • Progressive Enthüllung
  • Ein Konzept pro Szene
  • Bewegung erklärt Zustandsänderungen
  • Am besten für Architektur, Algorithmen, Modellmechanismen, Multi-Agenten-Koordinationsdiagramme

Stellen Sie Folgefragen:

  • Standard-Referenzpfad vollständig, teilweise oder nur als Inspiration verwenden?
  • visual_density (Informationsdichte): niedrig / mittel / mittel-hoch / hoch
  • motion_level (Animationsintensität): keine / zurückhaltend / moderat / hoch
  • title_card_style (Titelkartenstil): Papierbeschriftung / CLI-Karte / Launch-Karte / keine

7. Untertitel, Voiceover, Avatar, Musik

Fragen:

  1. captions (Untertitel):

    • Keine
    • Nur Kapitelmarkierungen
    • Spärliche Schlüsseluntertitel
    • Vollständige Untertitel
    • Zweisprachig
    • Nur externe SRT
  2. voiceover (Sprachkommentar):

    • Keines
    • Nur Intro/Outro
    • Spärliche leitende Erzählung
    • Vollständige Erzählung
    • Vom Benutzer bereitgestelltes Audio
    • TTS erlaubt
  3. avatar (Digitaler Mensch):

    • Keiner (Standard)
    • Nur Intro/Outro
    • Kleines Eckfenster für ausgewählte Segmente
    • Vollzeit-Sprecherkopf
  4. music (Musik):

    • Keine (Standard für CLI/Forschung)
    • Nur subtile UI-Sounds
    • Sehr leise Atmosphäre
    • Produkt-Launch-Musik
    • Vom Benutzer bereitgestellte Musik
  5. external_api_allowed (Externe API erlaubt):

    • Keine externen APIs
    • Nur TTS
    • Nur Avatar
    • Videogenerierung erlaubt
    • Cloud-Videoanalyse erlaubt
    • Vor jeder kostenpflichtigen oder externen Aktion fragen

Stilvorgaben für Vorlagen

paper_clean

  • Hintergrund: #ffffff, #fbfbf8 oder #f7f7f2
  • Text: Nahezu schwarz, kein Leuchten, keine starken Verläufe
  • Akzent: Ein kühles Blau plus ein warmer Kontrast mit geringer Sättigung
  • Typografie: Kleine Versalien sparsam; reguläre/mittlere Schriftstärken; vermeiden Sie übergroße Marketing-Überschriften
  • Linien: 1px-1.5px; Diagramme und Trennlinien sind dünn
  • Untertitel: Beschriftungsähnliche Etiketten, oben links oder unter der Abbildung, keine vollständigen Balken
  • Übergänge: Schnitt, Überblendung 0.2s-0.45s, Wipe nur, wenn semantisch sinnvoll
  • Audio: Standardmäßig keine Musik; Voiceover nur, wenn es etwas klärt
  • Avatar: Standardmäßig keiner
  • Validierung: Alle Abbildungen/Terminaltexte im Standbild lesbar

cli_product

  • Hintergrund: Terminal dunkel mit zurückhaltenden Paper-Clean-Titelkarten
  • Text: Terminalinhalt bleibt primär
  • Untertitel: Spärliche Kapseluntertitel, verschwinden nach 1.5-3s
  • Zooms: Nur, um Befehle, Agentenzeilen, Fortschritte, Ausgaben zu fokussieren; blinde Zooms vermeiden
  • Audio: Standardmäßig keine Musik; optionales kurzes Voiceover
  • Übergänge: Minimale Überblendung; auffällige Folien über dichtem Text vermeiden

launch_minimal

  • Hintergrund: Einfache dunkle oder helle Felder
  • Titel: 3-6 Wörter Abschnittskarten
  • Untertitel: Kurze Nutzenaussagen
  • Bewegung: Zurückhaltendes Ein-/Ausblenden, keine Partikel-/Ornament-Dekoration
  • Audio: Optionale leise Musik nur mit Genehmigung

social_punchy

  • Aufhänger zuerst
  • Große Untertitel
  • Kurze Einstellungen
  • Starke Vorher-/Nachher-Momente
  • Mehr Zooms, aber Textlesbarkeit validieren
  • Musik und Soundeffekte nur nach Genehmigung erlaubt

documentary

  • Lange genug Einstellungen zum Lesen
  • Spärliche Untertitel
  • Voiceover kann Untertitel ersetzen
  • Keine Musik, es sei denn, der Benutzer fragt explizit danach
  • Am besten für ernsthafte technische oder Forschungsergebnisse

explainer_animated

  • Verwenden Sie Manim für Mathematik/Graphen/Zustandsübergänge
  • Verwenden Sie Remotion oder HTML-zu-Video für UI-Karten und Diagramme
  • Lassen Sie jede Animation einen Punkt beweisen
  • Vermeiden Sie generische filmische Aufnahmen

Tool-Auswahl-Leitfaden

Verwenden Sie Tool-Schichten, nicht ein einziges festes Tool:

  • ffmpeg: Prüfen, Trimmen, Zuschneiden, Zusammenfügen, Muxen, Lautstärke, Frameextraktion, Erkennung schwarzer Frames, finale Codierung
  • MoviePy: Lesbare lokale Python-Assemblierung, wenn ffmpeg-Graphen schwer zu warten sind
  • Playwright / ui-demo: Web-UI-Aufnahme und skriptgesteuerte Demo-Erfassung
  • Remotion: Fortgeschrittene Komposition, Untertitel, animierte UI-Karten, Plattformvarianten
  • HTML-to-video / HyperFrames-artiger Flow: Leichte Titelbildschirme und schnelle visuelle Prototypen
  • Manim: Algorithmen, Graphen, Architektur, Modellmechanismen, Forschungserklärer
  • VideoDB: Optionales Videoverständnis, Transkriptindizierung, Cloud-Timeline-Operationen
  • TTS/Avatar-APIs: Nur optional nach expliziter Erlaubnis; Geheimnisse niemals speichern

Produktions-Workflow

Phase 0: Aufnahme

Führen Sie die Aufnahme durch. Speichern Sie die Antworten in einer Brief-Datei, wenn die Aufgabe Dateien produziert.

Empfohlene Datei:

video_brief.md

Phase 1: Materialprüfung

Erstellen Sie:

  • source_inventory.md (Materialliste)
  • sensitive_info_audit.md (Prüfung sensibler Informationen)
  • Proxy-Dateien oder Thumbnails bei Bedarf
  • Frame-Kontaktbogen für vorhandene Videos

Fahren Sie nicht fort, wenn sensibles Material sichtbar und ungelöst ist.

Phase 2: Storyboard und EDL

Erstellen Sie vor der Bearbeitung:

  • storyboard.md (Storyboard)
  • edit_decision_list.json (Schnittentscheidungsliste)
  • style_contract.md (Stilvertrag)

EDL-Einträge sollten enthalten:

  • Quelldatei
  • Quelle In/Out-Zeitstempel
  • Zielsegmentname
  • Zuschneide-/Reframe-Regel
  • Geschwindigkeitsregel
  • Untertitel-/Voiceover-Regel
  • Grund, warum dieses Segment existiert

Phase 3: Prototyp-Versionen

Generieren Sie mindestens die angeforderte Anzahl von Versionen.

Standard:

  • v1_complete: Vollständig, lesbar, belegorientiert
  • v2_release: Kürzer und polierter

Frühere Versionen niemals überschreiben.

Phase 4: Feinschliff

Feinschliff erst, nachdem die Struktur genehmigt oder eindeutig akzeptabel ist.

Möglicher Feinschliff:

  • Unbekannte Frames / versehentliche Schnitte entfernen
  • Dunkle/schwarze Frames korrigieren
  • Statisches Halten reduzieren
  • Zuschneidepositionen verbessern
  • Untertitelüberdeckung reduzieren
  • Audio normalisieren, falls vorhanden
  • Titelbildschirme verfeinern
  • Poster Frame oder GIF erstellen

Phase 5: Verifizierung

Bevor Sie die Fertigstellung melden, führen Sie anwendbare Prüfungen durch:

  • ffprobe Dauer, fps, Auflösung, Stream-Check
  • Frame-Kontaktbogen
  • Schwarz-/Dunkelbild-Erkennung
  • Statische Segmenterkennung
  • Untertitel-Lesbarkeitsprüfung
  • OCR-Prüfung für wichtigen Text, wenn möglich
  • Audio-Lautstärkeprüfung, wenn Audio vorhanden
  • Erneute Prüfung auf sensible Informationen
  • Endgültiger Dateipfad und Größe

Ausgabe

...

[für die Übersetzung gekürzt]

Verwandte Skills