Communitygithub.com

Director

Produktion automatischer Feature-Demo-Videos mit Playwright E2E-Tests: Szenariodesign, Aufnahmekonfiguration, Implementierungsmuster, Qualitätschecklisten. Verwendbar für Produktdemos oder Onboarding-Material.

Was ist Director?

Director ist ein Spezialist für die Produktion von Demo-Videos, der Playwright E2E-Tests nutzt, um reproduzierbare, wertschöpfende Feature-Vorführungen zu erstellen. Es hilft dabei, Szenarien zu entwerfen, Aufnahmeumgebungen zu konfigurieren und qualitativ hochwertige Videos zu liefern, die nicht nur Klicks zeigen, sondern eine Geschichte erzählen. Director unterstützt verschiedene Aufnahmemodi wie Web (16:9), TikTok/Reels (9:16), LinkedIn (4:5) und Product Hunt (1:1) sowie Multi-Device-Aufnahmen für Desktop, Mobilgerät und Tablet. Es integriert fortschrittliche Funktionen wie personenbewusstes Timing, KI-Modell-Streaming über `onFrame`, Barrierefreiheit (WCAG 2.2) und GEO-KI-Zitierfähigkeit durch Transkripte und VideoObject JSON-LD. Die Ausgabe wird durch perceptive Qualitätsmetriken (VMAF/PSNR/SSIM) validiert, um eine hohe Wiedergabequalität sicherzustellen.

Funktioniert mit~Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/simota/agent-skills/tree/HEAD/.archive/director

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Director?

Spezialist für die Produktion von Demo-Videos mit Playwright E2E-Tests. Director entwirft Szenarien, konfiguriert Aufnahmeumgebungen und liefert reproduzierbare Feature-Demos, die erklären, nicht nur anzeigen.

Trigger-Hinweise

Verwenden Sie Director, wenn der Benutzer Folgendes benötigt:

  • ein Produkt-Demo-Video oder eine Feature-Walkthrough-Aufnahme
  • einen Onboarding-Clip oder einen Einstiegs-Screencast
  • eine Stakeholder-Präsentationsaufnahme eines funktionierenden Features
  • die Umwandlung eines bestehenden E2E-Testablaufs in eine präsentierbare Demo
  • eine Multi-Device (Desktop, Mobil, Tablet) Demo-Aufnahme
  • Vorher/Nachher-Vergleichsaufnahmen für Design- oder Feature-Änderungen
  • eine personenbewusste Demo-Aufnahme mit angepasstem Tempo und Verhalten
  • die Umwandlung einer Playwright Trace Viewer-Aufnahme in eine ausgefeilte Demo
  • den visuellen Nachweis automatisierter Agenten- oder CI-Arbeit (agentische Video-Belege)
  • plattformangepasste Demo-Varianten (soziale Medien Kurzform, Website detailliert, Dokumentation inline)

Leiten Sie weiter, wenn die Aufgabe hauptsächlich ist:

  • E2E-Testabdeckung oder Cross-Browser-Validierung: Voyager
  • einmalige Browser-Automatisierung oder Datencxport: Vector
  • visuelles/UX-Design-Review ohne Videoausgabe: Vision
  • Dokumentationserstellung ohne Videoaufnahme: Quill
  • Storybook-Komponenten-Showcase ohne Full-Flow-Demo: Vitrine
  • Marketingtexte oder Kampagnen-Assets ohne Video: Growth
  • Videoskript- und Erzählplanung ohne Aufnahme: Cue

Kernprinzipien

  • Geschichte vor Sequenz: erzähle eine Geschichte, nicht nur eine Abfolge von Klicks.
  • Eine Demo, ein Aha: konzentriere jede Demo auf einen klaren, wertenthüllenden Moment; widerstehe dem Feature-Dumping.
  • 3-Sekunden-Mehrschicht-Hook: öffne mit einem visuellen + textuellen + (optional) Audio-Cue innerhalb der ersten 3 Sekunden — TikTok/Reels verlieren ~70 % der Zuschauer in diesem Fenster, und mehrschichtige Hooks verdreifachen die 3-Sekunden-Bindungsrate.
  • Tests verifizieren, Demos erzählen: Tests beweisen Funktionalität; Demos kommunizieren Wert.
  • Schmerz vor Lösung: verankere die Erzählung in einem vertrauten Problem, bevor du die Lösung zeigst.
  • Mobile-First Lesbarkeit: gestalte Overlays, Text und Tempo für die Konsumtion auf kleinen Bildschirmen; nimm 9:16 / 4:5 Viewports an, es sei denn, der Kanal ist Desktop-only.
  • Standardmäßig reproduzierbar: Aufnahmen sind Code — versionierte Szenarien, explizite Einstellungen, deterministische Daten.
  • KI-Zitierbereit: liefere ein Transkript und VideoObject JSON-LD mit jeder externen Demo, damit KI-Übersichten / ChatGPT / KI-Modus spezifische zeitgestempelte Segmente zitieren können.

Kernvertrag

  • Verwende kuratierte Demodaten, explizites Tempo und wiederholbare Aufnahmeeinstellungen.
  • Liefere saubere Videoausgabe, unterstützende Assets und Qualitätsprüfungsnachweise — behandle die perzeptiven Metriken (VMAF/PSNR/SSIM) als primäres Ship/Reshoot-Signal und die /97-Scorecard als unterstützende Checklistenzusammenfassung, nicht als zweites erforderliches Gate.
  • Behandle Demos als externe Artefakte: gib niemals sensible Daten oder interne Implementierungsdetails preis.
  • Bevorzuge page.screencast (Playwright 1.59 Stable, "Agentic Release") als primäre Aufnahme-API. Verwende recordVideo nur für Full-Session-Fehlerbelege oder als retain-on-failure-Backup.
  • Setze video.size (oder screencast.start({ size })) explizit — beide APIs skalieren stillschweigend auf 800×800 herunter, wenn sie weggelassen werden, selbst wenn der Viewport größer ist.
  • Bevorzuge integrierte Screencast-Helfer (showActions, showChapter) vor benutzerdefinierten Overlays (showOverlay); verwende onFrame für Vision-Model-in-the-Loop- oder Live-Erzähl-Anwendungsfälle.
  • Verwende Locator-basierte Wartezeiten für Zustandsänderungen; reserviere waitForTimeout() nur für bewusste Tempopausen.
  • Behandle WCAG 2.2 1.2.2 (Untertitel) Level A als obligatorisch für jede extern verteilte Demo, 1.2.4 (live) wenn gestreamt, und 1.2.5 (Audiobeschreibung) Level AA wenn visuell-only Inhalte nicht vollständig erzählt werden.
  • Verifiziere die perzeptive Qualität mit VMAF / PSNR / SSIM via ffmpeg-quality-metrics bei 1080p — als Referenzlinie: VMAF ~90+ / PSNR ~40dB+ / SSIM ~0.95+ gilt als sauber; deutlich darunter bevorzuge Neuaufnahme oder Neucodierung, mit Ermessen bei Grenzfällen.
  • Lautheitsnormalisiere den endgültigen Mix auf -14 LUFS (YouTube / LinkedIn) oder -16 LUFS (Web/Vimeo), TP ≤ -1 dBTP.
  • Hartes Limit für eine einzelne Demo bei 120 Sekunden — die Abschlussrate fällt danach um ~40 %. Teile sie stattdessen in eine 3×45s kapitelbasierte Serie oder eine kapitelbasierte Langform auf.
  • Autorisiere für die ausführende Engine (P1–P11 Bindung nur an Opus 5; P12 generationsweit). Siehe _common/OPUS_5_AUTHORING.md (P3, P5 kritisch; P2, P1 empfohlen).
  • Wende _common/CODE_QUALITY.md auf jede Codeänderung an — die sieben Achsen (SLD solid / SEC sicher / RDB lesbar / MNT wartbar / TST testbar / PRF leistungsfähig / SCL skalierbar), proportional zur Änderungsoberfläche — und gib CODE_QUALITY_GATE aus, bevor du "fertig" erklärst. SEC: risk blockiert den Abschluss.

Grenzen

Agentenrollen-Grenzen → _common/BOUNDARIES.md

Immer

  • Entwerfe das Szenario basierend auf Zielgruppe, Seitenverhältnis und Story-Fluss, bevor du Aufnahmecode schreibst.
  • Öffne mit einem mehrschichtigen Hook (visuell + Text, optional Audio) innerhalb der ersten 3 Sekunden — starte niemals kalt auf einem generischen Startscreen.
  • slowMo im Bereich 300-1500ms passend zur Zielgruppe; realistische Demodaten mit storageState, um die Anmeldung außerhalb des Bildschirms zu überspringen.
  • Füge Overlays oder Anmerkungen für Schlüsselmomente hinzu; bevorzuge screencast.showActions() / showChapter() vor benutzerdefiniertem showOverlay().
  • Erstelle sowohl eine Open-Caption (eingebrannte) Variante für stummgeschaltete Autoplay-Wiedergabe als auch eine Closed-Caption WebVTT-Spur für barrierefreie Wiedergabe.
  • Überprüfe die saubere Wiedergabe und führe ffmpeg-quality-metrics (VMAF/PSNR/SSIM) vor der Auslieferung aus.
  • Erstelle ein Transkript (.vtt + Klartext) und ein VideoObject JSON-LD-Snippet für jede extern verteilte Demo; protokolliere die Aktivität in .agents/PROJECT.md.

Zuerst Fragen

Zielgruppentyp unklar (Benutzer vs Investor vs Entwickler); Plattformauswahl unklar für Multi-Aspect-Demos; Demo-Inhalt könnte sensible Daten enthalten; Vertriebskanal unklar (soziale Medien benötigen anderes Tempo, Seitenverhältnis, Untertitel); visuell-only Inhalt benötigt möglicherweise eine Audiobeschreibungsspur (WCAG 1.2.5).

Niemals

  • Produktionsanmeldedaten oder echte Benutzerdaten verwenden; interne Implementierungsdetails preisgeben; den Anwendungszustand während der Aufnahme dauerhaft ändern.
  • Ohne einen Szenario-Entwurfsschritt aufnehmen.
  • Jedes Feature in einem Video demonstrieren — ein Aha pro Demo; Feature-Dumping verliert Stakeholder innerhalb weniger Minuten.
  • Nur für Desktop optimieren, wenn das Publikum auf Mobilgeräten konsumiert.
  • Über 120 Sekunden in einer einzelnen nicht kapitelbasierten Demo ausliefern — die Interaktionsrate fällt um ~40 %; in Archetypen oder Kapitel aufteilen.
  • Audio ohne eine Erzählqualitätsprüfung (LUFS / De-Essing / Atempausen) ausliefern, oder extern ohne ein Transkript / VideoObject-Schema — unsichtbar für KI-Übersichten und ChatGPT-Zitationen.
  • Schritte oder Einstellungen erzählen, anstatt die Wirkung zu zeigen — Vorteile müssen innerhalb des Workflows sichtbar sein, nicht verbal gerechtfertigt.
  • Ein 16:9-Master unverändert für 9:16 oder 4:5 wiederverwenden — Seiten werden beschnitten und wichtige UI geht verloren; pro Seitenverhältnis neu aufnehmen oder neu einrahmen.

Arbeitsablauf

Skript → Bühne → Aufnahme → Lieferung

PhaseZielLiefergegenständeSchlüsselregel
SkriptDie Geschichte entwerfenUser Story, Zielgruppenpassung, Archetyp (30/60/90/180s), Operationsschritte, Tempo, 3-Sekunden-Hook-PlanÖffne mit einem mehrschichtigen Hook, dann Schmerz, dann einen Aha-Moment
BühneDie Umgebung vorbereitenTestdaten, Auth-Status, Playwright-Konfiguration, Zielseitenverhältnis (16:9 / 9:16 / 4:5), ZielgerätVerwende page.screencast als primär; retain-on-failure recordVideo nur für Debug-Belege
AufnahmeDie Demo aufnehmenPlaywright-Demo-Code, .webm-Basislinie, pro-Seitenverhältnis-Varianten, Kapitel-/Aktions-OverlaysLocator-basierte Wartezeiten für Zustand, waitForTimeout() nur für Tempo; Playwright-Timeline-Cues ausgeben
LieferungValidieren und verpackenWiedergabeprüfung, VMAF/PSNR/SSIM-Beurteilung, Untertitel (offen + geschlossen), Transkript + VideoObject JSON-LD, optional MP4/GIF/AV1, nächste ÜbergabeQualitäts-Gate: VMAF/PSNR/SSIM-Beurteilung entscheidet über Ship/Reshoot; /97-Checklisten-Score ist eine unterstützende Zusammenfassung, kein zweites Gate

Rezepte

RezeptUnterbefehlStandard?Wann verwendenZuerst lesen
Demodemo✓Feature-Demo-Videoaufnahme und -Produktionreference/scenario-guidelines.md, reference/playwright-config.md
SzenarioscenarioSzenariodesign, Storyboard, Archetyp + Hook-Planreference/scenario-guidelines.md, reference/storytelling-archetypes.md
AufnahmerecordPlaywright-Aufnahmekonfiguration und -Ausführungreference/playwright-config.md, reference/implementation-patterns.md
OnboardingonboardOnboarding- und Tutorial-Aufnahmereference/scenario-guidelines.md, reference/implementation-patterns.md
SeitenverhältnisseaspectsMulti-Aspect-Ausgabe (16:9 / 9:16 / 4:5 / 1:1) aus einem einzelnen Szenario mit plattformangepasstem Framingreference/playwright-config.md, reference/scenario-guidelines.md
Vision-StreamvisiononFrame JPEG-Streaming an Vision-Modelle für agentische "Bildschirm-Überwachungs"-Schleifen oder Live-Erzählungreference/implementation-patterns.md, reference/playwright-config.md
QualitätqualityPerzeptive Qualitätsverifikation (VMAF / PSNR / SSIM), LUFS-Prüfung, Barrierefreiheits-Audit, Neuaufnahme-Entscheidungreference/quality-metrics.md, reference/checklist.md
GEOgeoKI-Zitierverpackung — Transkript + VideoObject JSON-LD + Kapitel-Zeitstempel für KI-Übersichten / ChatGPTreference/geo-packaging.md
VoiceovervoiceoverTTS-Erzählungsdesign — SSML-Tempo, Sprachauswahl (Inworld 1.5-Max / ElevenLabs v3 / Cartesia Sonic-3), Audio-Tags, LUFS-Normalisierungreference/voiceover-design.md
UntertitelcaptionsUntertitelerstellung — SRT / WebVTT, WCAG 1.2.2 + 1.2.5 (AD), GPT-4o-Transcribe-Pipeline, erzwungene / geschlossene / offene / eingebrannte Variantenreference/captions-design.md
VorschaubildthumbnailPlattformspezifisches Vorschaubild-Design (YouTube 1280×720, LinkedIn 1200×627, X 1600×900, Product Hunt 1200×1200) + A/B-Variantenreference/thumbnail-design.md

Unterbefehls-Dispatch

Analysiere das erste Token der Benutzereingabe.

  • Wenn es mit einem Rezept-Unterbefehl oben übereinstimmt → aktiviere dieses Rezept; lade nur die "Zuerst lesen"-Spaltendateien im ersten Schritt.
  • Andernfalls → Standardrezept (demo = Demo). Wende den normalen Skript → Bühne → Aufnahme → Lieferung Arbeitsablauf an. Pro-Rezept-Verhalten über die Rezepte-Tabelle hinaus (Seitenverhältnis-Viewport-Größen, Qualitätsschwellen, Untertitel-Cue-Limits, Vorschaubild-Größen und A/B-Regeln) -> reference/scenario-guidelines.md § Pro-Rezept-Verhaltenshinweise.

Ausgabe-Routing

SignalAnsatzPrimäre Ausgabe
Produkt-Demo, Feature-Walkthrough, Onboarding-Clip, unklare AnfrageStandard-Demo-Aufnahme.webm + Transkript + VideoObject JSON-LD
Stakeholder-Präsentation, Investor-DemoPräsentationstempo-Aufnahme mit OverlaysDemo-Video + Lieferhinweise
Mobil, Tablet, Multi-DeviceGerätespezifische Viewport-KonfigurationGerätevarianten-Video-Set
Vertikal, Reels, Shorts, TikTok, 9:161080x1920, 21-34s ideal9:16 Demo-Set
LinkedIn, 4:5, Feed-freundlich1080x1350, 15-60s4:5 Vertikale Demo
Multi-Seitenverhältnis, Plattformübergreifendes Set16:9 + 9:16 + 4:5 + 1:1 aus einem SzenarioPro-Seitenverhältnis-Varianten
Vorher/Nachher, Design-Vergleich, Visueller DiffSide-by-Side oder sequenzieller VergleichVergleichsvideo
Persona-Demo, BenutzerreisePersonenbewusste Aufnahme mit...

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Verwandte Skills