CommunitySchreiben & Editierengithub.com

YouTube-Paketierung

Verwandle ein fertiges Video, Skript oder Transkript in das komplette Upload-Paket – alles per Code geprüft. 3 Titeloptionen, eine Beschreibung mit YouTube-konformen Kapiteln, ein Pinned Comment, eine SRT-Untertiteldatei und 3 fertige Thumbnails.

Was ist YouTube-Paketierung?

Dieses Skill automatisiert die Erstellung des kompletten Upload-Pakets für YouTube-Videos – von Titeln über Kapitel und Untertitel bis zu Thumbnails. Es ist für jede Nische und jede Videolänge geeignet, insbesondere für längere Inhalte. Der Skill umfasst Python-Skripte zur Generierung von SRT-Untertiteln, zur Überprüfung des Pakets und zur Erstellung von Thumbnails aus Videoframes. Die Thumbnails werden mit Pillow, numpy und Playwright gerendert und auf Kontrast und Lesbarkeit auf Smartphones geprüft. Das Paket wird durch ein automatisiertes Regelwerk validiert, das u.a. Zeichenlimits, Kapitellängen und verbotene Wörter prüft. Der Skill unterstützt verschiedene Eingabeformate (wortgenaue Timings, zeitgestempelte Transkripte, reine Skripte) und erzeugt drei unterschiedliche Thumbnail-Varianten für YouTubes Test-and-Compare-Funktion.

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

Installed? Explore more Schreiben & Editieren skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht YouTube-Paketierung?

Verwandle das Skript oder Transkript eines fertigen Videos in alles, was der Upload braucht: Titel, Beschreibung mit Kapiteln, Pinned Comment, Untertitel und drei Thumbnails. Jede Nische, jede Länge (konzipiert für Langform, funktioniert auch für kürzere Videos).

Die Skripte befinden sich im Ordner scripts/ neben dieser SKILL.md. Führe sie mit python (3.10 oder neuer) und dem absoluten Pfad dieses Ordners aus. check_package.py und make_srt.py benötigen nichts weiter; die Thumbnails (thumbs.py) benötigen Pillow, numpy und Playwright mit Chromium (python -m pip install pillow numpy playwright und dann python -m playwright install chromium) sowie ffmpeg, wenn die Frames aus einer Videodatei stammen.

1. Eingaben sammeln

  • Die Wörter des Videos, am besten als Erstes: Worttimings als JSON (aus einem Transkriptionstool mit Wort-Zeitstempeln), ein zeitgestempeltes Transkript (0:12 Text-Zeilen, ein kopiertes YouTube-Transkript, eine SRT- oder VTT-Datei) oder das Skript allein (dann ist jede Zeit eine Schätzung; dies angeben).
  • Die endgültige Länge des Videos (für das letzte Kapitel und die Untertitel).
  • Eine Ressource oder ein Link, den das Video verspricht, falls vorhanden. Ohne den echten Link schreibe [LINK] zum Ausfüllen durch den Benutzer.
  • Optional: Frühere Beschreibungen des Kanals (damit die neue sich nicht wiederholt), der Arbeitstitel oder die Thumbnail-Idee, die Zielgruppe.

2. Das Video zuerst lesen

Lies das gesamte Skript oder Transkript und notiere: das Versprechen in den ersten 30 Sekunden, den Hauptnutzen, die Abschnitte und wo jeder beginnt, die konkreten Zahlen, die das Video nennt, den überraschendsten Moment. Jeder Titel, jeder Thumbnail-Text und jede Beschreibungszeile muss mit dem übereinstimmen, was das Video tatsächlich liefert.

3. Kapitel

  • Ein Kapitel pro Abschnitt; seine Zeit ist das erste gesprochene Wort dieses Abschnitts. Mit Worttimings oder einem zeitgestempelten Transkript findest du die ersten Wörter jedes Abschnitts. Mit nur einem Skript schätze (Wörter vor dem Abschnitt / Wörter pro Minute) und markiere die Zeiten als Schätzungen, die nach dem Schnitt korrigiert werden müssen.
  • YouTubes Regeln: Die Liste beginnt bei 0:00 (der Hook gehört zu diesem Kapitel), enthält drei oder mehr Kapitel, keines kürzer als 10 Sekunden, in zeitlicher Reihenfolge, Zeiten ab einer Stunde werden 1:05:00 geschrieben. Ein Kapitel unter 10 Sekunden wird mit seinem Nachbarn zusammengelegt.
  • Ein Kapiteltitel sagt, was der Abschnitt behandelt oder fragt, nicht was er schlussfolgert („Der Bewässerungsfehler“, nicht „Hör auf, täglich zu gießen“); 2 bis 6 Wörter; kein Gedankenstrich.

4. Titel (3 Optionen)

  • Jede Option nimmt einen anderen Blickwinkel ein: das Ergebnis, das Problem oder der Fehler, die Neugierlücke oder der Kontrast. Setze die Wörter, nach denen ein Zuschauer suchen würde, früh.
  • Höchstens 60 Zeichen (YouTube erlaubt 100, aber längere Titel werden auf dem Handy und in der Suche abgeschnitten).
  • Die ersten 30 Sekunden des Videos müssen das Versprechen des Titels bestätigen; ein Titel, den der Anfang nicht untermauert, verliert Zuschauer in den ersten Sekunden.
  • Zahlen nur, wenn das Video sie nennt. Keine Hashtags, Links, Übertreibungswörter oder mehr als zwei Wörter in Großbuchstaben.

5. Thumbnails (3 fertige Bilder)

  • Die Texte: höchstens 5 Wörter, auf Handygröße lesbar. Das Thumbnail ergänzt den Titel, statt ihn zu wiederholen: Zusammen erzählen sie die Geschichte (Titel: das Versprechen; Thumbnail: die Einsätze, das Ergebnis, die Wendung). Zahlen nur aus dem Video.
  • Die Bilder: python <skill-ordner>/scripts/thumbs.py frames VIDEO_ODER_BILDERORDNER work/ behält die schärfsten, unterschiedlichsten Frames als work/frames/f01.png ...; öffne work/frames.jpg und wähle das Frame, das den Nutzen zeigt (ein reagierendes Gesicht, das Ergebnis, das Vorher und Nachher). Kein Video? Verwende die eigenen Bilder oder Screenshots des Benutzers in einem Ordner; niemals ein Foto eines Fremden.
  • Schreibe work/thumbs.json: drei Varianten, die sich in EINER Sache unterscheiden (dem Text, dem Bild oder dem Layout), damit YouTubes Test and Compare zeigt, welche funktioniert. Sechs Layouts: simple, shock (Zoom und Ring), big-number, header, comparison (zwei Bilder), blur (eine Enthüllung). Format, Layouts und Optionen (Fokus, Hervorhebungswort, Textseite, Markenfarben): references/thumbnails.md.
  • Rendern: python <skill-ordner>/scripts/thumbs.py render work/thumbs.json out/ [--brand brand.json]. Es schreibt out/thumb-a.png und weiter sowie out/thumbs.jpg: jede Variante groß, als YouTube-Startseitenkachel mit dem Titel und in Handygröße, mit Prüfungen (1280x720 unter 2 MB, höchstens 5 Wörter, Buchstaben mindestens 54 px hoch und auf Handygröße noch lesbar, der Text innerhalb des Frames, Kontrast 4,5:1 gegen das, was dahinter ist). Öffne thumbs.jpg, behebe jeden Fehler (kürzerer Text, "shade": 0,65, ein anderes Layout oder Bild) und rendere erneut.

6. Beschreibung

In dieser Reihenfolge:

  1. Eröffnung: 2 Zeilen, jede höchstens 160 Zeichen, angezeigt vor „...mehr“. Sie sagen das Versprechen in neuen Worten für eine Person, die noch entscheidet, ob sie klickt: nicht den Titel ein zweites Mal, kein Link.
  2. Zusammenfassung: ein kurzer Absatz (höchstens 900 Zeichen) dessen, was der Zuschauer bekommt. Klare Sätze, keine Liste.
  3. Ressourcenzeile (nur, wenn das Video eine verspricht): was es ist, dann der Link oder [LINK].
  4. Kapitel: eine pro Zeile, 0:00 Titel.
  5. Optional: Credits oder Links, die der Ersteller immer hinzufügt.

Insgesamt höchstens 5.000 Zeichen. Keine Hashtags standardmäßig (Themen kommen in die Tags), keine Übertreibungswörter, kein Gedankenstrich und nicht mehr als 30 Prozent seiner Drei-Wort-Folgen mit einer früheren Beschreibung geteilt.

7. Pinned Comment und Tags

  • Pinned Comment: eine Frage, die mit dem Kernproblem des Videos oder dem nächsten Schritt des Zuschauers verbunden ist, leicht mit einem Wort oder einer Zeile zu beantworten. Höchstens 200 Zeichen, kein Link.
  • Tags (optional): 3 oder mehr, insgesamt höchstens 500 Zeichen, kein # und kein Komma innerhalb eines Tags.

8. Untertitel

python <skill-ordner>/scripts/make_srt.py words.json -o video.srt                   # Worttimings
python <skill-ordner>/scripts/make_srt.py transcript.txt --end 18:42 -o video.srt   # zeitgestempelte Zeilen
python <skill-ordner>/scripts/make_srt.py --validate video.srt                       # vorhandene Datei prüfen

Cues: bis zu zwei Zeilen zu 42 Zeichen, 1 bis 7 Sekunden auf dem Bildschirm, zuerst an Satzenden schneiden, dann an Kommas; eine Zahl bleibt bei ihrer Einheit und ein Name wird nie geteilt; keine Überlappung, mindestens 80 ms zwischen Cues. Alle anpassbar (--max-chars, --max-lines, --min-dur, --max-dur, --gap-ms). Der Bericht geht nach stderr; Exit 0 bedeutet, die Datei ist sauber. Zeitgestempelte Zeilen ohne Interpunktion (rohe automatische Untertitel) werden nur nach Länge und Pausen geschnitten: Interpungiere das Transkript zuerst für bessere Cues.

9. Das Paket prüfen

Schreibe das Paket in diesem Markdown-Format (JSON mit denselben Schlüsseln funktioniert auch: titles, description, pinned_comment, thumbnail_texts, tags, duration):

---
duration: 18:42
---

## Titel
1. ...
2. ...
3. ...

## Beschreibung
```
Eröffnungszeile eins.
Eröffnungszeile zwei.

Zusammenfassungsabsatz.

0:00 Erstes Kapitel
...
```

## Pinned Comment
...?

## Thumbnail-Text
1. ...
2. ...
3. ...

## Tags
Tag eins, Tag zwei, Tag drei

Dann führe aus:

python <skill-ordner>/scripts/check_package.py package.md --srt video.srt --source transcript.txt
python <skill-ordner>/scripts/check_package.py package.md --duration 18:42 --earlier alte-beschreibung-1.txt alte-beschreibung-2.txt
  • --duration (oder duration: in der Datei) prüft das letzte Kapitel; ohne wird das Ende des letzten Untertitels verwendet. --source prüft, dass jede Zahl in einem Titel oder Thumbnail-Text im Video vorkommt und dass die Eröffnung Wörter mit jedem Titel teilt. --earlier verhindert eine wiederholte Beschreibung.
  • FAIL muss korrigiert werden; WARN korrigiert oder erklärt. Exit-Code 0 bedeutet, nichts ist fehlgeschlagen (--strict schlägt auch bei Warnungen fehl, --json gibt maschinenlesbare Ergebnisse aus).
  • Limits und die Liste der Übertreibungswörter befinden sich in scripts/package-rules.json; kopiere sie, behalte die Schlüssel, die du ändern möchtest, und übergib --rules meine-regeln.json (z.B. "allow_hashtags": true, "title_max": 70).

Behebe jeden Fehler, führe es erneut aus und gib es dann zurück.

10. Rückgabe

  1. package.md: die drei Titel (markiere deine Wahl und begründe sie in einer Zeile), die zum Einfügen bereite Beschreibung, der Pinned Comment, die drei Thumbnail-Texte, die Tags.
  2. Die .srt-Datei und die drei Thumbnail-PNGs (out/thumb-a.png, -b, -c) mit out/thumbs.jpg.
  3. Upload-Schritte: Beschreibung einfügen (YouTube baut die Kapitel aus seinen Zeitzeilen), SRT als Untertitel in der Videosprache hochladen, die drei Thumbnails zu Test and Compare hinzufügen, alle [LINK] ersetzen, nach der Veröffentlichung den Pinned Comment anheften, die letzten 20 Sekunden für den Endbildschirm freihalten.
  4. Die Ergebniszeile des Prüfers und jede akzeptierte Warnung mit ihrer Begründung.

Weitere Details zu jeder Regel und warum sie existiert: references/packaging-rules.md.

Arbeitsbeispiel

examples/transcript.txt ist das zeitgestempelte Transkript eines 10:06 langen Videos über den Anbau von Lebensmitteln auf einem kleinen Balkon; examples/words.json enthält Worttimings für die ersten 46 Sekunden.

python scripts/make_srt.py examples/transcript.txt --end 10:06 -o test-out.srt
python scripts/check_package.py examples/package.md --srt test-out.srt --source examples/transcript.txt

Das erste gibt made 149 cues from 1497 words, 0:00.4 to 10:03.0 und srt: ok aus; das zweite endet mit Result: 0 failed, 0 warnings, 11 passed. Seine Titel nehmen drei Blickwinkel ein (Ergebnis: „Grow Real Food on a Tiny Balcony (Even If Plants Hate You)“; Methode: „The One-Day Sun Test That Decides What Your Balcony Grows“; Problem: „Why Balcony Plants Die, and the Bucket Trick That Fixes It“), und seine Thumbnail-Texte („6 HOURS OR NOTHING“, „IT WATERS ITSELF“, „STOP KILLING PLANTS“) fügen alle etwas hinzu, was die Titel nicht sagen. examples/package-weak.json zeigt die Fehler: einen langen Titel mit einem Hashtag, Kapitel, die bei 0:05 beginnen, ein 6-Sekunden-Kapitel, einen Pinned Comment mit einem Link und ohne Frage, einen 8-Wörter-Thumbnail-Text (9 fehlgeschlagen).

Verwandte Skills