Communitygithub.com

Akira-TL/akira-video-skills

Überprüft KI-generierte Personen-/Szenen-Assets oder Shot-Ergebnisse und entscheidet über Übernahme, Prompt-Anpassung, Neugenerierung oder spätere Nachbearbeitung. Wird verwendet, wenn generierte Ergebnisse ins Projekt zurückfließen und Identität/Struktur/Kontinuität/Bewegung/Kamera/Produkt-Echtheit geprüft oder Auswahl getroffen werden muss.

Was ist akira-video-skills?

Diese Skill ist speziell für KI-Agenten konzipiert, die in der Videoproduktion mit generativen Modellen arbeiten. Sie stellt sicher, dass jedes generierte Asset oder jeder generierte Shot systematisch auf Basis objektiver Kriterien bewertet wird, bevor es in den weiteren Produktionsworkflow übernommen wird. Die Skill unterstützt Plattformen wie Claude Code, Cursor und Codex, die mit Projektstrukturen wie `SHOT.md`, langfristigen Prompts und Produktdefinitionen arbeiten. Sie enthält ein Python‑Skript zur schnellen Medienanalyse (`probe`, `sample`, `split-2x2`), referenziert Prüflisten aus `TAKE-QA.md` und Entscheidungsbäume aus `FAILURE-MODES.md` und `REPAIR-DECISIONS.md`. Der Workflow zwingt zu einer fundierten Entscheidung zwischen Übernahme, Anpassung, Nachbearbeitung oder Neugenerierung und verlangt, dass jeder Fehler klar kategorisiert wird, bevor Maßnahmen ergriffen werden. Die Implementierung vermeidet unnötige Doppelarbeit wie das Erstellen separater `final.mp4`-Kopien und ermutigt zur minimalen, aber präzisen Dokumentation der getroffenen Wahl im `SHOT.md`.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Akira-TL/akira-video-skills/tree/HEAD/skills/video/video-review

In Ihrer bevorzugten KI fragen

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

Dokumentation

Video Review

Diese Skill ist für die Entscheidung zuständig, ob ein generiertes Ergebnis in die aktuelle Produktionsroute aufgenommen werden kann. Sie senkt die ursprünglichen Produktionsanforderungen nicht, nur weil das Asset bereits generiert wurde, und überschreibt keine übergeordneten Fakten zugunsten des generierten Ergebnisses.

1. Prüfen des tatsächlichen Generierungsergebnisses

Die Qualitätskontrolle muss auf den tatsächlich zurückgelieferten Bildern, Videos oder Tönen basieren – nicht auf Prompts, Dateinamen oder der Annahme „das Modell sollte das können“.

Wenn der aktuelle Executor das vollständige Artifact direkt ansehen/abspielen kann, wird das gesamte Artifact geprüft. Können nur einzelne Frames, Screenshots oder kein korrekter Ton überprüft werden, muss klar angegeben werden, welche Dimensionen noch nicht abgenommen wurden. Nicht beobachtete Inhalte dürfen nicht als bestanden deklariert werden.

Wenn Medien-Metadaten, SHA-256, gleichmäßige Stichproben zur Lokalisierung von Problem-Frames oder das mechanische Aufteilen eines strengen 2×2‑Vierfachbilds erforderlich sind, soll das mitgelieferte Skript scripts/media_review.py bevorzugt verwendet werden:

  • probe – liest echte Medien-Eigenschaften aus
  • sample – schreibt nur Video-Hilfsframes in das temporäre Verzeichnis .tmp/review/ des aktuellen Projekts
  • split-2x2 – teilt ein 1:1‑Bild mechanisch in vier Quadranten
  • cleanup – bereinigt das temporäre Review-Verzeichnis

Sampling-Frames, Split-Bilder oder ein Manifest können niemals die vollständige Wiedergabe, Audio-, Lippen- oder Personen-/Szenen-Inhaltsprüfung ersetzen. Ein erfolgreicher mechanischer 2×2‑Split bedeutet nicht, dass die strengen Vierfachbild-Semantik bestanden wurde.

Eine Video-Review darf sich nicht auf das beste Einzelbild stützen; sie muss mindestens den Beginn des Shots, den Hauptbewegungsablauf und den Endzustand abdecken sowie Bewegungs-/Audio-Kontinuität überprüfen.

2. Feste Prüfgrundlage

Zunächst die für das Ergebnis gültigen offiziellen Quellen auslesen:

  • Wiederverwendete Assets: entsprechende Langzeitprompts, Charakter-/Szenen-/Produktdefinitionen sowie erforderliche übergeordnete Fakten.
  • Shot-Generierungsergebnisse: SHOT.md, aktueller Prompt, referenzierte wiederverwendete Assets und Kontinuität zu benachbarten Shots.
  • Werbe-Produkte: gleichzeitig die Produkt-Fakten und Marken-Restriktionen aus video-advertising laden; fehlt diese Fähigkeit, darf das Produkt-Gate nicht als abgeschlossen deklariert werden, sondern das Ergebnis wird an akira-video zurückgegeben, um das optionale Package zu vervollständigen.

Ein einmaliges Generierungspaket dient nur zur Lokalisierung des aktuellen Inputs und ist keine höherpriore Faktenquelle.

Für eine detaillierte Qualitätsprüfung des generierten Ergebnisses / des Assets ist references/TAKE-QA.md zu lesen. Bei mehreren zurückgegebenen Bild‑, Audio‑ oder Video-Kandidaten wird zusätzlich references/CANDIDATE-SELECTION.md gelesen, zuerst harte Fehler (Identität/Produkt/Raum/Handlung) ausgeschlossen, dann nach Produktionstauglichkeit und Ästhetik verglichen. Bei offensichtlich fehlgeschlagenen Ergebnissen wird zuerst der Fehlertyp gemäß references/FAILURE-MODES.md bestimmt, anschließend nach references/REPAIR-DECISIONS.md die Option „Übernehmen“, „Nachbearbeitung“, „Neugenerierung“ oder „Überarbeitung des vorgelagerten Schritts“ gewählt. Vor der Neugenerierung wird die eine Hauptvariable festgelegt, die in dieser Runde geändert wird.

3. Prüfungsdimensionen

Nur die für das aktuelle Objekt relevanten Dimensionen prüfen:

  • Stabilität von Identität, Kleidung, Material, Struktur und Zustand;
  • Stimmigkeit von Szenenraum und Schlüsselpositionen;
  • Erfüllung des Shot-Ziels in Bewegung, Performance, Kamera und Timing;
  • Kontinuität In/Out – nahtlose Übergänge zu benachbarten Shots möglich?;
  • Produkt, Logo, Text und industrielle Struktur – stimmen mit der Faktenquelle überein?;
  • Dialog, Lippenbewegung, Ton und Umgebungsgeräusche – erreichen das geforderte Niveau?;
  • Gibt es merkliche Drift, die in späteren Shots noch verstärkt würde?

Nicht ein einzelnes hübsches Bild durch eine vollständige Video-Review ersetzen.

4. Ergebnis

Bevorzugt eine der folgenden eindeutigen Entscheidungen treffen:

  • Übernehmen: Das Ergebnis kann in die aktuelle Produktion einfließen.
  • Übernehmen und Nachfolger anpassen: Es gibt nicht-kritische Abweichungen, aber das tatsächliche Bild wird akzeptiert, und der nächste Shot setzt auf dem sichtbaren Zustand auf.
  • Nachbearbeitung: Das Motiv ist korrekt generiert, das Problem eignet sich besser für deterministischen Schnitt, Compositing, Untertitel, Logo, Lautstärke oder andere Post‑Processing-Schritte.
  • Neugenerierung: Die Shot-/Asset-Definition ist korrekt, aber das aktuelle Generierungsergebnis ist fehlgeschlagen.
  • Definition oder Prompt überarbeiten: Der Fehler liegt in der SHOT.md, im Langzeit-Asset oder im Prompt selbst, nicht in der zufälligen Ausführung.

5. Übernahme dokumentieren

Die Entscheidung für einen Shot wird nach references/TAKE-DECISION.md knapp gehalten: Festhalten des aktuellen Generierungsergebnisses, des tatsächlichen Ausgabestands, der akzeptierten Abweichungen und der noch nachzubearbeitenden Punkte. Es wird keine separate Datenbank angelegt.

Welches Generierungsergebnis für einen Shot übernommen wurde, wird bevorzugt im SHOT.md dieses Shots in einem kurzen „Current Take“-Feld oder einer gleichwertigen klaren Notiz festgehalten; es wird keine separate final.mp4 erstellt.

Ausgeschiedene Generierungsergebnisse dürfen für Vergleiche aufbewahrt werden. Falls das Projekt keine langfristige Aufbewahrung fehlgeschlagener Ausgaben benötigt, können sie gemäß der Speicherstrategie des Benutzers gelöscht werden; es darf jedoch kein einzigartiges, noch nicht archiviertes Generierungsergebnis versehentlich gelöscht werden.

Abschlusskriterien

Jedes geprüfte Ergebnis hat eine klare Grundlage und eine klare Vorgehensrichtung; übernommene Ergebnisse können weiter zum nächsten Shot oder zur gesamten Postproduktion übergehen, und bei Neugenerierung ist bereits bekannt, was beim nächsten Mal geändert wird.

Individual skills in this repo

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

Akira-TL/akira-video-skills

为 Runway 当前视频模型编译和检查生成提示词;当 video-generation 需要使用 Runway(当前主线 Gen-4.5)的 Text to Video 或 Image to Video,并需要 Runway 专用动作、摄影和时序表达时使用。

Akira-TL/akira-video-skills

为 ByteDance / BytePlus Seedance 当前视频模型编译和检查提示词;当 video-generation 需要使用 Seedance 2.5 的参考素材、时间线、同步声音、视频编辑、延长或多镜头能力时使用。

Akira-TL/akira-video-skills

为 Google Veo 视频生成编译和检查提示词;当 video-generation 需要使用 Veo 的 Text to Video、Image to Video、首尾帧、参考元素或同步声音能力时使用,并先核验具体 Google 使用入口与 model 的当前支持范围。

Akira-TL/akira-video-skills

进入并持续推进一个 AI 视频制作项目;读取或建立 VIDEO.md,根据当前视频脚本、复用素材、镜头、生成结果和整片后期状态,按需路由到 canonical 视频专业 Skill,而不是把所有制作规则塞进一个总提示词。

Akira-TL/akira-video-skills

为品牌短片、产品植入剧情、广告或比赛作品建立产品事实与广告边界;当视频需要准确表达某个具体产品的官方功能、参数、结构、使用方式、品牌素材或产品与剧情关系时使用。

Akira-TL/akira-video-skills

设计并维护 AI 视频中跨镜头复用的角色声音、音色参考、对白声音要求与整片声音关系;当同一角色需要跨镜头保持声音一致,或需要规划语音参考、环境声、音效、音乐与画面的职责边界时使用。

Akira-TL/akira-video-skills

设计 AI 视频中的角色与场景视觉方案;当脚本只说明“需要一个什么样的人/场景”,但还没有形成可稳定生成的外形、服装、材质、色彩、空间、光线和视觉识别系统时使用。

Akira-TL/akira-video-skills

组织整片级剪辑、合成、全片声音和最终成片;当多个已采用镜头需要进入 Premiere Pro、After Effects、DaVinci Resolve 等后期工程,或需要整片字幕、Logo、音乐、混音、比例版本和最终导出时使用。

Akira-TL/akira-video-skills

为 AI 图片或视频生成准备可直接使用的提示词与一次性生成包,并在用户把生成结果带回项目后归档;当需要从正式视频脚本、复用素材和 SHOT.md 编译生成内容、选择参考素材、约定返回文件名或清理临时包时使用。

Akira-TL/akira-video-skills

规划、创建、整理和维护多个镜头会重复使用的视频复用素材;当需要人物/场景/道具/产品提示词、参考图、官方素材、身份与状态参考或其他可重复引用内容时使用。

Akira-TL/akira-video-skills

把小说、章节、故事梗概、品牌 brief 或其他上游内容转换成当前视频自己的脚本层;当需要编写或修订 SCRIPT.md、视频人物表演定义、场景定义、对白或镜头总表时使用。

Akira-TL/akira-video-skills

把 SHOTS.md 中的镜头总览展开成可直接制作的单镜头定义;当需要创建或修改 video/shots/<shot-id>/SHOT.md、镜头连续性、摄影、动作、表演、声音或镜头专属生产约束时使用。

Verwandte Skills