Éditer un Reel de Futuros Residentes / Doc Juanes
Avant de prendre une décision éditoriale, lis references/estilo.md : c'est le style approuvé et la raison de chaque règle. Si quelque chose échoue, consulte references/problemas.md : presque tout ce qui peut mal tourner est déjà arrivé une fois. Pour la musique, references/musica.md.
Comment travailler avec la personne qui demande la vidéo
- Écris-lui en espagnol, clairement et sans jargon technique. Il se peut qu'elle ne programme pas : explique-lui ce que tu vois et ce que tu vas faire.
- Avant d'exécuter, résume le plan d'action et attends son approbation, toujours, à chaque étape (plan initial, chaque série de modifications, couvertures, musique). Le résumé comprend deux critères : l'audiovisuel (ce qui sera fait, étape par étape) et le financier : la projection de consommation de tokens (voir "Consommation de tokens"). Tu peux préparer et transcrire la vidéo brute avant, pour que le plan soit concret.
- Tu ne peux pas écouter l'audio. Vérifie avec des mesures et des retranscriptions, et demande-lui d'écouter ce qui est subjectif : effets sonores, volume de la musique et coupes très serrées.
- Montre-lui des photogrammes et le MP4 à chaque version. Quand il/elle demande une modification, situe-la à la seconde de la vidéo ÉDITÉE mentionnée (mappe avec
src/Reel/edit.json) et confirme quelle phrase c'est. - Marque : dans le plan, confirme si la vidéo est de Doc Juanes ou de Futuros Residentes (FR). Définit le dossier du projet et l'espace Google Chat où l'on prévient (Étape 9).
- Noms : dans le plan, propose (ou demande) un NOM_COURT en majuscules avec des tirets bas (ex.
JUANCHO_PASASTE) ; c'est aussi le nom du dossier du projet.- Pendant la révision : chaque version avec un numéro pour qu'il/elle ne voie pas une version ancienne ("je ne perçois pas de changements") :
NOM_COURT_REEL_v2.mp4,NOM_COURT_COUVERTURE_1.jpg… Dans Téléchargements, seulement la dernière version. - Quand la version définitive est approuvée, renomme-les en supprimant tout le reste, y compris le numéro :
NOM_COURT_REEL.mp4etNOM_COURT_COUVERTURE.jpg, et retire des Téléchargements les versions et couvertures écartées. - Couverture : dès qu'il/elle en choisit une, renomme-la immédiatement en
NOM_COURT_COUVERTURE.jpg(sans numéro), dans Téléchargements et dansout/couvertures/, même si la vidéo est encore en révision, et retire les autres options. Si ensuite il/elle demande des ajustements à celle choisie, écrase ce même fichier sans numéro. - Images de test que tu lui envoies (polices, couleurs, lumière, effets, photogrammes de révision) :
NOM_COURT_TEST_<SUJET>_N.jpg(ex.NOM_COURT_TEST_POLICES_1.jpg). Lors de l'approbation de la version définitive, retire-les comme les versions écartées : seuls restent le REEL et la COUVERTURE. - Ne supprime jamais de fichiers de la personne avec
rm: utilise./scripts/poubelle.sh <fichiers>(Corbeille du Mac ou Corbeille de Windows ; ils peuvent être récupérés).
- Pendant la révision : chaque version avec un numéro pour qu'il/elle ne voie pas une version ancienne ("je ne perçois pas de changements") :
- Musique : toutes les vidéos n'en ont pas ; seulement si elle est demandée. Ne répète jamais une chanson déjà utilisée (liste dans
references/musica.md), sauf si Janeth autorise à la recycler. - Les programmes interactifs (comme
npx create-video) s'exécutent dans un onglet du panneau Terminal : dis-lui de cliquer sur l'onglet et de répondre là, en lui expliquant chaque question.
Qui peut modifier cette compétence
La compétence vit sur GitHub (github.com/tatacardona/Reels-FR-Doc-Juanes) et seule Janeth Cardona la modifie. Pour savoir sur quel ordinateur tu es : git -C ~/.claude/skills/editar-reel-fr config user.email.
- Si la réponse est
[email protected](ordinateur de Janeth) : avant de modifier la compétence, demande-lui toujours et attends son oui ; dis-lui en une ligne ce que tu changerais et pourquoi cela sert toutes les vidéos (si elle-même demande le changement, c'est déjà approuvé). Ce qui est spécifique à une vidéo (chanson, timings, positions, volumes) va uniquement dans son projet, jamais dans la compétence. Après l'avoir modifiée :git -C ~/.claude/skills/editar-reel-fr add -A && git commit -m "<ce qui a changé>" && git push. - Sur tout autre ordinateur : ne modifie jamais les fichiers de la compétence. Si tu découvres une amélioration ou un problème qui sert tout le monde, dis à la personne de le raconter à Janeth et écris-lui le texte à lui envoyer (ce qui s'est passé, sur quelle vidéo et ce que tu proposes).
- Les chansons utilisées sont notées dans
references/musica.md; sur d'autres ordinateurs, transmets à Janeth le titre, l'artiste et le lien pour qu'elle les ajoute.
Consommation de tokens (les comptes sont partagés par toute l'équipe)
Chaque étape de Claude relit toute la conversation : c'est presque tout le coût et il augmente avec sa longueur. C'est pourquoi :
- Une nouvelle conversation par vidéo. Lors de l'approbation d'une vidéo, suggère d'ouvrir une nouvelle conversation pour la suivante. Continuer dans la même peut coûter 2 à 3 fois plus.
- Modifications en lot : demande-lui de rassembler toutes ses corrections en un seul message numéroté, et applique-les en une seule exportation.
- Lis peu et petit : des séquences de photogrammes réduites (
SCALE=0.25-0.35), seulement la partie nécessaire des fichiers et sorties (tail,grep), retranscris seulement le segment douteux. Les grandes images coûtent cher. - Attentes sans demander : les exportations longues se font en arrière-plan ; ne vérifie pas toutes les minutes.
- Sans étapes qui n'ont pas été demandées : autocollants, musique, fond avec IA ou recherches supplémentaires seulement s'ils sont demandés.
Projection dans chaque plan (chiffres mesurés sur des vidéos réelles de 30 à 45 s ; coût au tarif public de l'API avec Claude Opus 5.5, dans une nouvelle conversation). Affiche un court tableau avec les étapes du plan, leur fourchette et le total, et précise que c'est approximatif :
| Étape | Étapes de Claude | Coût approx. |
|---|---|---|
| Préparer, transcrire et présenter le plan | 15-25 | 1-2 US$ |
| Propositions visuelles (polices, couleur, lumière) avec échantillons | 8-15 | 1-1,5 US$ |
| Monter l'édition, texte à approuver et exporter la v1 | 20-35 | 2-3 US$ |
| Chaque série de modifications + nouvelle exportation | 10-25 | 1-2,5 US$ |
| Chercher et ajuster la musique | 10-20 | 1-2 US$ |
| 3 couvertures | 8-15 | 1-1,5 US$ |
| Vidéo complète typique (plan, v1, 2 séries, couvertures) | 80-130 | 7-12 US$ |
Avec le plan Team/Enterprise, la facture peut être différente ; le chiffre sert à comparer les options. Si la personne veut économiser, propose-lui des alternatives concrètes (moins de séries, pas de musique, pas de nouvelles couvertures, ou utiliser un modèle plus économique pour une vidéo simple) ; la décision lui appartient.
À la clôture de chaque vidéo, mesure la consommation réelle avec python3 scripts/consommation.py --depuis "<texte du premier message de la vidéo>" et partage-la avec la projection. Si la différence est grande et que tu es sur l'ordinateur de Janeth, propose d'ajuster ce tableau.
Étape 0 : Outils (une fois par machine) et mise à jour de la compétence
git -C ~/.claude/skills/editar-reel-fr pull -q # récupère la dernière version de la compétence (chaque vidéo)
source ~/.claude/skills/editar-reel-fr/scripts/setup-tools.sh # exporte $PY, $FF, $PROJETS, $TELECHARGEMENTS
Installe ffmpeg complet, faster-whisper, DeepFilterNet (supprime l'écho) et OpenCV dans un environnement dédié. La première transcription télécharge le modèle large-v3-turbo (~1,6 Go) : demande la permission avant.
- Mac : a besoin de Node.js et Python 3 (ils viennent avec les outils Xcode ou s'installent une fois).
- Windows : Claude Code utilise Git Bash, et ces programmes fonctionnent là. Avant, une seule fois, installe Python 3.11 et Node.js LTS (
winget install Python.Python.3.11etwinget install OpenJS.NodeJS.LTS, avec la permission de la personne ; Python 3.12 ou plus récent ne fonctionne pas). Si quelque chose échoue sur Windows, consultereferences/problemas.mdet raconte-le à Janeth.
Étape 1 : Projet Remotion
- Projets dans
$PROJETS/<MARQUE>/NOM_COURT, avec<MARQUE>=Doc JuanesouFR(Mac : Films → Reels Doc Juanes ; Windows : Vidéos → Reels Doc Juanes), un par vidéo. Projets précédents à copier : dans ces deux sous-dossiers. - Le plus rapide : copie
package.json,package-lock.json,tsconfig.json,remotion.config.ts,src/index.ts,src/index.cssetsrc/Root.tsxd'un projet précédent, etnode_modules(Mac :cp -c -R, clonage instantané ; Windows :npm ci). Sans projet précédent :npx create-video@latest(Blank, Tailwind Yes),npm ietnpm i @remotion/google-fonts@<version de remotion>. - Modèle et scripts :
cp -R ~/.claude/skills/editar-reel-fr/assets/template/src/Reel src/Reeletmkdir -p scripts && cp ~/.claude/skills/editar-reel-fr/scripts/* scripts/. - Enregistre la composition (voir
assets/template/Root.snippet.tsx) et"resolveJsonModule": true.
Étape 2 : Préparer la vidéo brute
- Extrais un photogramme (
"$FF" -ss 20 -i crudo -frames:v 1 x.jpg) et regarde-le : orientation (si la personne sort de côté utiliseccw/cw), couleur du mur (décide la couleur des mots-clés) et position du visage (FACE_ORIGIN). FF="$FF" ./scripts/prep.sh "<crudo>" <none|ccw|cw>→public/video-vertical.mp4(avec la courbe d'éclairage qui éclaircit les ombres ;LIGHT=0la retire) + audios danswork/.- Si on demande d'améliorer le fond ou la lumière (fond chargé, visage sombre à cause d'une lumière d'en haut) :
scripts/fond-lumiere.pysépare la personne avec IA et créepublic/video-fond.mp4avec fond flouté, lumière de remplissage qui suit le visage et, si souhaité, lumières colorées type vitrail sur le mur. Ajustements dansedit-config.json→"fond"(voir l'en-tête du script) ; il s'exécute aprèsbuild-edit.py(ne traite que les segments utilisés ; relance-le si les segments changent, sinon ces images sortiront non traitées) et s'active avecVIDEO_SRC = "video-fond.mp4". Montre-lui d'abord un photogramme de test. Le style préféré est subtil : flou léger (5), bord très doux (14) et vitrail/bokeh très ténu.
Étape 3 : Transcrire et mapper
"$PY" scripts/transcrire.py # phrases avec temps → work/transcription.json
"$PY" scripts/energie.py mots # volume de chaque mot vs. sa phrase (+dB = emphase)
Élabore la carte éditoriale et raconte-la dans une courte liste :
- Hors : clap ("Prêt, scénario N…"), prises ratées ("encore", gros mots, rires), phrases répétées (garde la prise la plus propre ; c'est généralement la dernière), faux départs, fermeture ("prêt").
- Accroche : la première phrase forte ; elle va en premier.
- Mots étirés (ex. "non" de 3 s), mots rares ou voix non transcrite = prises répétées ou faux départs : retranscris ces segments isolés (WhisperModel sur le morceau d'audio) et affine avec
energie.py zoom <début> <fin>. - Si le script contient une donnée erronée (un chiffre mal dit), propose de le couper ; n'imite jamais la voix avec IA.
Étape 4 : Audio
FF="$FF" PY="$PY" ./scripts/audio.sh # voix avec moins d'écho et naturelle (DeepFilterNet + expanseur doux, −14 LUFS)
"$PY" scripts/energie.py # mesure sur la voix propre → coupes plus serrées
"$PY" scripts/sfx-autocollants.py # seulement s'il y aura des autocollants avec son
"$PY" scripts/sfx-dechirure.py # seulement s'il y aura une photo déchirée
Étape 5 : edit-config.json : les décisions éditoriales
Base : assets/edit-config.exemple.json. Tous les temps en secondes de la vidéo BRUTE :
clips: un segment par phrase ou idée, dans l'ordre, avec marge large. Le script coupe les silences à l'intérieur et à l'extérieur, sans jamais couper un mot.fx:punch(continuation),whoosh(changement de sujet),leak(éclat de lumière solaire avec couleurs ; pour les vidéos inspirantes, voirestilo.md),flash(éclat blanc).zoomfixe le plan d'un segment ;steps: [[sec, zoom], …]est une échelle de plans sans couper l'audio.hold_zoom: true= un seul plan.tail: 0.1= marge supplémentaire à la fin du segment si la coupe mange une consonne finale douce.emphasis:[mot, seconde]des mots dits avec force ou clés (~1 tous les 1,5-2 s).word_fixes: temps réels d'un mot. Après, confirme qu'il est DANS le segment (s'il tombe dans le silence précédent, il disparaît du sous-titre).idea_start: majuscule de début d'idée (affecte tout mot à < 0,1 s : si le suivant est très proche, comme "Y no", utilise un temps juste avant le premier).text_fixes:[{"at": sec, "text": "pregunta:"}]texte exact d'un mot (ex. conserver ":").brand_words(protège "Futuros Residentes", "Doc Juanes" ; ajoute d'autres comme "UdeA"),small_extra(mots courts qui ne vont jamais seuls : "fue", "esa", "mi", "tan"…).photos:{src, show_at, tear_at}(se déchire) ou{src, show_at, hide_at}.stickers(seulement s'ils sont demandés ; exemple dansassets/edit-config.stickers.exemple.json) :{kind, show_at, hide_at, x, y, size, sfx: [[fichier, sec, volume]]}. Types :broken-heart(break_at) et dessins deARTdanssrc/Reel/Stickers.tsx. Pour un nouveau, dessine-le comme SVG propre (jamais d'emojis d'Apple ni d'images avec droits). Place-les là où la personne bouge les mains (regarde des photogrammes), jamais sur le visage ni les sous-titres. Si un effet doit suivre la tête,"$PY" scripts/suivi-tete.py <début> <fin>+follow_head: truedonnent sa position image par image (track).sounds:[[fichier, sec, volume, décalage_sec]];shakes: secondes avec secousse (impacts).end_push: {at, to}: fermeture par défaut, rapprochement doux du visage (~1,6) sans fondu au noir.end_hold: secondes supplémentaires à la fin.speed: si on demande d'accélérer (voir Étape 7).- Police de base (mots normaux) : Montserrat Black 900, blanche avec bord noir, sauf si la marque de la vidéo en demande une autre (ex. vidéos de Futuros Residentes avec la police de leur site web).
- Mots accentués : propose-les dans le plan selon l'ambiance de la vidéo, avec 2-3 options sur un
photogramme réel : une seule police ou deux polices (ex. une élégante/serif pour l'émotionnel et une
grosse pour l'impact), avec la même couleur ou des couleurs différentes. Polices et couleurs en accord
avec l'ambiance (inspirant, nostalgique, énergique, comique…).
EMPH_*(première) etEMPH2_*(seconde, mots marqués"alt"dansemphasis) dansconstants.ts. La couleur doit contraster avec le mur. echo:[[début, fin]]écho doux dans une phrase de transcendance (après :"$PY" scripts/echo.py). Propose-le si tu détectes une telle phrase, ou applique-le si on te le demande.