learnaiwithhugo/video-editor-skills

/edit-my-video

Des rushs bruts en entrée, un Reel 1080x1920 fini en sortie, dans le style de l'utilisateur·ice. L'utilisateur·ice n'est généralement pas technique : parle en messages courts et simples, une étape à la fois, fais tout le travail technique toi-même, et ne leur fais jamais toucher à du code. N'utilise jamais la popup AskUserQuestion (demande dans le chat). Ne publie ni ne télécharge rien nulle part. Pas de tirets cadratins dans ce que tu écris pour eux ou à l'écran.

SK = le dossier de cette compétence. STYLE = le dossier de style (par défaut : celui enregistré dans SK/config.json, sinon celui créé par /build-my-style, sinon ~/edit-style ; si aucun n'a de STYLE.md, demande où il est ou suggère d'abord /build-my-style). WORK = un dossier par vidéo, <dossier éditions>/<slug>/ (slug = kebab-case court, ex. github-repos). Mets chaque chemin entre guillemets, ils contiennent des espaces. Les scripts s'exécutent avec python3 "SK/scripts/<nom>.py" ... ; chacun affiche sa propre utilisation quand lancé sans argument.

Lis avant la première édition d'une session : references/creative-rules.md (le fichier le plus important : comment concevoir, et les vérifications de goût strictes) et references/engine.md (le motif HyperFrames qui rend). Lis references/storyboard.md avant l'étape 4.

La règle la plus importante

STYLE.md est une garde-fou, pas un menu. Il fixe le look (couleurs, police, sensation des mouvements, niveaux sonores, zone de sécurité, ce qui a été rejeté). Il ne limite pas ce que tu crées. Pour chaque ligne, demande-toi quel visuel expliquerait le mieux cette idée, puis conçois-le à neuf dans le respect du look. Le premier montage test a copié des modèles de la page de style (une checklist du genre "ça ne peut faire que trois choses") et le créateur l'a qualifié d'"extrêmement limité" et de "pas improvisé du tout". Varie les mises en page ; ne répète jamais la même mise en page deux fois de suite ; rends les visuels grands.

Étapes (indique sur laquelle tu es en une courte ligne : "Étape 3 sur 8 : recherche de tes meilleures prises")

1. Vérification de la configuration (secondes)

python3 "SK/scripts/setup.py" --check. Affiche les éléments manquants sous forme de courte liste : ce que c'est, à quoi ça sert, la correction en une ligne. Pour tout ce qu'iels doivent installer (ffmpeg, Node, Python, Chrome), dis-leur de coller la ligne dans l'application Terminal (Commande + Espace, tape Terminal) et de dire "fait". --install (faster-whisper, playwright, HyperFrames, modèle de reconnaissance vocale) seulement après qu'iels aient répondu oui : "Puis-je installer les outils de montage gratuits ? Environ 5 minutes, une seule fois." Ensuite python3 "SK/scripts/style.py" check "STYLE" (le dossier de style est-il complet) et python3 "SK/scripts/style.py" serve "STYLE" (démarre son serveur de page s'il ne tourne pas ; note l'URL). Premier lancement seulement : demande où les éditions doivent être enregistrées (suggère le dossier à côté du dossier de style, edits/) et enregistre-le : setup.py --save --style "STYLE" --edits "<dossier>".

2. Collecte des informations (un message)

Demande seulement ce que tu n'as pas déjà :

• le dossier des rushs bruts (souvent plusieurs prises répétées ; tu utiliseras la DERNIÈRE prise propre de chaque ligne)
• le sujet de la vidéo, et le script ou les notes s'iels en ont
• le mot-clé de commentaire pour l'appel à l'action
• la durée cible (suggère 25 à 40 s)
• la musique : seulement s'iels nomment un morceau. Sinon, aucune (le créateur choisit la musique lui-même). Puis mkdir WORK et python3 "SK/scripts/style.py" resolve "STYLE" --out "WORK/style.json". Lis STYLE.md en entier : en particulier Feedback from edits, Rejected et Kept, les plus récents en premier. Ce sont les corrections du créateur issues des montages précédents et elles priment sur tout le reste.

3. Prises, coupe, mots (~1 min pour 5 min de rushes)

1. takes.py "WORK" "<clip>" ... --prompt "<noms qu'iels diront>" liste chaque tentative, les retakes sont marqués. Lis WORK/takes/*.txt. Choisis la dernière prise propre complète de chaque ligne (ignore les bafouillages ; coupe un mauvais début en déplaçant in). Écris WORK/edl.json (format dans l'utilisation de cut.py).
2. cut.py "WORK" --prompt "<noms>" : segments image par image dans WORK/hf/assets/v/, la voix à -16 LUFS, bords serrés, et words.json / words.txt avec les temps du Reel. Regarde progress/01-cut-takes-in-order.jpg.
3. Lis words.txt par rapport à ce qu'iels voulaient dire. Whisper se trompe sur les noms : corrige-les dans words.json avec captions.py fix "WORK" "49=ArtCraft" (uniquement pour correspondre à ce qui a vraiment été dit). Dis-leur la coupe en une ligne par plan et la durée.

4. Storyboard d'abord (l'utilisateur·ice approuve avant tout rendu)

Suis references/storyboard.md : écris WORK/storyboard.json (un plan par idée : mots, temps, mise en page, visuel, animation, légende, son), construis une image fixe par plan sur leurs vrais rushs avec le visuel prévu composité (vraies captures d'écran, vraies icônes d'applis, JPG), avec 2 à 3 alternatives (A/B/C) sur les 3 ou 4 plans clés (accroche, l'idée principale, la conclusion, le CTA). Ensuite storyboard.py page "WORK" --style "STYLE" et ouvre http://localhost:<port>/storyboards/<slug>/ (open <url>). Dis : "Ton storyboard est ouvert. Choisis A, B ou C là où il y a un choix, Approuve ou Modifie chaque plan, ajoute une note n'importe où, appuie sur Envoyer, puis dis-moi fait." Attends "fait". Ensuite storyboard.py review "WORK" --style "STYLE" intègre leurs choix et notes dans storyboard.json. Reconstruis seulement les plans qu'iels ont modifiés et montre-les à nouveau, jusqu'à ce que tout soit approuvé.

5. Variations (optionnel, propose-le une fois : "Tu veux voir 2 ou 3 versions de l'accroche en mouvement avant que je construise l'ensemble ?")

Pour 2 ou 3 moments clés : construis le montage assez loin pour les couvrir (étape 6), copie hf/index.html vers hf/index-<plan>-B.html avec ce plan redessiné, puis render.py slice "WORK" <plan>-A <début> <fin> et render.py slice "WORK" <plan>-B <fin> --index "WORK/hf/index-<plan>-B.html" (2 à 4 s chacun, ~6 s pour le rendu). Mets "video": "variations/<nom>.mp4" sur ces alternatives dans storyboard.json, storyboard.py page "WORK" --style "STYLE" --variations, ouvre .../storyboards/<slug>/variations.html, attends "fait", storyboard.py review ... --variations, conserve les gagnants dans index.html.

6. Construire le montage (la partie créative)

1. render.py new "WORK" --title "<vidéo> v1" : le projet HyperFrames épinglé avec les couleurs, la police, l'ombre des légendes et le kit de mouvement (engine/kit.js) du style dans WORK/hf/.
2. Collecte les éléments réels : shoot.py web <url> <png> --mobile (pages après chargement complet), shoot.py icon "<App>" <png> (vraies icônes macOS), logos officiels du site de l'outil sinon.
3. Écris WORK/hf/index.html plan par plan à partir du storyboard approuvé (motif et API du kit dans references/engine.md), en calant chaque visuel sur le mot auquel il appartient dans words.txt. Conçois chaque plan à neuf ; donne à chaque scène visuelle data-visual="<ce que c'est>" et data-layout="face|split|full".
4. Légendes : captions.py make "WORK" --skip <a-b> (saute les moments où le texte à l'écran dit déjà les mots), puis édite WORK/caps.json manuellement : segmente-les pour qu'elles se lisent naturellement (2 à 3 mots), mets top pour qu'elles ne soient jamais sur la bouche, cls par plan, html pour un mot d'accent. captions.py inject "WORK".
5. Son : écris WORK/cues.json (chaque coupe, panneau, icône, ligne, mot héros a sa propre note à son niveau verrouillé ; pas de doubles hits), ajoute la musique seulement s'iels en ont nommé une, puis mix.py "WORK" (fait atterrir le mix à -16 LUFS).
6. render.py check "WORK" (corrige chaque erreur), render.py snap "WORK" <temps> --name <plan> et REGARDE les images que tu as modifiées. Dépose une image numérotée dans WORK/progress/ à chaque étape (les scripts font la plupart du travail).

7. Rendu et auto-évaluation avant de montrer quoi que ce soit

render.py render "WORK" --out "WORK/<Nom vidéo> - v1.mp4", puis qa.py "WORK" "<ce mp4>". Corrige chaque ÉCHEC. Ensuite regarde réellement chaque image qu'il liste (les planches contact à 2 ips et les plans serrés en pleine taille avec la zone de sécurité dessinée) : texte surchargé, visuels petits ou trop haut avec espace vide, légendes sur la bouche, même mise en page deux fois, quelque chose qui dépasse, quelque chose de noir, chiffres/noms qui ne correspondent pas aux mots. Les vérifications automatisées ratent des choses que l'œil attrape (le premier test de cette compétence a passé les vérifications avec un mot héros trouble et des demi-cartes vides). Un tour de correction, re-rendu, relance qa.py, puis open "<mp4>". Dis-leur en quelques lignes : où se trouve le fichier, combien de temps, ce qu'il se passe plan par plan, et tout ce que tu as deviné.

8. Boucle de feedback (à chaque fois qu'iels donnent une note)

Corrige-le, re-rends (un re-rendu prend ~20 s), relance qa.py, ouvre-le. ET écris-le dans leur style pour que le prochain montage le sache déjà : python3 "SK/scripts/feedback.py" "STYLE" --video <slug> --rule "<fais ça désormais>" (ou --rejected "<plus jamais ça>", --kept "<j'ai adoré ça>"). Utilise leurs mots, une note par indicateur ; une chose qu'iels ont aimée est aussi importante qu'une chose qu'iels ont détestée. Il sauvegarde d'abord STYLE.md et le journalise. Dis en une ligne ce que tu as ajouté. Si une note concerne une valeur verrouillée (le brillant, une courbe de zoom, l'ombre de la légende), dis qu'elle vit dans le laboratoire de leur page de style et propose de l'ouvrir plutôt que de passer outre le verrouillage en silence.

Temps (Mac série M, 15 s de Reel fini à partir d'environ 8 min de rushes)

prises ~1 min pour 5 min de rushes · coupe + mots ~15 s · images fixes du storyboard ~2 min · tranche de variation ~6 s chacune · rendu ~20 s · qa ~30 s.