Communitygithub.com

lhaovo/short-video-skills

Übersetzt ein fertiggestelltes Storyboard in zwei direkt ausführbare Listen – eine Asset-Liste (welche Bilder benötigt werden, inkl. Bild-Prompts) und eine Generierungsliste (Dauer, Modus, Materialreferenzen und Prompts für jedes Videosegment).

Was ist short-video-skills?

Dieses Skill ist ein professioneller Übersetzer zwischen einem Storyboard und ausführbaren Video-Generierungslisten. Es nimmt ein fertiggestelltes Storyboard (mit Zeitstempeln, Aktionen, Dialog und Anmerkungen) und erstellt zwei strukturierte Markdown-Dateien: eine **Asset-Liste**, die identifiziert, welche Bilder (Produkte, Szenen, Charaktere, Requisiten) benötigt werden, zusammen mit ihren Bild-Prompts, und eine **Generierungsliste**, die jedes Videosegment in einen kompletten Video-Prompt mit Dauer, Kamerabewegung, Materialreferenzen und Voice-Over-Text zerlegt. Es folgt strengen Regeln: Assets müssen zuerst nummeriert werden, jeder Videoprompt beschreibt einen einzigen kontinuierlichen Moment, Ankerphrasen werden wörtlich wiederverwendet, und Echtaufnahmen oder offizielle Assets haben Vorrang vor KI-generierten für kritische Produktshots. Das Skill validiert die Eingabe, visualisiert abstrakte Beschreibungen in konkrete visuelle Felder (Subjekt, Zustand, Aktion, Umgebung, Licht, Einstellungsgröße, Kamerawinkel, Kamerabewegung), teilt lange Segmente basierend auf der Länge des Voice-Overs auf und erstellt eine `No subtitles`-Anweisung. Es ist für die Zusammenarbeit mit KI-Videogeneratoren wie Seedance konzipiert, führt jedoch keine Bild- oder Videogenerierung durch – es produziert nur Listen und Prompts.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Video-Prompt-Werkbank

Ein Storyboard, das für Menschen gemacht ist, und eine Generierungsliste, die funktioniert – dazwischen liegt eine Übersetzung. Dieses Skill ist diese Übersetzung.

Es erzeugt zwei Dateien: Asset-Liste (welche Bilder werden benötigt) und Generierungsliste (wie jedes Segment generiert wird).

Es wählt kein neues Thema aus, ändert keine Drehbuchstruktur und bewertet keinen Inhalt – das ist die Aufgabe vorgelagerter Prozesse. Es generiert auch keine Bilder oder Videos direkt, sondern formuliert nur Dinge so, dass sie sofort ausgeführt werden können.


1. Fünf eiserne Regeln

Ganz vorne, weil jede Regel eine bestimmte Art von Fehlschlag adressiert.

  1. Assets zuerst. Keine Nummerierung, kein Prompt. Wenn dasselbe Produkt in Segment 3 zu einem anderen wird, liegt die Ursache fast immer darin, dass kein Asset angelegt wurde.
  2. Ein Videoprompt beschreibt nur einen kontinuierlichen Moment. Wechselt die Szene, teile auf. Lasse das Modell nicht selbst überblenden.
  3. Verwende Anchor Phrases für das Subjekt wortwörtlich. Ein Synonym zu verwenden, ist, als würde man die Person wechseln.
  4. Bestimme zuerst die Quelle des Produkts, dann schreibe den Prompt. Wenn es Echtaufnahmen oder offizielles Material gibt, verwende es. Wenn nicht, kann KI generiert werden, aber Geometrie, Druck und Logo müssen festgeschrieben werden. Für Aufnahmen mit Parameter- oder Wirkungsangaben dürfen nur Echtaufnahmen oder offizielles Material verwendet werden.
  5. Videoprompts werden positiv formuliert, Bildprompts verwenden den Negativ-Abschnitt. Diese beiden Syntaxen sind nicht austauschbar, siehe Abschnitt 8 in references/prompt-syntax.md.

2. Eingabe

Erforderlich

ElementWoherWas tun, wenn fehlend
StoryboardAbschnitt 4 des Konzepts, kurze 6-Spalten-Tabelle und detaillierte Shot-BeschreibungenFehlen Shot-Nummern, Zeitangaben oder wichtige Übergangsfelder, ablehnen, nicht raten
Produktname und SpezifikationenAbschnitt 1 des KonzeptsWenn nicht vorhanden, nachfragen. Wenn nicht zu erfragen, als "Bestätigung ausstehend" markieren
ZielmodellVom Benutzer angegeben, Standard: SeedanceStandard verwenden, nicht nachfragen

Sechs Spalten der Kurztabelle: Shot-Nr. / Dauer (s) / Beschreibung des Shots / Voice-Over / Bildschirmtext / Funktion des Shots. Details pro Shot: Zuschauerwahrnehmung / Voraussetzungen / Wichtige sichtbare Fakten / Zeitliche Absicht.

Optional

  • Seitenverhältnis (Standard 9:16), Videoauflösung (Standard 480p, konsistent mit dem Generierungsende)
  • Min./Max. Dauer pro Segment (Standard 5–10 Sekunden)
  • Audio erforderlich (Muss eingeschaltet sein. Voice-Over wird direkt vom Modell gesprochen; ausschalten = kein Ton. Nur ausschalten, wenn es sich um eine bestätigte leere Einstellung handelt.)

Zwei Eingabemodi

ModusVerarbeitung
StandardAbschnitt 4 des Konzepts lesen, Felder vollständig, direkt zu Schritt 3
LockerNur eine externe Markdown-Tabelle vorhanden, zuerst parsen, dem Benutzer zur Überprüfung anzeigen, fehlende Felder markieren

Bei lockerem Parsen explizit darauf hinweisen: "Dies ist ein degradiertes Parsing, bitte überprüfen." Stille Fehler sind schlimmer als gemeldete Fehler.


3. Acht Schritte

1 Tabelle lesen → 2 Visualisieren → 3 Assets extrahieren → 4 Segmentieren → 5 Erstes Frame → 6 Prompt formen → 7 Liste ausgeben → 8 Selbstprüfung

Schritt 1 · Tabelle lesen

Kurztabelle und Detailbeschreibungen pro Shot-Nr. zuordnen, dabei Produktinformationen merken. Dieser Schritt macht nur eine Prüfung, keine Kreation. Wenn das Planungs-Skill installiert ist, führe scripts/check_plan.py --plan <Pfad zum Konzept> aus; bei eigenständiger Installation pro Shot anhand der Eingabefeldliste prüfen. Bei alten 5-Spalten-Tabellen ohne Übergangsfelder zurückgehen und ergänzen.

Drei Prüfungen:

  • Shot-Nummern fortlaufend, Dauer positiv
  • Dauer pro Shot 2–6 Sekunden (Grenzwerte markieren)
  • Storyboard enthält eine "Beschreibung des Shots", nicht nur Voice-Over

Schritt 2 · Visualisieren

Dies ist der einzige kreative Schritt im gesamten Skill und der am leichtesten übersprungene.

Das Storyboard liefert eine inhaltliche Beschreibung ("Erklären, warum es außen heiß und innen kalt ist"), der Prompt benötigt ein Bild. Jedes Segment muss folgende Felder ergänzen:

FeldWas wird gefragtBeispiel
SubjektWas ist im BildWeiße Keramik-Lunchbox, geöffneter Deckel
ZustandAktueller Zustand des SubjektsDeckel offen, Lunchbox auf dem Tisch
AktionWer tut was, eine AktionLöffel wird in die Mitte gesteckt
UmgebungWo, was ist im HintergrundSchreibtisch, Mikrowelle im Hintergrund
LichtWoher kommt das Licht, welche FarbtemperaturWarmweißes Licht von oben, Fensterlicht von links
EinstellungsgrößeWie groß ist der BildausschnittNahaufnahme
Kameraposition/-winkelWo ist die Kamera relativ zum SubjektAuf Tischhöhe, 30 Grad von vorne-seitlich
KamerabewegungWie bewegt sie sich (nur eine auswählen)Stativ, langsame Heranfahrt

Kein Feld darf fehlen. Jede Segmentliste muss Subjekt, Zustand, Aktion, Umgebung, Licht, Einstellungsgröße, Kameraposition/-winkel und Kamerabewegung explizit aufführen; bei klarer Nichtanwendbarkeit den Grund angeben. Bei fehlenden Feldern zuerst selbst ergänzen; wenn nicht möglich, den Benutzer eine Frage fragen – lasse keine Lücken in den Prompt, denn das Modell wird sie selbst füllen.

Die im Storyboard genannten "wichtigen sichtbaren Fakten" und "Voraussetzungen" müssen in der Generierungsliste mit einem Zielort markiert werden: entweder als sichtbarer Zustand im ersten Frame oder als Aktion, die im Videosegment stattfindet. Prozesshafte Aktionen können nicht verlangen, dass ein einzelnes erstes Frame gleichzeitig Vorher, Während und Nachher darstellt.

Schritt 3 · Assets extrahieren

Gemäß references/assets.md vier Aufgaben: Nummerieren, Aufteilen, Quelle bestimmen, Gesamttabelle ausgeben.

  • Nummernprefixe: PR Produkt / SC Szene / CH Person / SP Requisite
  • Kriterium für Aufnahme in die Liste: Wird von zwei oder mehr Segmenten referenziert, oder erfordert Konsistenz der Identität
  • Drei Quellenstufen: Echtaufnahme / Offizielles Material (wenn vorhanden), KI-generiert (wenn kein Echtmaterial, Geometrie und Druck festlegen), Nachzuliefern

Schritt 4 · Segmentieren

Schneide die Schnittmenge aus drei Beschränkungen:

  1. Segmentdauer ≥ Wortanzahl des Voice-Overs in diesem Segment ÷ 4 Wörter/s (Das Modell spricht Chinesisch mit etwa 4–5 Zeichen/s, rechne mit der niedrigeren Zahl)
  2. Einzelnes Segment 5–10 Sekunden (Modellobergrenze siehe prompt-syntax.md)
  3. Eine Aktion pro Segment

Regel 1 verwendet 4 statt 6,5, und das hat einen Grund: Das Modell spricht nicht schneller – es lässt einfach die zweite Hälfte des Satzes weg. Segmente, die mit optimistischer Sprechgeschwindigkeit geschnitten werden, produzieren fehlende Sätze, und das ist viel schwieriger zu beheben, als ein weiteres Segment zu erstellen.

Voice-Over pro Segment maximal 36 Zeichen. Überschreitung führt zur Aufteilung; drücke nicht die Wortanzahl, um es in ein Segment zu quetschen.

Für extrem lange Shots mit Verlängerung + Übergangs-Frame verwenden: Schreibe klar den Bildzustand des Endframes des vorherigen Segments auf, nicht "übernimmt vom vorherigen Segment".

Schritt 5 · Erstes Frame

Nicht jedes Segment benötigt ein erstes Frame. Entscheide anhand der Empfindlichkeit:

Erstes Frame erforderlichDirekt Text-zu-Video möglich
Produkt-Nahaufnahme, Handaktion, Logo oder TextLeere Einstellung, Atmosphäre, Überblendung, reiner Lichteffekt

Bildprompts für das erste Frame (siehe assets.md Abschnitt 4, sieben Module), Prinzip: "Reales Produkt als Basis + KI-generierte Szene".

Schritt 6 · Prompt formen

Schreibe gemäß der sechs Blöcke in references/prompt-syntax.md:

[Stil & Seitenverhältnis] → [Materialreferenz] → [Subjekt fixieren] → [Zeitachse] → [Voice-Over & Ton] → [Qualitätseinschränkungen]

Vier Dinge, die unbedingt enthalten sein müssen: Einzelne Kamerabewegung, Motion:-Liste, Originaltext des Voice-Overs (genau wie im Skript, kein Wort ändern), No subtitles.

Der fünfte Block trägt jetzt das Voice-Over selbst – es gibt keine separate Sprachaufnahme mehr; der Text wird in diesem Block an das Modell übergeben. Die Voice-Over-Spalte des Storyboards muss wortwörtlich übernommen werden, ohne Tonangaben, ohne Klammerzusätze, ohne ein Wort zu ändern. Änderst du ein Wort, passt der Untertitel nicht mehr zum Ton.

Schritt 7 · Liste ausgeben

Zwei Vorlagen ausfüllen und in das vom übergeordneten System vorgegebene Verzeichnis ablegen (Standard: 02-Asset-Liste.md, 03-Generierungsliste.md).

Schritt 8 · Selbstprüfung

Sechs Prüfungen durchführen; wenn ein Skript vorhanden ist, ausführen:

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

Rückgabecode: 0 bestanden / 2 schwerwiegendes Problem / 3 Datei kann nicht gelesen werden.


4. Zwei Ausgabeprodukte

Asset-Liste (02-Asset-Liste.md)

Tabelle mit sechs Spalten, gefolgt von den Bild-Prompts für jedes Asset:

NummerTypVerwendungQuelleReferenziert von SegmentenStatus
  • Typ: Produkt-Hauptkörper / Produktdetail / Szene / Person / Requisite
  • Quelle: Echtaufnahme oder offizielles Material / KI-generiert / Nachzuliefern
  • Status: Vorhanden / Bild muss erstellt werden / Muss aufgenommen werden

Generierungsliste (03-Generierungsliste.md)

Eine Übersichtstabelle + vollständige Prompts pro Segment (Prompts sind zu lang für die Tabelle):

| Segment-Nr. | Shot-Nr. | Dauer | Modus | Referenzmaterial | Erstes Frame | Nachbearbeitung | Anzahl Kandidaten | Voraussetzungen / Wichtige Fakten | |---|---:|---:|---|---|---:|---:|---|

  • Modus: Erstes/Letztes Frame / Referenzbild / Text-zu-Video
  • Erstes Frame: S01_f01 oder "Keines"
  • Anzahl Kandidaten: Empfohlen 2–4

Die drei Modi sind für nachgelagerte Prozesse zur Auswahl; nicht alle Modelle unterstützen alle Modi. KIE Seedance unterstützt derzeit nur Text-zu-Video, Erstes Frame und Erstes/Letztes Frame; der Referenzbild-Modus muss auf Erstes Frame degradiert werden – die Degradierungsregeln befinden sich in short-video-generate. Dieses Skill schreibt die Modi einfach auf, ohne sie an das Modell anzupassen.

Unterhalb der Tabelle werden für jedes Segment im Format ### S01 · Shot 1–2 | 8s | Erste/Letzte Frames die acht visuellen Felder und der vollständige Prompt ausgegeben, einschließlich Quelle des ersten Frames, Voraussetzungen und Nachbearbeitung.

Vorlagen in assets/.


5. Neun Selbstprüfungen

#PrüfungWas tun bei Fehler
1Jedes Segment hat eine Shot-Nr., keine zusätzlichen SegmenteZu Schritt 4 zurück und neu segmentieren
2Gesamtdauer aller Segmente ≤ 1s Abweichung von der Storyboard-GesamtdauerSegmentdauer anpassen, Storyboard nicht ändern
3In der Liste referenzierte Asset-Nummern sind in der Asset-Liste definiertDefinition ergänzen oder Referenz löschen
4Hauptmodus eindeutig: Erste/Letzte Frames und Referenzbild nicht gemischtIm gesamten Video vereinheitlichen
5Quelle für Produktshots ist angegeben; Shots mit Behauptungen verwenden Echtaufnahmen oder offizielles MaterialZu Schritt 3 zurück und Quelle ändern
6Jeder Videoprompt enthält: Einzelne Kamerabewegung, Motion:, No subtitlesPro Prompt ergänzen
7Bei Segmenten mit Voice-Over: Voice-Over-Block stimmt wortwörtlich mit Storyboard-Voice-Over übereinSegment für Segment vergleichen; selbst ein Wortfehler muss korrigiert werden
8Alle visuellen Felder vollständigF7 prüft nur, ob die Tabelle der visuellen Felder im Segment existiert, vollständig ist und Werte enthält, nicht aus Prosastichwörtern zu schließen; Subjekt, Zustand, Aktion, Umgebung, Licht, Einstellungsgröße, Kameraposition/-winkel, Kamerabewegung, Voraussetzungen/sichtbare Fakten müssen alle ausgefüllt sein; bei Nichtanwendbarkeit Grund angeben
9Abhängigkeiten übertragenVoraussetzungen und wichtige sichtbare Fakten aus dem Storyboard wurden auf das erste Frame oder die Aktion im Segment abgebildet

Prüfer F8 bestätigt nur, dass die Übersichtstabelle pro Segment das Feld "Voraussetzungen / Wichtige Fakten" ausgefüllt hat, nicht, dass der Inhalt tatsächlich im ersten Frame oder der Segmentaktion dargestellt wird; G2 benötigt weiterhin manuelle Prüfung pro Segment.

Präzise Formulierung für Regel 4: Erste/Letzte Frames und Referenzbild schließen sich gegenseitig aus; Text-zu-Video nur für Segmente ohne Subjekt. Werden zwei Hauptmodi für Produktshots gemischt, passen die Ergebnisse nicht zusammen.

Regel 7 ist neu und wird am leichtesten übersehen. Die Methode ist einfach, aber effektiv: Lege die Voice-Over-Spalte des Storyboards und den Voice-Over-Block der Liste nebeneinander und vergleiche sie wortwörtlich. Ein geändertes Satzzeichen, ein ersetztes Synonym – der Untertitel müsste mitgeändert werden, und Untertitel werden erst in S4 erstellt – dann ist es zu spät.

Überprüfe nebenbei zwei Dinge: Überschreitet das Voice-Over pro Segment 36 Zeichen (dann wird das Modell es auslassen)? Sind Tonangaben wie (lacht) oder [aufgeregt] eingeschlichen (das Modell spricht sie mit)?


6. Grenzen

  • Inhalte werden nicht neu angeordnet: Shot-Nummern, Reihenfolge, Dauer kommen von vorgelagerten Prozessen. Dieses Skill ändert die Struktur nicht.
  • Inhalte werden nicht bewertet: Themenauswahl, Hooks, Struktur – das liegt bei vorgelagerten Prozessen.
  • Keine direkte Generierung: Es werden nur Listen und Prompts ausgegeben. Bildgenerierung wird an short-video-assets übergeben, Videogenerierung an short-video-generate.
  • Kein einmaliger Erfolg garantiert: Generierung ist probabilistisch. Dieses Skill stellt nur sicher, dass der "eine Durchlauf, der sich lohnt" eine höhere Wahrscheinlichkeit hat.
  • Keine Parameterübertragung: Modellparameter ändern sich. Dieses Skill liefert Prinzipien und allgemeine Formulierungen; spezifische Werte basieren auf der offiziellen Dokumentation.

7. Referenzen

DateiWann lesen
references/prompt-syntax.mdBeim Schreiben von Videoprompts; Anpassen der Kamerabewegung, Zeitachse, Materialreferenzen
references/assets.mdBeim Extrahieren von Assets, Schreiben von Asset-Bild- und Erstes-Frame-Prompts
references/consistency.mdBei Inkonsistenzen zwischen Segmenten, Produktverformung, falschem Gesicht
references/troubleshooting.mdWenn ein Segment wiederholt nicht generiert werden kann

Vorlagen: assets/asset-list-template.md, assets/gen-list-template.md Validierung: scripts/check_gen_list.py

Individual skills in this repo

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

lhaovo/short-video-skills

为视频生成准备可用的图——把资产清单变成能直接喂给图生视频的素材:排生产顺序、定资产级别、出候选图、做一致性验收、按编号落盘、回写清单状态。支持三种来源:实拍、AI 生成、官方素材,不强制实拍。当用户说「准备素材」「出资产图」「首帧图」「角色三视图」「产品图跑一下」「资产对不上」「这条要哪些图」时使用。只管把图做出来并验收,不写分镜,不直接生成视频。

lhaovo/short-video-skills

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

lhaovo/short-video-skills

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

lhaovo/short-video-skills

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

Verwandte Skills