Communitygithub.com

film-crew

Vier Werkzeuge für den Dreh: Modelle auswählen, Fortschritt verfolgen, Ergebnisse präsentieren – alles in einer Installation.

Was ist film-crew?

Das Skill-Paket „film-crew“ stellt vier eng verzahnte Werkzeuge bereit, die während des filmischen Generierungsprozesses zum Einsatz kommen – nachdem festgelegt wurde, wie gedreht wird (durch „film-director“). Es unterstützt die Ausgabe von Videos und Bildern über die offiziellen APIs von Alibaba Cloud Bailian (Wan 3.0, HappyHorse 1.1), Volcano Ark (Seedance 2.5/2.0), MiniMax (H3-Max) und OpenAI Images (gpt-image 2.6). Der Skill umfasst: (1) `backends/` – wandelt einen Job-Sheet (JSON-Auftrag) in Medien um, zeigt vor dem Versand die genaue Anfrage an und wählt Modelle anhand von Fähigkeitskarten (Preis, Geschwindigkeit, Unterstützung von Referenzbildern, Videolänge). (2) `viewer/` – erzeugt aus dem Ausführungsverzeichnis eine Live-Progress-Seite (zeigt jede einzelne Generierung mit Kosten und Dauer), eine Showcase-Seite (Gegenüberstellung von Eingabe-Prompts, Parametern, Referenzbildern und Ergebnissen) und einen Node-Graphen (der die Datenflüsse zwischen den Shots darstellt und als ComfyUI-Workflow exportiert werden kann). (3) `comfyui/` – öffnet jeden Shot als Workflow in ComfyUI, sodass Menschen die Schritte nachvollziehen und weiterbearbeiten können (rein lesend, keine Generierung). (4) `formats/` – definiert das Format der beiden Austauschdokumente (Job-Sheet, Shot-Manifest), stellt Prüfskripte bereit und liest ein Ausführungsverzeichnis in ein Shot-Manifest. Alle Komponenten kommunizieren nur über diese zwei Dateien. API-Keys werden ausschließlich aus Umgebungsvariablen gelesen und niemals in Dateien gespeichert oder ausgegeben. Der Skill ist für Entwickler und Agenten gedacht, die einen vollständigen Medienproduktions-Workflow in einer einzigen, reproduzierbaren Umgebung orchestrieren möchten.

Funktioniert mit~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/memoryoffish/film-director-skill-plugin/tree/HEAD/plugins/film-crew

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht film-crew?

Ein Satz: Während die Drehmethode festlegt, wie gedreht wird, stellt dieser Skill die Werkzeuge bereit, die während des Drehs zum Einsatz kommen – Modelle auswählen, Fortschritt verfolgen, Ergebnisse präsentieren. Vier Blöcke, jeder mit eigener overview.md; alle Pfade relativ zu diesem Verzeichnis.

Die vier Blöcke auf einen Blick

BlockAufgabeWann verwendenZuerst lesen
backends/Job-Sheet rein, Video/Bild rausWenn ein Video oder eine Bildserie generiert werden soll; die genaue Anfrage vor dem Versand sehen; ein Modell auswählenbackends/overview.md
viewer/Ausführungsverzeichnis → Webseite für MenschenWährend des Drehs jede Generierung live verfolgen (Progress-Seite); nach dem Dreh sehen, was jeder Shot bekommen und geliefert hat (Showcase-Seite und Node-Graph)viewer/overview.md
comfyui/Jeden Shot in ComfyUI anzeigenWenn jemand in ComfyUI sehen möchte, wie ein Shot zusammengesetzt wurde, um Schlüsselbilder und Clips weiterzuverwendencomfyui/overview.md
formats/Format der beiden AustauschdokumenteBeim Schreiben oder Prüfen eines Job-Sheets; beim Einlesen eines Ausführungsverzeichnisses in ein Shot-Manifestformats/overview.md

Die vier Blöcke tauschen Daten ausschließlich über zwei Dateien aus: Job-Sheet (was generiert werden soll) → an das Backend; Shot-Manifest (was jeder Shot verbraucht und produziert hat) → an die beiden Viewer.

Wo sie beim Dreh einer Produktion zum Einsatz kommen

  1. Drehbeginn: Die Progress-Seite startet in einem tmux-Session – danach wird jede Generierung dort aufgelistet: python3 viewer/scripts/progress.py <Ausgabeverzeichnis> --jobs <Projekt>/clips --prices backends/cards/prices.json --every 60.
  2. Generierung: Jede Generierung schreibt ein Job-Sheet nach <Projekt>/jobs/ (Video) bzw. <Projekt>/jobs_img/ (Bild). Zuerst python3 backends/scripts/filmgen.py request <Sheet> um die Anfrage zu prüfen, dann run. Das Backend verwendet die offiziellen APIs der Hersteller: Alibaba Cloud Bailian (Wan 3.0, HappyHorse 1.1), Volcano Ark (Seedance 2.5 / 2.0), MiniMax (H3-Max), OpenAI Images (gpt-image 2.6). Die Modellauswahl erfolgt anhand der Karten in backends/cards/.
  3. Nach dem Dreh: Im Ausführungsverzeichnis wird eine Shot-Tabelle meta.json erstellt (Name jedes Shots, Start- und Endsekunde im fertigen Clip, verwendeter Generierungsdurchlauf), dann python3 formats/read_run.py <Konfiguration> --out <Manifest-Verzeichnis> um daraus ein Shot-Manifest zu lesen, und python3 formats/check_manifest.py zur Prüfung.
  4. Präsentation: Die Webseite wird erzeugt mit python3 viewer/scripts/console.py <Manifest…> <Ausgabeverzeichnis>. Für ComfyUI: python3 comfyui/scripts/shots2comfy.py <Manifest…> --comfy <ComfyUI-Verzeichnis>. Der Node-Graph auf der Webseite zeichnet den ComfyUI-Workflow nach; dafür muss zuerst shots2comfy.py laufen und console.py mit --workflows aufgerufen werden.

Erforderlich: Python 3.10 oder höher. backends, formats, die Progress-Seite und shots2comfy.py verwenden nur die Standardbibliothek (backends nutzt ffprobe zur Längenmessung der fertigen Clips); die Showcase-Seite (console.py) benötigt zusätzlich Pillow und ffmpeg; send erfordert ssh mit tmux auf dem Zielrechner; die ComfyUI-Node-Pakete laufen in der eigenen ComfyUI-Umgebung (mit deren Pillow, numpy).

Die genauen Parameter und Prüfschritte für jeden Schritt stehen in der overview.md des jeweiligen Blocks.

Regeln

  • API-Keys nur aus Umgebungsvariablen (DASHSCOPE_API_KEY, ARK_API_KEY, MINIMAX_API_KEY, OPENAI_API_KEY), nie in Dateien schreiben, nie ausgeben. Ohne gesetzten Key funktioniert request dennoch.
  • Viewer sind schreibgeschützt: Sie ändern weder das Ausgabeverzeichnis noch rufen sie Generierungsschnittstellen auf. Wenn jemand in ComfyUI oder auf der Webseite Anpassungen vornimmt, wird der Agent informiert, der die Änderungen vornimmt und den Auftrag erneut einreicht.
  • Erst prüfen, dann senden: Jedes Job-Sheet zuerst mit request prüfen. Bei Wiederholung oder Parameteränderung als neues Sheet mit neuem Namen speichern.
  • Die erzeugten Seiten vor der Übergabe an den Benutzer selbst ansehen.

Verwandte Skills