Communitygithub.com

yomage-ai/ai-video-director-skill

Open Source AI Video Director Skill – Zweisprachiger KI-Videoregisseur für Talking-Head-Schnitt, B-Roll, Untertitel und Auslieferung.

Was ist ai-video-director-skill?

Dieser Skill verwandelt die KI in einen professionellen Videoregisseur für Talking-Head- und Screencast-Aufnahmen. Er übernimmt selbstständig Setup, Transkription, Konvertierung, Rendering und Qualitätsprüfung und bittet den Benutzer nur um Entscheidungen, die die KI nicht treffen kann (z. B. Content-Freigabe, visuelle Richtung). Unterstützt werden sowohl Chinesisch (vereinfacht) als auch Englisch als Arbeitssprachen. Der Skill arbeitet mit macOS, Linux und Windows (PowerShell) und verwendet ein mehrstufiges Workflow-System (Content → Rough Cut → Style Sample → Fine Edit → Release → Delivery). Er enthält einen integrierten Bearbeitungsstil namens „Xiaoxiong“ (mit Untertiteln, Lautstärke-, Farb- und Layout-Voreinstellungen), der ohne zusätzliches Profil sofort einsatzbereit ist. Für die Bearbeitung nutzt er Tools wie ChatCut, HyperFrames und FFmpeg, wobei jede Phase auf ihre eigenen Konfigurationen und Prüfungen zugreift. Bemerkenswert ist die strikte Durchsetzung von Qualitätstoren: Ein erfolgreicher Tool-Aufruf oder eine ASR-Transkription gilt nicht als Nachweis für die Qualität – die KI muss tatsächlich zuhören oder zusehen, bevor sie einen Schritt als „geprüft“ markiert. Die Kommunikation mit dem Benutzer wird auf vier wesentliche Entscheidungspunkte komprimiert: Inhalt, Rohschnitt, audiovisuelle Stilrichtung und endgültige Masterversion. Bereits erteilte Genehmigungen werden nicht erneut angefragt. Der Skill ist als Open-Source-Projekt auf GitHub verfügbar und eignet sich besonders für Content-Ersteller, die wiederkehrende Videoproduktionen automatisieren möchten.

Funktioniert mit~Claude Code✓Codex CLI~Cursor
npx skills add yomage-ai/ai-video-director-skill

In Ihrer bevorzugten KI fragen

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

Dokumentation

AI Video Director

Antworte in der Sprache des Benutzers. Unterstützt vereinfachtes Chinesisch und Englisch. Eigenes Setup, Prüfung, Transkription, Konvertierung, Rendering und Qualitätskontrolle; frage nur nach Entscheidungen oder Aktionen, die der Agent nicht im Namen des Benutzers ausführen kann. Vorhandene Autorisierung wiederverwenden.

Geltungsbereich

Der Produktionspfad umfasst aufgenommene Talking-Head-Aufnahmen, einschließlich Bildschirm-Demo-Aufnahmen mit eingebauter Webcam. Überprüfe flachgelegtes Material, bevor du verspricht, die Person zu repositionieren: Unabhängige Ebenen erfordern separate Quellen oder eine explizit geprüfte Rekonstruktion. Verlange keine separaten Aufnahmen, wenn die aktuelle Testrunde explizit eine flachgelegte Quelle verwendet.

Digital-Human/Avatar-Produktion ist pausiert. Verwende niemals SadTalker oder den veralteten ai-auto-editing-director. Ein explizit autorisiertes kurzes Sprachsample verwendet voice-clone.md; dies autorisiert keinen vollständigen Stimmenersatz. Die Einführung neuer Tools oder Modelle folgt tool-governance.md.

Start oder Fortsetzung

  1. Löse das tatsächliche Skill-Verzeichnis auf und lies dependency-setup.md. Der Agent führt sh scripts/bootstrap.sh --stage intake --apply auf macOS/Linux oder scripts/bootstrap.ps1 --stage intake --apply in PowerShell unter Windows aus. Verwende gesunde Abhängigkeiten wieder; installiere fehlende. Eine Skill-Ordner-Installation hat keinen universellen Abhängigkeits-Hook: Führe dies bei der ersten Verwendung aus, auch wenn der Ordner bereits existiert. Führe doctor nach Reparaturen aus, unter Verwendung des aufgelösten Node. Setup-Quittungen sind lokale Installationsnachweise, keine Editor-Konnektivität. Halte die erste Inhaltskarte schnell; bereite grobe Werkzeuge vor der groben Ausführung und den ausgewählten Renderer vor der Feinarbeit vor.
  2. Halte Projekte und private Medien außerhalb dieses Repositorys. Erstelle ein Projekt mit director.mjs init-project oder lade seinen vorhandenen Zustand. Überschreibe niemals genehmigte Medien, Timeline oder Komponenten; erstelle eine neue Version und behalte die alte, bis der Ersatz die Prüfung besteht.
  3. Lade den gebündelten Xiaoxiong-Stil, der in xiaoxiong-public-style.md beschrieben ist. Seine Audio-, Untertitel-, Farb-, Paletten-, Layout- und Inhaltsanpassungs-Standardwerte funktionieren ohne ein privates Profil. Lies die effektiven Standardwerte und optionalen Überschreibungen mit memory.mjs show --stage intake --include-candidates. Verwende --stage rough|fine|release, --key, --style und Projekt-Override nach Bedarf. Wenn die Verwendung der Xiaoxiong-Identität ausgewählt ist, lade $xiaoxiong-ip und übergib sein aufgelöstes Verzeichnis mit --identity-skill; ansonsten wird kein Xiaoxiong-Charakter oder Signoff eingefügt. Bereite die exakte Schriftart und neutrale Referenz-Assets mit prepare-style-assets.mjs --out <external-project>/assets/xiaoxiong-style vor. Der Verlauf ist optional. Ausstehendes Feedback ist ein Vorschlag, kein effektiver Standard. Folge memory-and-feedback.md.
  4. Für ein neues Projekt lies workflow.md. Lese nur die Referenzen der aktuellen Phase unten; konsultiere Maschinenvertragsabschnitte mit director.mjs contract --section roughCut (oder bRollContinuity, finishingPass) wenn nötig. Lade nicht den gesamten Vertrag oder alle Referenzen standardmäßig.

Standardmäßig werden die öffentlichen Xiaoxiong-Untertitel, Lautstärke-, Farb- und Bildschirmstile verwendet; neue Maschinen benötigen kein altes persönliches Profil. Die Xiaoxiong-Identität und der Abspann laden erst xiaoxiong-ip. Überprüfe bei der ersten Verwendung die tatsächliche Installation, den Projektpfad und die aktuellen Präferenzen; bei Fortsetzung werden unveränderte Umgebungsergebnisse wiederverwendet. Private Medien gelangen nicht in das öffentliche Repository. Lese die Spezifikationen und gültigen Präferenzen phasenweise; Verlauf und ausstehendes Feedback können aktuelle Entscheidungen nicht automatisch überschreiben.

Bei der ersten Verwendung muss der Agent die Abhängigkeiten selbstständig installieren; er darf nicht nur Doctor ausführen und die Installationsliste dem Benutzer übergeben. Der Einstiegspunkt wird Node 22+ wiederverwenden oder herunterladen und prüfen, Skriptabhängigkeiten und FFmpeg installieren; vor dem Rohschnitt setup.mjs --stage rough --apply --codex <absoluter Pfad des aktuellen Desktop-Host-CLI> ausführen, um das offizielle ChatCut-Plugin zu installieren und die tatsächliche Konnektivität und Transkription zu überprüfen. Vor dem Feinschnitt setup.mjs --stage fine --apply ausführen, um die feste Version von HyperFrames, das zugehörige Creations-Skill und den Rendering-Browser wiederzuverwenden oder zu installieren; --renderer cutout nur für Keying hinzufügen. Der Agent muss die agentActions in der Quittung weiterverarbeiten und die tatsächlichen Musterprüfungen durchführen; nur Login und der Host, der kein automatisches Nachladen von Tools, Systemberechtigungen oder neue Kosten erlaubt, erfordern Benutzerbeteiligung. localReady kann nicht als Bereitschaft zum Schneiden betrachtet werden; fehlende optionale Modelle dürfen die erste Analyse nicht blockieren.

Phasenrouting

PhaseAktion und Pflichtlektüre
InhaltVerwende ein zuverlässiges Manuskript und eine lokale Medienprüfung für eine schnelle erste Karte. Folge first-approval-and-style-gates.md. Lege die Behauptung, Beweise, beabsichtigten Schnitte und bedeutsame Einschränkungen fest; die Unterstützungsanzahl folgt Inhalt und Dauer. Verschiebe nicht genehmigtes Styling.
RohschnittBevor du Medien importierst oder fortsetzt, lies chatcut-media-recovery.md: Unterscheide Host-Verbindung, ausstehenden Upload und echte Wiedergabe; bewahre den Schnitt auf und verwende begrenzte Wiederherstellung. Lies dann production-standard.md und dialogue-join-audit.md. Vergleiche Takes qualitätsorientiert, überprüfe jeden tatsächlichen Join und alle wiederholten Fehlerklassen, bewahre Wortanfänge/-enden auf, prüfe Pausen und frühes/mittleres/spätes Tempo. Normalisiere Farbe und Dialog einmalig mit expliziter Verarbeitung.
ÜbergabeLies chatcut-handoff.md. Exportiere geprüftes Timing in kanonische EDL; explizite konstante Umzeitung, Video-EQ und Audioverarbeitung verwenden einen hashgebundenen Verarbeitungsplan. Nicht unterstützte XML-Effekte müssen fehlschlagen; verwende für komplexe Verarbeitung eine geprüfte quellqualitätsabhängige Ableitung.
Rohschnitt-FreigabeRender das exakte A-Roll, bereite Prüffenster mit prepare-rough-review.mjs vor, schaue/höre tatsächlich zu und führe audit-rough-cut-review.mjs aus. Die Prüfung bindet die reale EDL, Quellen, Render und Fenster. Danach folgt die Benutzerfreigabe. Verwende für den reinen Rohschnitt-Umfang den Lieferzweig unten und schließe hier ab.
GesamtstilLies fine-edit-direction.md und curated-style-library.md. Exakte genehmigte Referenz → explizite Benutzerreferenz → kuratierte Kandidaten → dynamic-style-adaptation.md. Empfehle ein vollständiges audiovisuelles 6–12-Sekunden-Muster; inkludiere Untertitel, Belege, Präsentator und BGM/SFX-Entscheidungen zusammen. Führe audit-fine-edit-direction.mjs aus.
FeinschnittLeite pro Shot mit tool-selection.md. Lese die bedingten Referenzen unten. Führe gezielte Risiko-Grenzen-, Untertitel-, Layout-, Matte-, Sound- und Farbprüfungen vor einem vollständigen Render durch.
Release-VersionVerwende release-render-operations.md für schwere Ausgabe. Wende ein passendes genehmigtes Host-Preset als ganzes Paket an, behalte einen schweren Job, überwache den Speicher und ändere nach Fehlschlag die Strategie. Prüfe und dekodiere vollständig die exakte finale Datei.
LieferungVerwende das Phasentor und audit-delivery-manifest.mjs; liefere das Master, bearbeitbares Projekt, Timing, Untertitel, Rechte, QA und Lernaufzeichnungen. Lies platform-release-and-publish-package.md und führe audit-publish-package.mjs nur aus, wenn die Veröffentlichung im Umfang ist.

Bedingte Referenzen

  • UI-Belege: evidence-state-roi-audit.md. Stelle exakte Navigation und semantischen ROI sicher; verwende vor der Aufnahme isolierte Demo-Daten und eine Whitelist sichtbarer Module.
  • Präsentator und gleichzeitige A/B-Abdeckung: presenter-coverage-modes.md, dann audit-coverage-boundaries.mjs. Behandle B-base-A-cutout unabhängig von PiP; bewahre kanonisches Audio auf und teste bewegendes Alpha.
  • Untertitel: caption-semantic-pagination.md, dann audit-caption-pages.mjs. Hochformat-Kurzform beginnt mit einer semantischen Zeile; Lesbarkeit oder exakte genehmigte Referenzen können zwei Zeilen rechtfertigen.
  • Hochformat-sicheres Layout: portrait-talking-head-safe-layout.md, einschließlich layout.portrait-talking-head.safe-v1 wenn es der genehmigten Serie entspricht.
  • Semantischer Fortschritt: semantic-progress-rmcu.md, rmcu.semantic-progress.v1. Verwende nur, wenn es die Navigation unterstützt. Inaktive lange Labels verwenden Auslassungspunkte; aktiver Überlauf folgt dem Komponentenvertrag.
  • Code-Motion-Wiederverwendung: code-motion-components.md; klassifiziere die Komponente als G, P, T, A oder X und trenne den allgemeinen Mechanismus, privaten Adapter und Projektinstanz.
  • ChatCut: Folge den Grundlagen des aktiven Hosts, Talking-Head-, Transkriptions-, Verifikations- und Export-Skills nach Bedarf. HyperFrames-Authoring liest $hyperframes; ein Renderer besitzt einen Shot.

Ausführbare Tore

Lies execution-and-evidence.md vor dem ersten Render. Verwende stage.mjs check|run pipeline.json rough-render|fine-render|deliver als normalen Ausführungspfad. Der A-Roll-Kandidat existiert notwendigerweise vor seiner eigenen Rohschnitt-Prüfung; Feinrender erfordert den genehmigten Rohschnitt und das Stilmuster. Die Lieferung bindet die exakte finale Datei und überprüft erneut die Abhängigkeits-Hashes.

Für eine reine Rohschnitt-Anfrage setze outputScope: "rough-cut", binde roughDelivery.editableProject und roughDelivery.captions, führe dann stage.mjs run pipeline.json deliver nach der Rohschnitt-Freigabe aus. Liefere genehmigtes A-Roll, EDL, das bearbeitbare Timing-Projekt und Untertitel. Überspringe Stil, Feinrender und Veröffentlichung; keine zusätzliche Endmaster-Freigabe ist für dieselbe genehmigte Rohschnitt-Datei erforderlich. Siehe execution-and-evidence.md.

Markiere niemals eine Datei als geprüft aufgrund eines erfolgreichen Tool-Aufrufs, eines ASR-Transkripts, eines gesetzten Booleschen Werts oder eines ansprechenden Standbilds. Fehlende auditive oder visuelle Fähigkeit muss ein explizit unverifizierter Punkt bleiben. Der Agent zeichnet tatsächliches Zuhören und gerenderte Belege auf; die Benutzerfreigabe wird mit ihrer Quelle, ihrem Zeitstempel und dem Artefakt-Hash bewahrt.

Feedback und Verifikation

Verwende interaction.md, um vier normale Benutzerentscheidungen kompakt zu halten: Inhalt, Rohschnitt, audiovisueller Stil und Endmaster. Fasse Untertitel-/Musik-/Präsentator-Entscheidungen im Stilmuster zusammen; übernimm vorhandene Autorisierung. Folge memory-and-feedback.md für öffentliche Regeln, kuratierte Stile, private Präferenzen und projektbezogene Lektionen.

Verfolge das nächste unabhängige reale Projekt mit analysis/trial-metrics.json: Erste-Karte-Latenz, Revisionen, wiederholte Fehler, Renderanzahl, aktive Zeit und gemessene Ressourcen. Testergebnisse sind kein Beweis für stabile Schnittqualität. Folge der aktuellen aufgezeichneten Förderentscheidung; das Veröffentlichen von Quellcode markiert einen ausstehenden realen Projektversuch nicht als abgeschlossen.

Verwandte Skills