Packaging YouTube
Transformez le script ou la transcription d'une vidéo YouTube terminée en tout ce dont vous avez besoin pour la mise en ligne : titres, description avec chapitres, commentaire épinglé, sous-titres et trois vignettes. N'importe quel créneau, n'importe quelle durée (conçu pour les formats longs, fonctionne aussi pour les vidéos plus courtes).
Les scripts se trouvent dans le dossier scripts/ à côté de ce SKILL.md. Exécutez-les avec python (3.10 ou plus récent) en utilisant le chemin absolu de ce dossier. check_package.py et make_srt.py ne nécessitent rien d'autre ; les vignettes (thumbs.py) nécessitent Pillow, numpy et Playwright avec Chromium (python -m pip install pillow numpy playwright puis python -m playwright install chromium), et ffmpeg lorsque les images proviennent d'un fichier vidéo.
1. Rassembler les entrées
- Les paroles de la vidéo, de préférence en premier : les timings des mots en JSON (provenant d'un outil de transcription avec horodatage des mots), une transcription horodatée (lignes
0:12 texte, une transcription YouTube copiée, un fichier SRT ou VTT), ou le script seul (dans ce cas, chaque heure est une estimation ; mentionnez-le). - La durée finale de la vidéo (pour le dernier chapitre et les sous-titres).
- Une ressource ou un lien que la vidéo promet, le cas échéant. Sans le lien réel, écrivez
[LIEN]pour que l'utilisateur le remplisse. - Optionnel : les descriptions précédentes de la chaîne (afin que la nouvelle ne les répète pas), le titre provisoire ou l'idée de vignette, le public cible.
2. Lire d'abord la vidéo
Lisez l'intégralité du script ou de la transcription et notez : la promesse faite dans les 30 premières secondes, le principal bénéfice, les sections et où chacune commence, les chiffres concrets que la vidéo énonce, le moment le plus surprenant. Chaque titre, texte de vignette et ligne de description doit correspondre à ce que la vidéo livre réellement.
3. Chapitres
- Un chapitre par section ; son heure correspond au premier mot parlé de cette section. Avec des timings de mots ou une transcription horodatée, trouvez les premiers mots de chaque section. Avec seulement un script, estimez (mots avant la section / mots par minute) et marquez les heures comme des estimations à corriger après le montage.
- Règles YouTube : la liste commence à
0:00(l'accroche appartient à ce chapitre), contient au moins trois chapitres, aucun chapitre ne dure moins de 10 secondes, dans l'ordre chronologique, les heures à partir d'une heure s'écrivent1:05:00. Un chapitre de moins de 10 secondes est fusionné avec son voisin. - Un titre de chapitre indique ce que la section couvre ou ce qu'elle demande, pas ce qu'elle conclut ("L'erreur d'arrosage", pas "Arrêtez d'arroser tous les jours") ; 2 à 6 mots ; pas de tiret cadratin.
4. Titres (3 options)
- Chaque option adopte un angle différent : le résultat, le problème ou l'erreur, la curiosité ou le contraste. Placez les mots qu'un spectateur rechercherait tôt.
- Au maximum 60 caractères (YouTube autorise 100, mais les titres plus longs sont coupés sur téléphone et dans les résultats de recherche).
- Les 30 premières secondes de la vidéo doivent confirmer la promesse du titre ; un titre que l'ouverture ne soutient pas perd les spectateurs dès les premières secondes.
- Les chiffres uniquement lorsque la vidéo les mentionne. Pas de hashtags, de liens, de mots racoleurs, ni plus de deux mots en majuscules.
5. Vignettes (3 images finalisées)
- Les textes : au maximum 5 mots, lisibles au format téléphone. La vignette ajoute au titre au lieu de le répéter : ensemble, ils racontent une histoire (titre : la promesse ; vignette : les enjeux, le résultat, le rebondissement). Les chiffres uniquement issus de la vidéo.
- Les images :
python <dossier-skill>/scripts/thumbs.py frames VIDEO_OU_DOSSIER_IMAGES travail/conserve les images les plus nettes et les plus différentes sous les nomstravail/frames/f01.png ...; ouvreztravail/frames.jpget choisissez l'image qui montre le bénéfice (un visage réagissant, le résultat, l'avant et l'après). Pas de vidéo ? Utilisez vos propres images ou captures d'écran dans un dossier ; jamais la photo d'un inconnu. - Écrivez
travail/thumbs.json: trois variantes qui diffèrent sur UN seul élément (le texte, l'image ou la disposition), afin que le test et comparaison de YouTube indique laquelle fonctionne. Six dispositions :simple,choc(zoom et anneau),grand-chiffre,en-tête,comparaison(deux images),flou(un dévoilement). Format, dispositions et options (focus, mot surligné, côté du texte, couleurs de marque) : references/thumbnails.md. - Rendu :
python <dossier-skill>/scripts/thumbs.py rendu travail/thumbs.json out/ [--marque marque.json]. Cela écritout/vignette-a.pnget suivants ainsi queout/vignettes.jpg: chaque variante en grand, sous forme de vignette d'accueil YouTube avec le titre, et au format téléphone, avec ses vérifications (1280×720 sous 2 Mo, au maximum 5 mots, lettres d'au moins 54 px de haut et toujours lisibles au format téléphone, le texte à l'intérieur du cadre, contraste 4.5:1 par rapport à l'arrière-plan). Ouvrezvignettes.jpg, corrigez chaque échec (texte plus court,"shade": 0.65, une autre disposition ou image) et rendez à nouveau.
6. Description
Dans cet ordre :
- Ouverture : 2 lignes, chacune de 160 caractères maximum, affichées avant "...plus". Elles reformulent la promesse en des termes nouveaux pour une personne qui décide encore de cliquer : pas le titre une deuxième fois, pas de lien.
- Résumé : un court paragraphe (900 caractères maximum) de ce que le spectateur obtiendra. Phrases simples, pas de liste.
- Ligne de ressource (uniquement si la vidéo en promet une) : ce que c'est, puis le lien ou
[LIEN]. - Chapitres : un par ligne,
0:00 Titre. - Optionnel : crédits ou liens que le créateur ajoute toujours.
Au maximum 5 000 caractères en tout. Pas de hashtags par défaut (les sujets vont dans les balises), pas de mots racoleurs, pas de tiret cadratin, et pas plus de 30 pour cent de ses séquences de trois mots partagées avec une description précédente.
7. Commentaire épinglé et balises
- Commentaire épinglé : une question liée au problème central de la vidéo ou à la prochaine étape du spectateur, facile à répondre en un mot ou une ligne. Au maximum 200 caractères, pas de lien.
- Balises (optionnel) : 3 ou plus, 500 caractères maximum en tout, pas de
#et pas de virgule à l'intérieur d'une balise.
8. Sous-titres
python <dossier-skill>/scripts/make_srt.py mots.json -o video.srt # timings des mots
python <dossier-skill>/scripts/make_srt.py transcription.txt --fin 18:42 -o video.srt # lignes horodatées
python <dossier-skill>/scripts/make_srt.py --valider video.srt # vérifier un fichier existant
Séquences : jusqu'à deux lignes de 42 caractères, affichées à l'écran entre 1 et 7 secondes, coupées d'abord en fin de phrase, puis aux virgules ; un nombre reste avec son unité et un nom n'est jamais coupé ; pas de chevauchement, au moins 80 ms entre les séquences. Tout est ajustable (--max-car, --max-lignes, --min-dur, --max-dur, --ecart-ms). Le rapport va sur stderr ; le code de sortie 0 signifie que le fichier est propre. Les lignes horodatées sans ponctuation (sous-titres automatiques bruts) sont coupées uniquement par la longueur et les pauses : ponctuez d'abord la transcription pour de meilleures séquences.
9. Vérifier le package
Écrivez le package dans ce format Markdown (JSON avec les mêmes clés fonctionne aussi :
titres, description, commentaire_epingle, textes_vignettes, balises, duree) :
---
duree: 18:42
---
## Titres
1. ...
2. ...
3. ...
## Description
```
Ligne d'ouverture une.
Ligne d'ouverture deux.
Paragraphe du résumé.
0:00 Premier chapitre
...
```
## Commentaire épinglé
...?
## Texte des vignettes
1. ...
2. ...
3. ...
## Balises
balise une, balise deux, balise trois
Ensuite exécutez :
python <dossier-skill>/scripts/check_package.py package.md --srt video.srt --source transcription.txt
python <dossier-skill>/scripts/check_package.py package.md --duree 18:42 --precedentes ancienne-desc-1.txt ancienne-desc-2.txt
--duree(ouduree:dans le fichier) vérifie le dernier chapitre ; sans cela, la fin du dernier sous-titre est utilisée.--sourcevérifie que chaque chiffre dans un titre ou un texte de vignette apparaît dans la vidéo et que l'ouverture partage des mots avec chaque titre.--precedentesbloque une description répétée.ÉCHECdoit être corrigé ;ATTENTIONcorrigé ou expliqué. Le code de sortie 0 signifie que rien n'a échoué (--strictéchoue aussi sur les avertissements,--jsonimprime les résultats lisibles par machine).- Les limites et la liste de mots racoleurs se trouvent dans
scripts/package-regles.json; copiez-le, conservez les clés à modifier, passez--regles mes-regles.json(par exemple"autoriser_hashtags": true,"titre_max": 70).
Corrigez chaque échec, relancez-le, puis remettez le travail.
10. Remettre le travail
package.md: les trois titres (indiquez votre choix et pourquoi en une ligne), la description prête à coller, le commentaire épinglé, les trois textes de vignettes, les balises.- Le fichier
.srtet les trois PNG de vignettes (out/vignette-a.png,-b,-c), avecout/vignettes.jpg. - Étapes de mise en ligne : collez la description (YouTube construit les chapitres à partir de ses lignes d'horodatage), téléchargez le SRT comme sous-titres dans la langue de la vidéo, ajoutez les trois vignettes au test et comparaison, remplacez les éventuels
[LIEN], épinglez le commentaire après publication, gardez les 20 dernières secondes libres pour l'écran de fin. - La ligne de résultat du vérificateur, et tout avertissement accepté avec sa raison.
Plus de détails sur chaque règle et pourquoi elle existe : references/regles-packaging.md.
Exemple concret
exemples/transcription.txt est la transcription horodatée d'une vidéo de 10:06 sur la culture d'aliments sur un petit balcon ; exemples/mots.json contient les timings des mots pour ses 46 premières secondes.
python scripts/make_srt.py exemples/transcription.txt --fin 10:06 -o test-out.srt
python scripts/check_package.py exemples/package.md --srt test-out.srt --source exemples/transcription.txt
La première commande affiche créé 149 séquences à partir de 1497 mots, 0:00.4 à 10:03.0 et srt: ok ; la seconde se termine par Résultat : 0 échecs, 0 avertissements, 11 réussis. Ses titres adoptent trois angles (résultat : "Cultivez de Vrais Aliments sur un Petit Balcon (Même si les Plantes vous Détestent)" ; méthode : "Le Test du Soleil d'un Jour qui Décide ce que Votre Balcon Cultive" ; problème : "Pourquoi les Plantes de Balcon Meurent, et l'Astuce du Seau qui Résout Tout"), et ses textes de vignettes ("6 HEURES OU RIEN", "ÇA S'ARROSE TOUT SEUL", "ARRÊTEZ DE TUER LES PLANTES") ajoutent chacun quelque chose que les titres ne disent pas. exemples/package-faible.json montre les échecs : un titre long avec un hashtag, des chapitres commençant à 0:05, un chapitre de 6 secondes, un commentaire épinglé avec un lien et sans question, un texte de vignette de 8 mots (9 échecs).