Communitygithub.com

shorts-pipeline

Créer, rendu, vérifier, mixer et empaqueter une vidéo verticale 1080×1920 (YouTube Shorts, Reels, TikTok) à partir de séquences sources et d’une voix off avec le pipeline basé sur les clips (edl.json, build.py, check.py, sound/mix.py). Utilisez cette compétence dès qu’il s’agit de produire, corriger ou examiner une telle vidéo, de briefier un sous-agent monteur, ou d’expliquer pourquoi check.py échoue.

Qu'est-ce que shorts-pipeline ?

Cette compétence implémente un pipeline complet de production de vidéos courtes verticales (1080×1920) destinées aux plateformes YouTube Shorts, Instagram Reels et TikTok. Elle repose sur un fichier de montage (edl.json) et une voix off pour générer une vidéo incluant des clips animés dans une fenêtre photo thématique, des sous-titres par mots, un écran d’accroche, un cercle de mise en valeur, une couverture, une liste d’effets sonores et un mixage audio à -14 LUFS. Le pipeline est neutre thématiquement : toutes les spécificités d’une chaîne (sujet, langues, public, règles de contenu, aspect visuel, voix, crédits, planning) sont définies dans un fichier `CHANNEL.md` propre au projet, qu’il faut lire en priorité. Le flux de travail se décompose en neuf étapes numérotées, de l’écriture du script à l’empaquetage final, avec une vérification à chaque étape via `build.py` et `check.py`. La compétence est conçue pour fonctionner avec des sous-agents (par exemple un agent monteur briefé via un fichier `BRIEF.md`) mais insiste sur le fait que le superviseur humain ou l’agent principal doit toujours revoir chaque plan et effectuer le mixage final lui-même. Des leçons durement acquises sont documentées, notamment sur le mouvement des plans, les limites de zoom, les superpositions de créateur et l’honnêteté des légendes.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Pipeline Shorts (neutre thématiquement)

Une seule liste de montage (<short>/edl.json) et une voix off donnent une vidéo terminée : des clips animés dans une fenêtre photo thématique, des sous-titres par mots, un écran d'accroche, un cercle de mise en valeur, une couverture, une liste d'effets sonores et un mixage à -14 LUFS. Tout ce qui est spécifique à une chaîne (sujet, langues, public, règles de contenu, aspect visuel, voix, crédits, planning) se trouve dans CHANNEL.md du projet. Lisez-le d'abord et suivez-le par rapport aux valeurs par défaut ci-dessous. Si le fichier est manquant ou contient des sections vides, demandez au propriétaire (ou copiez engine/templates/CHANNEL.md et remplissez-le avec lui) avant de produire quoi que ce soit. Compétences associées : shorts-script-voice (sujet, script, voix) et shorts-packaging (fichiers finis, textes de publication).

Avant tout

  1. Les scripts du kit (setup.sh, shorts-init.sh, doctor.sh, install-codex.sh) se trouvent dans le dossier scripts/ du kit : le dossier du plugin, ou $SHORTS_HOME/kit/scripts/ (setup.sh et install-codex.sh en conservent une copie).
  2. Travaillez à partir d'un dossier projet qui contient _pipeline/, _tools/, _fonts/, CHANNEL.md (créez-en un avec scripts/shorts-init.sh <dir>). Toutes les commandes ci-dessous s'exécutent depuis la racine de ce dossier.
  3. Exécutez scripts/doctor.sh <project-dir> une fois par machine. Il vérifie toutes les dépendances (programmes système, paquets Python, modèles, espace disque) et doit se terminer par "All good." Sinon : scripts/install-system-deps.sh pour ffmpeg/Python/curl, scripts/setup.sh pour le reste. La liste complète se trouve dans DEPENDENCIES.md du kit.
  4. SHORTS_HOME (par défaut ~/.shorts-studio) contient l'environnement virtuel Python et les modèles vocaux. Exportez-le si vous le placez ailleurs.
  5. Lisez _pipeline/README.md (référence du moteur) et references/edl-notes.md avant d'écrire une liste de montage.

Le flux de travail (chaque étape a sa propre vérification)

#ÉtapeCommande / sortieVérification
1Sujet + scriptcompétence shorts-script-voiceune affirmation, sources attribuées, propriétaire OK quand le profil le demande
2Voix$SHORTS_HOME/venv/bin/python _tools/build_vo.py <short>/vo/beats.json, puis _tools/words.py <short>/volisez vo/words.json : chaque mot est correct
3Séquences_tools/grab.py <sujet> '<url>' <début> <fin> --tag NOM (journal dans _footage/SOURCES.md), ou vos propres enregistrementsplanche contact de chaque clip ; politique depuis CHANNEL.md
4Liste de montagecopiez references/edl-template.json, modifiez le contenubuild.py <edl> --words affiche les tokens des sous-titres
5Rendupython3 _pipeline/build.py <short>/edl.json --theme <thème> (3-10 min ; 4K60 est lent)pas d'erreur ; le fichier est plus récent que l'edl
6Couverture... build.py <edl> --cover"safe-zone violations: none", lisible à 180 px de large
7Vérificationpython3 _pipeline/check.py <short>/<nom>-<thème>-silent.mp4 <short>/edl.jsonaffiche ALL CHECKS PASS ; vous avez regardé chaque planche contact
8Son$SHORTS_HOME/venv/bin/python _pipeline/sound/mix.py <short> --theme <thème> --music <nom> --strict-14.0 +/-0.5 LUFS, crête réelle <= -1.0 dBTP, erreurs de mots proches de 0
9Empaquetagecompétence shorts-packagingfichier + couverture + texte de publication dans ready/

Planches contact d'un clip source : ffmpeg -ss <t> -i <fichier> -t <d> -vf "fps=2,scale=320:-1,tile=7x4" -frames:v 1 out.png (écrivez en PNG : la sortie JPEG de certaines sources échoue avec "non full-range YUV"). Limites de plans : ffmpeg -i <fichier> -vf "scale=320:180,select='gt(scene,0.25)',showinfo" -an -f null - 2>&1 | grep -o "pts_time:[0-9.]*". Thèmes : case-file (papier dossier), panel-heist (planche BD), vice-dusk (crépuscule néon), classic ; le profil en choisit un.

À quoi ressemble une bonne short (valeurs par défaut ; le profil les surcharge)

  • 18-45 s, un argument de l'accroche à la conclusion, un cut toutes les 1.5-3 s, chaque plan bouge, l'écran d'accroche est présent dès la frame 0 (hook.y 1170 le maintient dégagé de l'étiquette d'exposition), un moment héroïque avec un cercle rouge sur quelque chose que la frame montre vraiment.
  • L'image suit les mots. Les sous-titres sont des phrases de 2-3 mots (break_before) ; les noms restent en un seul groupe.
  • Le dernier plan revient sur la première frame (la vidéo boucle).
  • Tout texte lisible reste dans la zone de sécurité du téléphone : y 300-1580, x 130-950 (x <= 860 pour y 1000-1600). check.py l'applique.
  • Fenêtre photo haute "aspect": "3:4" (900x1200) sur des clips en 1080p et plus ; les sources 720p ou letterboxées ne peuvent pas la remplir.

Leçons durement acquises (détails dans references/lessons.md)

  • L'edl est plus récent que le rendu ? Le rendu est obsolète. Reconstruisez avant de juger check.py.
  • Plans figés (frames consécutives qui diffèrent à peine pendant > 0.3 s) font échouer check.py. Les écrans statiques, les couleurs unies et les sujets immobiles ont besoin d'un mouvement à vitesse constante : "move_ease": "linear", une plage de zoom de 0.15-0.4 et un panoramique de 150+ px source. float seul ne suffit pas (la sinusoïde ralentit jusqu'à zéro à ses extremums).
  • Limites de zoom : sources 4K <= 1.00, 1080p <= 1.25, 720p <= 1.0 (check.py affiche la limite par clip).
  • Superpositions de créateur (filigrane, facecam, tiers inférieur, sous-titres, bannières stylisées) n'atteignent jamais l'image : recadrez avec la surcharge d'image sources de premier niveau, déplacez le recadrage ou choisissez d'autres frames. Regardez chaque cut frame.
  • Honnêteté : les étiquettes, les cercles et les sous-titres ne disent que ce que la frame montre ; attribuez les faits à leur source dans la voix.
  • Couverture : un recadrage plein cadre d'une frame source ; la plaque se place à tab_y (330) et cache le haut de l'image. Pour un sujet près du haut, définissez tab_y vers 1090 et stamp_y vers 410.
  • Un rendu à la fois (un rendu 4K60 utilise tous les cœurs) ; ne lancez jamais un second rendu du même dossier.

Délégation d'un montage à un sous-agent

Donnez à l'agent BRIEF.md (créé par shorts-init à partir de references/editor-brief.md) ainsi que le script, les fichiers vocaux et la liste des clips. La session principale écrit le script et la voix, revérifie chaque plan elle-même et effectue le mixage sonore : le rapport d'un agent est une affirmation, pas une preuve. Vérifiez les heures des fichiers (mp4 silencieux plus récent que l'edl, journal de check plus récent que le mp4) avant d'accepter.

Individual skills in this repo

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

Skills associés