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 werden1:05:00geschrieben. 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 alswork/frames/f01.png ...; öffnework/frames.jpgund 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 schreibtout/thumb-a.pngund weiter sowieout/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). Öffnethumbs.jpg, behebe jeden Fehler (kürzerer Text,"shade": 0,65, ein anderes Layout oder Bild) und rendere erneut.
6. Beschreibung
In dieser Reihenfolge:
- 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.
- Zusammenfassung: ein kurzer Absatz (höchstens 900 Zeichen) dessen, was der Zuschauer bekommt. Klare Sätze, keine Liste.
- Ressourcenzeile (nur, wenn das Video eine verspricht): was es ist, dann der Link oder
[LINK]. - Kapitel: eine pro Zeile,
0:00 Titel. - 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(oderduration:in der Datei) prüft das letzte Kapitel; ohne wird das Ende des letzten Untertitels verwendet.--sourceprüft, dass jede Zahl in einem Titel oder Thumbnail-Text im Video vorkommt und dass die Eröffnung Wörter mit jedem Titel teilt.--earlierverhindert eine wiederholte Beschreibung.FAILmuss korrigiert werden;WARNkorrigiert oder erklärt. Exit-Code 0 bedeutet, nichts ist fehlgeschlagen (--strictschlägt auch bei Warnungen fehl,--jsongibt 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
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.- Die
.srt-Datei und die drei Thumbnail-PNGs (out/thumb-a.png,-b,-c) mitout/thumbs.jpg. - 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. - 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).