Communitygithub.com

tatacardona/Reels-FR-Doc-Juanes

Édite des vidéos brutes de Futuros Residentes / Doc Juanes (personne parlant face caméra, scripts enregistrés) et les transforme en Reels verticaux dynamiques 9:16 avec Remotion. Coupe les claps, les prises ratées, les répétitions et les silences, nettoie l'audio, ajoute des sous-titres mot par mot avec accentuation colorée qui ne cache jamais le visage, change de plan à chaque coupe et, si demandé, ajoute des photos superposées (même déchirées), des emojis/autocollants avec effets sonores, des éclats de lumière dans les transitions et de la musique libre de droits. Fonctionne sur Mac et Windows.

Qu'est-ce que Reels-FR-Doc-Juanes ?

Cette compétence spécialisée automatise la création de vidéos courtes verticales (Reels, Shorts, TikTok) au format 9:16 à partir d'enregistrements bruts de type 'talking head' pour les marques Futuros Residentes et Doc Juanes. Elle repose sur Remotion (framework React de rendu vidéo) et une série de scripts Python pour le prétraitement audio et vidéo. L'utilisateur n'a pas besoin de compétences techniques : la compétence planifie chaque étape, demande validation avant d'exécuter, et gère l'ensemble du workflow (transcription, coupe, sous-titrage stylisé, ajout d'effets visuels et sonores). Elle est conçue pour être utilisée via Claude Code sur Mac ou Windows, avec des vérifications automatiques sur l'environnement (Node.js, Python 3.11+, ffmpeg). La compétence suit un style éditorial précis défini dans des fichiers de référence, et intègre une gestion des tokens pour maîtriser les coûts API. Elle permet de produire des vidéos professionnelles prêtes pour les réseaux sociaux, avec des options avancées comme le suivi de visage, les arrière-plans floutés, les éclairages artificiels et les effets de transition dynamiques.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add tatacardona/Reels-FR-Doc-Juanes

Demander à votre IA préférée

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

Documentation

É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.mp4 et NOM_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 dans out/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).
  • 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 ClaudeCoût approx.
Préparer, transcrire et présenter le plan15-251-2 US$
Propositions visuelles (polices, couleur, lumière) avec échantillons8-151-1,5 US$
Monter l'édition, texte à approuver et exporter la v120-352-3 US$
Chaque série de modifications + nouvelle exportation10-251-2,5 US$
Chercher et ajuster la musique10-201-2 US$
3 couvertures8-151-1,5 US$
Vidéo complète typique (plan, v1, 2 séries, couvertures)80-1307-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.11 et winget 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, consulte references/problemas.md et raconte-le à Janeth.

Étape 1 : Projet Remotion

  • Projets dans $PROJETS/<MARQUE>/NOM_COURT, avec <MARQUE> = Doc Juanes ou FR (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.css et src/Root.tsx d'un projet précédent, et node_modules (Mac : cp -c -R, clonage instantané ; Windows : npm ci). Sans projet précédent : npx create-video@latest (Blank, Tailwind Yes), npm i et npm i @remotion/google-fonts@<version de remotion>.
  • Modèle et scripts : cp -R ~/.claude/skills/editar-reel-fr/assets/template/src/Reel src/Reel et mkdir -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

  1. Extrais un photogramme ("$FF" -ss 20 -i crudo -frames:v 1 x.jpg) et regarde-le : orientation (si la personne sort de côté utilise ccw/cw), couleur du mur (décide la couleur des mots-clés) et position du visage (FACE_ORIGIN).
  2. FF="$FF" ./scripts/prep.sh "<crudo>" <none|ccw|cw> → public/video-vertical.mp4 (avec la courbe d'éclairage qui éclaircit les ombres ; LIGHT=0 la retire) + audios dans work/.
  3. 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.py sépare la personne avec IA et crée public/video-fond.mp4 avec fond flouté, lumière de remplissage qui suit le visage et, si souhaité, lumières colorées type vitrail sur le mur. Ajustements dans edit-config.json → "fond" (voir l'en-tête du script) ; il s'exécute après build-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 avec VIDEO_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, voir estilo.md), flash (éclat blanc). zoom fixe 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 dans assets/edit-config.stickers.exemple.json) : {kind, show_at, hide_at, x, y, size, sfx: [[fichier, sec, volume]]}. Types : broken-heart (break_at) et dessins de ART dans src/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: true donnent 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) et EMPH2_* (seconde, mots marqués "alt" dans emphasis) dans constants.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.

Skills associés