Communitygithub.com

video-forge (成片工坊)

Ein Skill für die Erstellung von Videos, Animationen, Musikvideos, Erklärfilmen und 3D-Miniaturszenen. Er fragt zunächst alle Details ab, bestätigt den Stil und das Storyboard, produziert dann und lässt das Ergebnis von unabhängigen Sub-Agenten bewerten, bevor es archiviert wird.

Was ist video-forge (成片工坊)?

Dieser Skill dient als zentrale Regie-Einheit für die Videoproduktion. Er ist für Entwickler und KI-Agenten konzipiert, die strukturierte, mehrstufige Arbeitsabläufe für die Erstellung von Inhalten benötigen. Der Skill zwingt den Benutzer, alle kreativen Entscheidungen (Szene, Charaktere, Emotion, Struktur, Sound, Einschränkungen) im Voraus zu klären, bevor zeitaufwändige Arbeiten beginnen. Er unterstützt mehrere Produktionslinien: Stil-Videos (30–90 Sekunden), Musikvideos (MV), Erklärvideos und 3D-Miniaturszenen mit Three.js. Der Arbeitsablauf ist in strengen Phasen organisiert: Anforderungserfassung, Stilauswahl, Bestätigung des Style-Frames, Charakter-Setup, Storyboard-Erstellung, Erstellung eines Rohentwurfs, eine Bewertungsschleife mit unabhängigen Sub-Agenten (die jeden Frame prüfen) und schließlich die Archivierung. Der Skill legt großen Wert auf Bestätigungen durch den Benutzer, klare, numerische Stildefinitionen (z. B. Farbwerte, Linienstärken, Kamerasprache) und die Dokumentation aller Entscheidungen in standardisierten Karten und Vorlagen, die in `~/video-forge` abgelegt werden. Er enthält auch Mechanismen zur Leistungsanalyse nach der Veröffentlichung.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hongxiang01/video-forge/tree/HEAD/skill

In Ihrer bevorzugten KI fragen

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

Dokumentation

🎬 Video-Forge (成片工坊 – Videofabrik)

Ein gutes Werk entsteht nicht aus einem einzigen Satz. Dieser Skill kümmert sich um drei Dinge:

  1. Alles genau klären: Bei vagen Anforderungen wird so lange nachgefragt, bis Szene, Figuren, Emotionen und jedes Detail in konkreten Bildern festgelegt sind.
  2. Erst bestätigen, dann produzieren: Stil, Setting und Storyboard müssen vom Benutzer abgenickt werden, bevor die zeitaufwändige Produktion startet.
  3. Von anderen prüfen lassen: Das fertige Werk wird von unabhängigen Prüfern anhand der vom Benutzer bestätigten „Bewertungsstandardkarte“ beurteilt. Eine Selbsteinschätzung ersetzt nicht die Qualitätskontrolle.

Die Produktion selbst wird an bestehende Pipelines delegiert (z. B. lemo-opuscar, mv-director, Remotion, Three.js Miniaturen). Dieser Skill übernimmt ausschließlich die Regie und die Qualitätskontrolle.

Eiserne Regeln

  1. Kein Start mit einem einzigen Satz. Die Pflichtfelder aus der Checkliste (references/interview-checklist.md) müssen alle abgefragt sein, bevor die Produktion beginnt. Sagt der Benutzer „entscheide du“, gib konkrete Standardwerte an, schreibe sie in die Anforderungskarte und zeige sie dem Benutzer.
  2. Vage Begriffe in Bilder übersetzen. „Gemütlich“, „hochwertig“, „stimmungsvoll“ sind keine Antworten. Gib 2–4 konkrete Bildoptionen zur Auswahl.
  3. Nach jeder Fragerunde die Anforderungskarte einblenden (aus references/card-templates.md). Der Benutzer muss auf einen Blick sehen, was bereits festgelegt ist und was noch fehlt.
  4. Die Reihenfolge der Phasen ist strikt einzuhalten: Anforderungskarte + Bewertungsstandardkarte → Stil (Beispielmaterial) → Stilkarte/Stil-Frames → Settingkarte → Storyboard-Verbindungstabelle → Rohentwurf → Prüfschleife → Archivierung. Eine Pipeline kann erklären, dass sie eine Phase überspringt (z. B. Miniaturen haben kein Storyboard), aber das muss klar benannt werden.
  5. Storyboard standardmäßig bestätigen lassen (lemo bestätigt standardmäßig nicht; hier wird auf Standard-Bestätigung geändert).
  6. Die Prüfer sind unabhängige Sub-Agenten, die nur das Werk und die vom Benutzer bestätigte Bewertungsstandardkarte erhalten – nicht meine Schlussfolgerungen. Die Prüfer sehen das gesamte Video (alle 2 Sekunden ein Frame), dürfen nur den Ton messen, aber nicht bewerten, ob er gut klingt. Aussagen des Benutzers haben Vorrang vor den Prüfern.
  7. Figuren spielen nicht: Per Code gezeichnete Gesichtsausdrücke und Handbewegungen wirken zwangsläufig steif. Figuren werden nur klein, weit entfernt, statisch oder in einfachen Schleifen dargestellt, es sei denn, die Pipeline kann Charakter-Rigging.
  8. Benutzeräußerungen in die Karten übernehmen: Konkrete Anforderungen des Benutzers (z. B. „keine flachen Lichter“) werden wörtlich in die Verbotszone oder als harte Anforderung in die Anforderungskarte übernommen.
  9. Große Aufgaben arbeitsteilig auf mehrere Agenten verteilen (siehe references/division-of-labor.md): Zuerst das Grundgerüst der Dateien festlegen; jeder Agent zitiert nur die Nummern; Arithmetik mit Skripten validieren. Nicht die Denktiefe reduzieren, um Timeouts zu vermeiden.
  10. Werke werden in ~/video-forge archiviert, nicht in temporären Verzeichnissen; temporäre Verzeichnisse gehen bei einem Neustart verloren.
  11. Netzwerk: Der Proxy dieser Maschine ist extrem langsam. Große Downloads mit curl --noproxy '*', env -u http_proxy -u https_proxy -u HTTP_PROXY -u HTTPS_PROXY umgehen. Wenn grep in der Shell defekt ist, /usr/bin/grep verwenden.

Schritte

0. Weiterleitung

Prüfe zuerst ~/video-forge/recipes/. Wenn der Benutzer ein bestimmtes Rezept nennt („Mach einen Bahnhof mit dem 3D-Cel-Shading-Miniatur-Rezept“), lies die Rezeptdatei und frage nur nach den darin nicht festgelegten Details.

Ansonsten wähle die Pipeline basierend auf den Anforderungen:

AnforderungPipelineDatei
Kurzfilm (30–90 Sekunden) in einem bestimmten Stil mit eigenem ThemaStil-Videoreferences/pipeline-style-film.md
Musikvideo zu einem LiedMVreferences/pipeline-mv.md
Ein Thema, Geschichte oder Daten erklärenErklärvideoreferences/pipeline-explainer.md
Kleine 3D-Szene zum Drehen und ZoomenMiniaturreferences/pipeline-diorama.md

Wenn der Benutzer gar keine Idee hat: Gehe durch die Anleitung für Anfänger in references/style-picker.md (zuerst Beispielmaterial ansehen, dann Ideen vorschlagen).

1. Befragung → Anforderungskarte

Bestimme zuerst Videotyp und Längenklasse, lade die entsprechende Genre-Karte aus references/genres/ (Auswahl siehe genres/README.md). Alle weiteren Fragen, der Aufbau, das Wortbudget und die Bewertungsstandardkarte basieren auf dieser Karte.

Frage Runde für Runde nach der references/interview-checklist.md. Verwende AskUserQuestion, maximal 4 Fragen pro Runde, formuliere Optionen als konkrete Bilder. Zeige nach jeder Runde die Anforderungskarte. Wenn alle Pflichtfelder ausgefüllt sind, lass den Benutzer die Karte bestätigen.

2. Stil

Hat der Benutzer keinen Stil gewählt: Empfehle 2–3 Stile aus references/style-picker.md mit Link zu Beispielmaterial und gib gleichzeitig die vollständige Liste aller 66 Stile (als reinen Text, nicht mit AskUserQuestion, da zu wenige Optionen die Liste verstecken würden). Nach der Auswahl die STYLE.md des Stils lesen und in eine Stilkarte zusammenfassen (Werte: Farbwerte, Linienstärke, Lichtverhältnis, Schriftarten, Kamerasyntax, Sound). Dem Benutzer zur Bestätigung vorlegen.

3. Stil-Frames

Erzeuge 1–3 Stil-Frames mit echtem Zeichencode (ein Bildausschnitt/eine Ecke, mit festgelegtem Licht und Farbe). Erst nach Bestätigung durch den Benutzer weitermachen.

4. Settingkarte

Wenn es Figuren, Orte oder Objekte gibt, für jedes eine Settingkarte erstellen: Aussehen, Proportionen, Farbgebung, Kleidung, wichtige Requisiten, was nicht vorkommen darf. Ein Setting-Bild generieren und vom Benutzer bestätigen lassen.

5. Storyboard-Verbindungstabelle

Ein Raster mit 6–9 Miniaturansichten (pro Kästchen: Zeit, Bildausschnitt, Kamerabewegung, Sound, Untertitel). Erst nach Bestätigung durch den Benutzer mit der Animation beginnen.

6. Rohentwurf → Prüfschleife

Den Rohentwurf gemäß der Pipeline erstellen, dann gemäß references/review.md zwei Prüfer starten. Diese bewerten Punkt für Punkt anhand der Bewertungsstandardkarte (bestanden / teilweise / nicht bestanden + Beweis-Frame). Nur die nicht bestandenen Punkte überarbeiten. Dem Benutzer nach jeder Runde das Ergebnis zeigen. Abbruchkriterien: Alle Muss-Punkte bestanden und Benutzer zufrieden, oder nach maximal 3 Runden, oder auf Wunsch des Benutzers.

7. Archivierung

In ~/video-forge/works/<slug>/ ablegen: Quellcode oder Link zum Projekt, fertiges Video/Screenshots, Anforderungskarte, Stilkarte, Storyboard, scores.md. In ~/video-forge/retros/ eine Retrospektive schreiben. Wenn die Vorgehensweise wiederverwendbar ist, aus recipes/_template.md ein neues Rezept erstellen und einen Eintrag in der Tabelle „🎞 Werke“ in ~/video-forge/README.md hinzufügen. Wenn neue externe Bibliotheken verwendet wurden, in deps.json eintragen und das index/-Verzeichnis neu aufbauen.

Etwa eine Woche nach der Veröffentlichung den Benutzer bitten, in der Plattform-Analyse (z. B. TikTok Creator Center) die vollständige Abspielrate, die durchschnittliche Sehdauer, die Sekunden mit den meisten Abbrüchen und die Abschnitte mit den meisten Wiederholungen zu prüfen. Diese Daten im Abschnitt „Veröffentlichungsdaten“ der scores.md des jeweiligen Werks ergänzen und in der Retrospektive einen Satz darüber schreiben, welche Designentscheidung zur Bindung beigetragen hat und wo die Zuschauer abgesprungen sind. Zukünftige Drehbücher und Storyboards sollten sich auf diese echten Daten stützen, nicht nur auf die Meinung der Prüfer.

Referenzdateien

PhaseDateiWann lesen
1 Befragungreferences/interview-checklist.mdJedes Mal vor Beginn; vor jeder Fragerunde prüfen, was noch fehlt
1–5 Kartenreferences/card-templates.mdBeim Einblenden von Anforderung, Stil, Setting und Storyboard
2 Stilreferences/style-picker.mdWenn der Benutzer keinen Stil gewählt hat oder nicht weiß, was er machen soll
3–6 Produktionreferences/pipeline-style-film.mdFür Kurzfilme mit dem lemo-opuscar-Stil
references/pipeline-mv.mdFür Musikvideos
references/pipeline-explainer.mdFür Erklär- und Infovideos mit Remotion
references/pipeline-diorama.mdFür 3D-Miniaturszenen mit Three.js
3–6 Arbeitsteilungreferences/division-of-labor.mdWenn mehrere Agenten an Treatment oder Produktion arbeiten: Aufgabenteilung, Grundgerüst, Validierungsskripte
Genrekarten (nach Typ/Länge)references/genres/README.mdNachdem Typ und Länge in der Befragung festgelegt wurden: Zeitbudget, Aufbau, visuelle & akustische Vorgaben, Validierungslogik und Prompt-Vorlagen aus der Karte
Musikreferences/music.mdAuswahl des Musikansatzes (Code-Komposition/Takt, lizenzfreie Bibliothek, Open-Source-Modell), Verwendung von tools/music/code_score.py
Stil / Effekte auswählen~/video-forge/index/catalog.md (index.json maschinenlesbar)Alle Stilbibliotheken, Effektkarten, Erzählgrammatik und eigene Stile in einer Tabelle; fehlende Bibliothek mit bash ~/video-forge/bootstrap.sh <id> installieren
1 / 6 Bewertungreferences/review-standards.mdWährend der Befragung Standardprüfpunkte für den Videotyp vorschlagen und gemeinsam mit dem Benutzer die Bewertungsstandardkarte erstellen
6 Prüfungreferences/review.mdPrüfer starten, Punkt für Punkt bewerten, über Abbruch entscheiden
Fehlerbehebungreferences/troubleshooting.mdBei Problemen mit Abhängigkeiten, Rendering, Screenshots oder Netzwerk
Archivierung~/video-forge/README.md, ~/video-forge/recipes/_template.mdNach Abschluss der Arbeiten

Verwandte Skills