Communitygithub.com

lhaovo/short-video-skills

Bereite nutzbare Bilder für die Videoproduktion vor – verwandle eine Asset-Liste in direkt für Bild-zu-Video-Modelle verwendbares Material: Produktionsreihenfolge planen, Asset-Stufen festlegen, Kandidaten generieren, Konsistenz prüfen, nummeriert ablegen und Status zurückschreiben. Unterstützt drei Quellen: Realdreh, KI-Generierung und offizielles Material, ohne Mindestanforderung für Realdreh.

Was ist short-video-skills?

Diese Fähigkeit (Skill) für KI-Agenten wie Claude Code, Cursor oder Codex bereitet visuelle Assets für die Videoproduktion vor. Sie löst das Kernproblem der Konsistenzerhaltung: Dass dasselbe Objekt in jedem Bild auch wirklich gleich aussieht. Die Eingabe ist eine Asset-Liste (z. B. aus einem Storyboard), die Ausgabe ist ein Satz nummerierter Bilder, die direkt von einem Bild-zu-Video-Modell (z. B. `short-video-generate`) als erstes Frame referenziert werden können. Der Skill definiert einen klaren, siebenstufigen Workflow: Liste lesen, Reihenfolge planen, Stufen zuweisen, Kandidaten generieren, akzeptieren, ablegen und Status zurückschreiben. Er stuft Assets in drei Stufen ein (Anker, Abgeleitet, Einmalig), um den Aufwand zu priorisieren, und bietet sowohl eine Batch-Generierung (mit dem Skript `scripts/kie_gen.py`) als auch eine automatische Prüfung (`scripts/check_assets.py`). Ob Realdreh, KI oder offizielles Material – der Skill erzwingt keine Methode, sondern stellt durch parallelen Bildvergleich und sieben Akzeptanzkriterien sicher, dass alle Bilder zusammengehören und die finale Videoproduktion nicht durch inkonsistente Assets blockiert wird.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/lhaovo/short-video-skills/tree/HEAD/short-video-assets

In Ihrer bevorzugten KI fragen

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

Dokumentation

Asset-Vorbereitungsstation

Ob die Videoproduktion nahtlos funktioniert, hängt von diesem Schritt ab. Das zu lösende Problem ist nur eines: Dass dasselbe Objekt in jedem Bild auch wirklich dasselbe Objekt ist.

Die Eingabe ist eine Asset-Liste (oder ein Storyboard), die Ausgabe ist ein Satz nummerierter Bilder, die direkt von short-video-generate als erstes Frame referenziert werden können.

Es schreibt kein Storyboard, unterteilt keine Szenen, schreibt keine Video-Prompts und generiert kein Video. Es ist verantwortlich für den Teil „Bild“.


1. Vier eiserne Regeln

  1. Zuerst Anker, dann Ableitungen. Wenn die Vorlage nicht feststeht, mache keine Perspektivbilder. Perspektivbilder entstehen aus der Vorlage – wenn die Vorlage falsch ist, ist die ganze Gruppe falsch.
  2. Ändere immer nur eine Variable. Wechsle die Perspektive, aber nicht das Licht. Wechsle das Licht, aber nicht die Perspektive. Änderst du beides gleichzeitig, kann man bei einem Problem nicht sagen, welcher Fehler es ist.
  3. Kandidaten werden nur hinzugefügt, nicht überschrieben. v1, v2 existieren nebeneinander; welche Version ausgewählt wird, wird im Arbeitsauftrag festgehalten. Generierung ist probabilistisch – die alte Version zu löschen bedeutet, den Rückweg abzuschneiden.
  4. Bild und Liste müssen übereinstimmen. Die Nummer ist der Dateiname. Wenn die Liste PR-01 enthält, muss das Verzeichnis PR-01_* enthalten.

2. Assets in drei Stufen

Nicht jedes Bild ist den gleichen Aufwand wert. Zuerst klassifizieren, dann Aufwand verteilen.

StufeWas ist esBeispielAnforderung
AnkerstufeIdentitätsbasis des gesamten Films, wird mehrfach referenziertProdukt-Hauptbild, Charakter-Drehansicht, Hauptszene-PanoramaStrengste: mehrere Kandidaten, Punkt-für-Punkt-Abnahme, nach Festlegung keine Änderungen mehr
Abgeleitete StufePerspektiven, Zustände, Details, die aus dem Anker entstehenProduktrückseite, geöffneter Zustand, HandaufnahmeMuss Seite an Seite mit dem Anker verglichen werden
Einmalige StufeErscheint nur einmal, beeinflusst die Konsistenz nichtLeere Einstellung, Lichteffekt, ÜbergangsmaterialReicht aus, wenn es passt, keine mehreren Kandidaten nötig

Falsche Klassifizierung ist Verschwendung: Ein 30-Sekunden-Film kann drei Tage ins Stocken geraten, wenn man eine leere Einstellung wie einen Anker behandelt; wenn man das Produkt-Hauptbild wie ein einmaliges Asset behandelt, muss jeder spätere Abschnitt neu gemacht werden.


3. Quellen: Alle drei sind möglich, je nach Verwendung wählen

QuelleWann verwendenAchtung
RealdrehPhysisches Objekt vorhanden, Genauigkeit erforderlich, betrifft Parameter oder WirkungAm besten, aber Material muss vorhanden sein
KI-GenerierungKein physisches Objekt, fiktive Szene, Atmosphäre, HandGeometrie und Aufdruck müssen fixiert werden, mehrere Kandidaten
Offizielles MaterialVom Markeninhaber bereitgestelltes Hauptbild, VerpackungsbildDirekt als Anker verwenden, am stabilsten

Realdreh ist nicht zwingend. Bei einem rein KI-generierten Film kann das gesamte Asset-Set von der KI stammen, solange es intern konsistent ist.

Ein Risiko, das vorher unbedingt geklärt werden muss

Wenn dieser Film dem Publikum konkrete Parameter oder Wirkungen vorgibt (Kapazität, Dauer, Inhaltsstoffe, Wirkung) und das Produkt im Bild KI-generiert ist, dann stimmen Bild und Aussage nicht überein – das kann von Kommentaren kritisiert werden oder im schlimmsten Fall irreführende Werbung darstellen.

Es gibt nur eine Vorgehensweise: Wird eine Behauptung aufgestellt, verwende für das Produktbild Realdreh oder offizielles Material; wenn keine Behauptung aufgestellt wird, es rein atmosphärisch oder fiktiv ist, reicht KI-Generierung völlig aus.

Diese eine Frage vor Arbeitsbeginn stellen, nicht erst warten, bis der Film fertig ist.

Wie die KI-Generierung läuft

Verwende das mitgelieferte scripts/kie_gen.py (KIE GPT Image 2): Senden, Abfragen, Herunterladen, Benennen und Ablegen in einem Durchlauf:

# Text-zu-Bild (Auflösung nicht angeben = 1K, ausreichend)
python scripts/kie_gen.py generate --prompt "…" --ratio 9:16 \
  --out 04-Material/01-Assetbilder/PR-01_Produkt-Hauptbild_v1.png

# Bild-zu-Bild: Anker als Referenz verwenden
python scripts/kie_gen.py generate --prompt "…" --ref PR-01_Produkt-Hauptbild_v1.png \
  --out 04-Material/01-Assetbilder/S01_f01_v1.png

# Batch: JSON-Aufgabenliste lesen (Standard 5-Wege-Parallelität)
python scripts/kie_gen.py batch --tasks tasks.json --out-dir 04-Material/01-Assetbilder --dry-run
python scripts/kie_gen.py batch --tasks tasks.json --out-dir 04-Material/01-Assetbilder

Auflösung standardmäßig 1K: Diese Bilder werden letztendlich vom Video-Modell neu skaliert; ein größeres Quellbild bewahrt keine Details, sondern erhöht nur die Fehlerrate. Nur wenn du es separat vergrößern und zuschneiden (für Cover) oder als weiße Hintergrundvorlage für die Wiederverwendung benötigst, füge --resolution 2K hinzu.

Standardmäßig 5 Bilder parallel. Das Generieren dauert 10–40 Sekunden; 6 Bilder seriell zu generieren bedeutet 3–4 Minuten Wartezeit; 6 Bilder mit 5 parallelen Läufen dauern etwa so lange wie das langsamste Bild plus einen Durchlauf. Bei Ratenbegrenzung (code != 200 oder 429) verwende --concurrency 2, ändere wegen Ratenbegrenzung nicht die Prompts.

Vier Disziplinen:

  1. Zuerst --dry-run, um den Request-Body zu sehen, dann wirklich laufen lassen. Ein Batch von zwanzig Bildern mit falschen Parametern ist zwanzigmal Verschwendung.
  2. Der Schlüssel geht nur über die Umgebungsvariable KIE_API_KEY, schreibe ihn nicht in Skripte, Aufgabenlisten oder Arbeitsaufträge.
  3. Zuerst Anker generieren, Stil bestätigen, dann Batch-Ableitungen. Für Ankerstufe empfiehlt es sich, die Parallelität zu reduzieren und jedes Bild einzeln zu betrachten.
  4. Notiere die taskId, schreibe sie in den Arbeitsauftrag, damit du später dasselbe Bild bei Bedarf nachschlagen kannst.

Schreibweise, Parametergrenzen und Fehlerbehandlung siehe references/ai-generation.md.


4. Sieben-Schritte-Prozess

1 Liste lesen → 2 Reihenfolge planen → 3 Stufe zuweisen → 4 Kandidaten generieren → 5 Abnahme → 6 Ablegen → 7 Zurückschreiben

Schritt 1 · Liste lesen

Lese aus 02-Asset-Liste.md die Nummer, den Typ, die Verwendung, die Quelle und die referenzierten Abschnitte.

Wenn die Liste keine Bild-Prompts enthält, ergänze sie mit den vier Gerüsttypen aus references/prompt-fixups.md; wenn sie vorhanden sind, verwende sie direkt, schreibe sie nicht neu.

Schritt 2 · Produktionsreihenfolge planen

Ankerstufe → Abgeleitete Stufe → Einmalige Stufe

Innerhalb derselben Stufe nach der Anzahl der Referenzen sortieren, je mehr Referenzen, desto früher. Grund: Assets mit vielen Referenzen betreffen bei einer Überarbeitung die meisten Szenen.

Für Orte, die in mehreren Szenen wiederverwendet werden und bei denen die räumliche Kontinuität wichtig ist, nach Bedarf in zwei Ebenen von Assets aufteilen:

  1. Raumstruktur-Vorlage: Ohne Personen, ohne Aktion, fixiert Boden-/Wandmaterialien, Schaufenster und Gebäudekörper, feste Hintergrundstruktur, räumliche Tiefenbeziehung sowie Quelle und ungefähre Richtung des Hauptlichts in der Szene; keine spezifische Kameraposition, Einstellungsgröße, Personen oder temporäre Requisiten fixieren.
  2. Kameraposition-Untervorlage: Von demselben Raum die tatsächlich verwendeten Perspektiven ableiten: Totale von vorne, seitliche Nahaufnahme, Vogelperspektive, Untersicht oder Detailaufnahme. Das erste Frame wird von der entsprechenden Kameraposition-Untervorlage abgeleitet, um zu vermeiden, dass der gesamte Film dieselbe Perspektive und Komposition erbt.

Jeder Raum bekommt nur die Perspektiven, die tatsächlich verwendet werden, keine feste Anzahl vorgeben. Die Lichtrichtung bleibt räumlich konsistent, aber ob es Versionen für Mittag/Abend gibt, hängt davon ab, ob die Handlung über Zeitabschnitte hinweggeht; die Basisvorlage sollte keine unnötig starken zeitlichen Merkmale einbrennen. Zuerst die repräsentativen Kamerapositionen Seite an Seite abnehmen, dann die ersten Frames im Batch ableiten.

Schritt 3 · Stufe zuweisen

Jeder Nummer eine Stufe zuweisen (Anker / Abgeleitet / Einmalig) und in den Arbeitsauftrag schreiben. Dieser Schritt dauert nur eine Minute, bestimmt aber, wie viele Kandidaten später erstellt werden.

Schritt 4 · Kandidaten generieren

StufeAnzahl KandidatenBeschreibung
Ankerstufe4–6Eines auswählen und festlegen, Rest als Reserve behalten
Abgeleitete Stufe2–3Nach Vergleich mit dem Anker auswählen
Einmalige Stufe1–2Reicht aus, wenn es passt

Vor der Generierung drei Dinge bestätigen: Ist das Seitenverhältnis richtig? Ist der Hintergrund richtig (weißer Hintergrund oder Szene)? Gibt es überflüssige Elemente (Text, Wasserzeichen, Hände)?

Bei KI-Generierung zuerst --dry-run, um die Parameter zu prüfen, dann in der Reihenfolge Anker → Abgeleitet einreichen, ein Batch von 4–6 Bildern.

Schritt 5 · Abnahme

Die sieben Punkte aus references/acceptance.md einen nach dem anderen durchgehen. Sechs von sieben Punkten müssen bestanden sein, um das Bild zu behalten. Wichtige Punkte (Geometrie, Aufdruck) nicht bestanden → direkt zurück.

Schritt 6 · Ablegen

04-Material/01-Assetbilder/
├── PR-01_Produkt-Hauptbild_v1.png
├── PR-01_Produkt-Hauptbild_v2.png   ← Reserve, nicht löschen
├── SC-01_Bürotisch_v1.png
└── CH-01_Weibliche_Hand_v1.png

Namensformat: <Nummer>_<Verwendung>_v<N>.<ext>. Die Nummer stimmt mit der Liste überein (Status-Suffixe A/B bleiben erhalten), die Verwendung 2–8 Zeichen, kann mit Unterstrich unterteilt werden, Version aufsteigend.

Schritt 7 · Zurückschreiben

Den Status in der Liste auf „Vorhanden / Vorhanden mit Reserve / Nachzuliefern“ ändern und im Arbeitsauftrag die ausgewählte Version notieren. Ohne Zurückschreiben weiß der nächste Schritt nicht, welche Version referenziert werden soll.


5. Wie Konsistenz gewährleistet wird

Mehrere Bilder derselben Nummer werden durch vier Maßnahmen abgeglichen:

  1. Gleiche Objektbeschreibung: Aus dem Prompt des Ankers kopieren, ohne Änderung
  2. Gleiche Lichtposition: Hauptlichtrichtung, Farbtemperatur fest vorgeben, abgeleitete Bilder wechseln das Licht nicht
  3. Gleiches Seitenverhältnis und Hintergrund: Weißer Hintergrund bleibt weißer Hintergrund, Szene bleibt Szene
  4. Seite-an-Seite-Vergleich: Zwei Bilder nebeneinander legen, Geometrie, Farbe, Aufdruck, Proportionen vergleichen

Der Seite-an-Seite-Vergleich ist die effektivste Methode. Einzelbildbetrachtung lässt alles richtig erscheinen; erst nebeneinander fällt auf, dass der Becherrand zwei Millimeter breiter ist oder das Logo eine Zeile höher steht.

Ausführliche Methode siehe references/acceptance.md.


6. Selbstprüfung (Skript ausführbar)

python scripts/check_assets.py --dir <Produktionsverzeichnis>

Fünf Kriterien:

#KriteriumStufe
A1Jede Nummer in der Liste hat eine entsprechende DateiKritisch
A2Dateiname entspricht <Nummer>_<Verwendung>_v<N>Kritisch
A3Keine verwaisten Dateien außerhalb der Liste im VerzeichnisWarnung
A4Jedes Bild hat eine Auflösung ≥ kurze Seite 720Warnung
A5Ankerstufen-Assets haben Kandidatenanzahl ≥ 2Warnung

Exit-Code: 0 bestanden / 2 kritische Punkte / 3 Verzeichnis nicht lesbar.


7. Abgrenzung

  • Schreibt kein Storyboard: Asset-Anforderungen kommen aus Storyboard und Liste, ändert selbst keinen Inhalt
  • Schreibt keine Video-Prompts: Das ist Aufgabe des vorgelagerten Prozesses, dieser Skill ergänzt nur Bild-Prompts
  • Generiert kein Video: Verarbeitet nur Standbilder
  • Ersetzt keine Beurteilung: Akzeptanzkriterien sind gegeben, aber „ob dieses Bild verwendet werden kann“, entscheidet letztlich der Mensch
  • Garantiert nicht, dass es beim ersten Mal richtig ist: Generierung ist probabilistisch, dieser Skill garantiert „Kandidaten, Abnahme, Versionierung“

8. Referenzen

DateiWann lesen
references/production.mdBei Reihenfolge planen, Stufe zuweisen, Kandidaten generieren, Ablegen und Zurückschreiben
references/acceptance.mdBei Abnahme, Seite-an-Seite-Vergleich, Zurückweisen und Neuanfertigung
references/prompt-fixups.mdWenn die Liste keinen Prompt enthält oder ein Bild wiederholt nicht stimmt
references/ai-generation.mdBei KI-Generierung: Parameter, Schreibweise, Batch, Fehlerbehandlung
assets/asset-production-sheet.mdVor Arbeitsbeginn Arbeitsauftrag erstellen, bei Lieferung Status zurückschreiben
assets/batch-tasks-example.jsonBeispiel-Aufgabenliste für Batch-Generierung
scripts/kie_gen.pySenden, Abfragen, Herunterladen, Benennen und Ablegen
scripts/check_assets.pyVor der Lieferung einmal ausführen

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

lhaovo/short-video-skills

一条短视频从策划到发布的流程总控:建制作目录、依次走「剧本分镜 → 提示词 → 生成 → 交付 → 发布」五段、每段设门禁、记录流程状态、支持跨会话续做。当用户要开一条新片子、问「下一步做什么」、想接着做某条没做完的片子、要把分镜变成提示词、要整理素材与成片、要准备发布包时使用。本技能只规定流程、目录与产物标准,不重复各环节的写作规范。

lhaovo/short-video-skills

把已过 G2 的生成清单落成真实视频片段——按段建 KIE Seedance 任务、轮询、下载、媒体体检、抽帧质检、听声核台词,并把每段的状态与请求指纹写进生成台账。三种模式互斥(文生 / 首帧图生 / 首尾帧图生)。旁白由模型直接念,台词照稿写进提示词,不走独立 TTS 配音。当用户提到视频生成、出片段、跑 Seedance、首帧图生、首尾帧、原生音频、台词念错、任务查询、片段下载、生成失败重试时使用。只管「把已定的画面和台词变成成段素材」,不重新设计视觉、不改台词文本、不做字幕、不做剪辑。

lhaovo/short-video-skills

把「我想拍点什么」变成一条想清楚的片子——先定主题(出 5 个候选、标明类型、给出推荐与淘汰理由),再定结构与分段剧本,最后切成镜头级内容分镜。支持两种入口:一句话主题(需要发散选题)与已有拆解剧本(跳过选题,先问复刻需求与复刻强度再判定改写)。当用户提到选题、定主题、短视频策划、写剧本、写大纲、分镜、镜头脚本、不知道拍什么、内容怎么排、科普干货、剧情软广、钩子怎么写、复刻别人的剧本时使用。只管内容层(讲什么、怎么讲),不碰执行层;内置的内容红线只防明显自伤,不替代合规审查。

lhaovo/short-video-skills

把已定稿的分镜表翻成可直接执行的两份清单——资产清单(要准备哪些图、每张图的图像提示词)与生成清单(每段视频的时长、模式、素材引用与提示词)。覆盖画面化、资产编号、切分生成单元、Seedance 视频提示词写法、首帧方案、一致性与失败诊断。当用户说「把分镜变成提示词」「写视频提示词」「这条片子要哪些图」「生成清单」「某个镜头生成不出来」时使用。只做翻译与清单,不重新编排内容,不直接出图出片。

Verwandte Skills