Communitygithub.com

Kurzvideo-Pipeline

Erstellen, rendern, prüfen, mischen und verpacken Sie ein vertikales 1080x1920 Kurzvideo (YouTube Shorts, Reels, TikTok) aus Quellmaterial und Voice-Over mit der Clip-basierten Pipeline (edl.json, build.py, check.py, sound/mix.py). Verwenden Sie dies immer, wenn die Aufgabe darin besteht, ein solches Video zu produzieren, zu korrigieren oder zu überprüfen, einen Sub-Agenten-Redakteur einzuweisen oder zu erklären, warum check.py fehlschlägt.

Was ist Kurzvideo-Pipeline?

Die Kurzvideo-Pipeline ist ein modulares, agentenbasiertes Workflow-System zur Produktion von vertikalen 1080x1920 Kurzvideos (geeignet für YouTube Shorts, Instagram Reels und TikTok). Sie besteht aus einer Reihe von Skripten und Konfigurationsdateien, die den gesamten Erstellungsprozess abdecken: von der Skripterstellung und Sprachaufnahme über die Auswahl und Verarbeitung von Videoclips bis hin zum Rendering, der Qualitätsprüfung und der finalen Audiomischung. Die Pipeline wird über eine Editierliste (edl.json) gesteuert und erzeugt ein Video mit bewegten Clips, Wort-Untertiteln, einem Haken-Plate, einem Heldenkreis, einem Cover und einer Soundmischung bei -14 LUFS. Die Konfiguration erfolgt kanalspezifisch in einer CHANNEL.md-Datei. Ein Check-Skript (check.py) validiert automatisierbar die Einhaltung von Qualitätsstandards wie Safe-Zone-Einhaltung, Ruckelfreiheit und korrekte Untertitel. Die Pipeline unterstützt die Zusammenarbeit mit Sub-Agenten über ein BRIEF.md-Dokument und enthält eine Bibliothek mit bewährten Praktiken (lessons.md). Sie ist für Orchestratoren wie Claude Code, Cursor oder Codex konzipiert und erfordert ein vorbereitetes Projektverzeichnis sowie installierte Abhängigkeiten.

Funktioniert mit~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/ilyamelnichenkov/youtube-shorts/tree/HEAD/skills/shorts-pipeline

In Ihrer bevorzugten KI fragen

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

Dokumentation

Kurzvideo-Pipeline (themenneutral)

Eine Edit-Liste (<short>/edl.json) plus ein Voice-Over ergibt ein fertiges Video: bewegte Clips in einem thematischen Foto-"Fenster", Wort- Untertitel, ein Haken-Plate, ein Heldenkreis, ein Cover, eine SFX-Cue-Liste und schließlich eine Audiomischung bei -14 LUFS. Alles, was kanalspezifisch ist (Thema, Sprachen, Zielgruppe, Inhaltsregeln, Look, Stimme, Credits, Veröffentlichungsplan), befindet sich in der CHANNEL.md des Projekts. Lesen Sie sie zuerst und befolgen Sie sie vor den unten stehenden Standardwerten. Wenn sie fehlt oder leere Abschnitte enthält, fragen Sie den Besitzer (oder kopieren Sie engine/templates/CHANNEL.md und füllen Sie sie gemeinsam aus), bevor Sie etwas produzieren. Verwandte Fähigkeiten: shorts-script-voice (Thema, Skript, Stimme) und shorts-packaging (fertige Dateien, Upload-Texte).

Vor allem anderen

  1. Kit-Skripte (setup.sh, shorts-init.sh, doctor.sh, install-codex.sh) befinden sich im scripts/-Ordner des Kits: dem Plugin-Ordner oder $SHORTS_HOME/kit/scripts/ (setup.sh und install-codex.sh behalten dort eine Kopie).
  2. Arbeiten Sie in einem Projektordner, der _pipeline/, _tools/, _fonts/, CHANNEL.md enthält (erstellen Sie einen mit scripts/shorts-init.sh <verz>). Jeder folgende Befehl wird vom Stammverzeichnis dieses Ordners aus ausgeführt.
  3. Führen Sie scripts/doctor.sh <projekt-verz> einmal pro Maschine aus. Es überprüft alle Abhängigkeiten (Systemprogramme, Python-Pakete, Modelle, freien Speicherplatz) und muss mit "Alles in Ordnung." enden. Wenn nicht: scripts/install-system-deps.sh für ffmpeg/Python/curl, scripts/setup.sh für den Rest. Die vollständige Liste finden Sie in DEPENDENCIES.md des Kits.
  4. SHORTS_HOME (Standard ~/.shorts-studio) enthält die Python-Venv und die Sprachmodelle. Exportieren Sie es, wenn Sie es woanders ablegen.
  5. Lesen Sie _pipeline/README.md (Engine-Referenz) und references/edl-notes.md, bevor Sie eine Edit-Liste schreiben.

Der Workflow (jeder Schritt hat seine eigene Überprüfung)

#SchrittBefehl / AusgabeÜberprüfung
1Thema + SkriptFähigkeit shorts-script-voiceEine Behauptung, Quellen angegeben, Besitzer einverstanden, wenn das Profil dies verlangt
2Stimme$SHORTS_HOME/venv/bin/python _tools/build_vo.py <short>/vo/beats.json, dann _tools/words.py <short>/voLesen Sie vo/words.json: jedes Wort richtig
3Filmmaterial_tools/grab.py <thema> '<url>' <start> <ende> --tag NAME (protokolliert _footage/SOURCES.md), oder Ihre eigenen AufnahmenKontaktbogen jedes Clips; Richtlinie aus CHANNEL.md
4Edit-ListeKopieren Sie references/edl-template.json, ändern Sie den Inhaltbuild.py <edl> --words zeigt Untertitel-Tokens
5Rendernpython3 _pipeline/build.py <short>/edl.json --theme <theme> (3-10 Min; 4K60 ist langsam)Kein Fehler; die Datei ist neuer als die edl
6Cover... build.py <edl> --cover"Safe-Zone-Verstöße: keine", lesbar bei 180 px Breite
7Überprüfenpython3 _pipeline/check.py <short>/<name>-<theme>-silent.mp4 <short>/edl.jsonGibt ALLE PRÜFUNGEN BESTANDEN aus; Sie haben jeden Kontaktbogen angesehen
8Ton$SHORTS_HOME/venv/bin/python _pipeline/sound/mix.py <short> --theme <theme> --music <name> --strict-14,0 +/-0,5 LUFS, wahrer Spitzenwert <= -1,0 dBTP, Worterkennungsfehler nahe 0
9VerpackenFähigkeit shorts-packagingDatei + Cover + Upload-Block in ready/

Kontaktbogen eines Quellclips: ffmpeg -ss <t> -i <datei> -t <d> -vf "fps=2,scale=320:-1,tile=7x4" -frames:v 1 out.png (PNG schreiben: JPEG-Ausgabe einiger Quellen schlägt fehl mit "non full-range YUV"). Schnittgrenzen: ffmpeg -i <datei> -vf "scale=320:180,select='gt(scene,0.25)',showinfo" -an -f null - 2>&1 | grep -o "pts_time:[0-9.]*". Themen: case-file (Aktenpapier), panel-heist (Comicseite), vice-dusk (Neon-Dämmerung), classic; das Profil wählt eines aus.

Wie ein gutes Kurzvideo aussieht (Standardeinstellungen; das Profil überschreibt sie)

  • 18-45 s, ein Argument vom Haken bis zum Höhepunkt, ein Schnitt alle 1,5-3 s, jede Einstellung bewegt sich, der Haken-Plate ist ab Frame 0 sichtbar (hook.y 1170 hält es frei von der Ausstellungsbeschriftung), ein Heldenmoment mit einem roten Kreis auf etwas, das der Rahmen wirklich zeigt.
  • Das Bild folgt den Worten. Untertitel sind 2-3-Wort-Phrasen (break_before); Namen bleiben in einer Gruppe.
  • Die letzte Einstellung schneidet zurück zum ersten Frame (das Video looped).
  • Der gesamte lesbare Text bleibt in der Smartphone-Safe-Zone: y 300-1580, x 130-950 (x <= 860 für y 1000-1600). check.py setzt dies durch.
  • Hohes Fenster für Fotos "aspect": "3:4" (900x1200) bei Clips ab 1080p; 720p oder Letterbox-Quellen können es nicht füllen.

Hart erkämpfte Lektionen (Details in references/lessons.md)

  • Die edl ist neuer als das Rendering? Das Rendering ist veraltet. Erstellen Sie es neu, bevor Sie check.py beurteilen.
  • Eingefrorene Standbilder (aufeinanderfolgende Frames unterscheiden sich für > 0,3 s kaum) führen zu Fehlern in check.py. Statische Bildschirme, einfarbige Flächen und unbewegte Motive benötigen eine gleichmäßige Bewegung: "move_ease": "linear", einen Zoom-Bereich von 0,15-0,4 und einen Schwenk von 150+ Quell-Pixeln. float allein reicht nicht (der Sinus verlangsamt sich an seinen Wendepunkten auf Null).
  • Zoom-Grenzen: 4K-Quellen <= 1,00, 1080p <= 1,25, 720p <= 1,0 (check.py gibt den Grenzwert pro Clip aus).
  • Creator-Overlays (Wasserzeichen, Facecam, unteres Drittel, Untertitel, stilisierte Banner) dürfen nie das Bild erreichen: Beschneiden Sie mit dem top-level sources-Bild-Override, verschieben Sie den Beschnitt oder wählen Sie andere Frames. Betrachten Sie jeden Schnitt-Frame.
  • Ehrlichkeit: Beschriftungen, Kreise und Untertitel sagen nur, was der Frame zeigt; schreiben Sie Fakten ihrer Quelle in der Stimme zu.
  • Cover: Ein randloser Beschnitt eines Quell-Frames; der Plate sitzt bei tab_y (330) und verdeckt den oberen Teil des Bildes. Bei einem Motiv nahe der Oberseite setzen Sie tab_y auf etwa 1090 und stamp_y auf etwa 410.
  • Ein Rendering nach dem anderen (ein 4K60-Rendering verwendet alle Kerne); starten Sie nie ein zweites Rendering desselben Ordners.

Delegieren einer Bearbeitung an einen Sub-Agenten

Geben Sie dem Agenten BRIEF.md (erstellt von shorts-init aus references/editor-brief.md) plus das Skript, die Sprachdateien und die Clips-Liste. Die Hauptsitzung schreibt das Skript und die Stimme, überprüft jeden Frame selbst und macht den Ton-Mix: Ein Agentenbericht ist eine Behauptung, kein Beweis. Überprüfen Sie Dateizeiten (stilles mp4 neuer als edl, Prüfprotokoll neuer als das mp4), bevor Sie akzeptieren.

Individual skills in this repo

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

Verwandte Skills