Communitygithub.com

editor-videos-1porciento

Édite des vidéos de caméra (talking-head) pour Instagram, TikTok et YouTube Shorts avec le template « 1% » : sous-titres de marque avec mots-clés en couleur, coupures de silences, zoom dynamique, motion graphics déclenchés par mot, musique personnalisée avec ducking, entrée et sortie de marque et couverture. Formats story/reel 9:16 (1080×1920) et feed 4:5 (1080×1350).

Qu'est-ce que editor-videos-1porciento ?

Ce skill Python permet de réaliser un montage vidéo professionnel de type « talking-head » optimisé pour les réseaux sociaux (Instagram, TikTok, YouTube Shorts) en utilisant le template « 1% ». Il traite une vidéo brute et un fichier de configuration JSON pour produire une vidéo finale en haute qualité ainsi qu’une image de couverture. Le pipeline couvre la transcription Whisper, le découpage des silences, l’ajout de sous-titres avec des mots-clés en couleur d’accent, des zooms dynamiques, des motion graphics déclenchés sur des mots spécifiques, une musique générée sans droit d’auteur avec ducking automatique lors des parties parlées, et une plaque d’entrée/sortie de marque. Il gère les formats 9:16 (story/reel) et 4:5 (feed). Les scripts sont fournis dans le dossier `scripts/` du skill. L’utilisateur doit d’abord préparer un `config.json` (en copiant un exemple), transcrire l’audio, corriger manuellement le fichier de mots, définir les coupures de silence, puis lancer les commandes de prévisualisation et de rendu. Le skill s’exécute en ligne de commande et ne nécessite aucun logiciel de montage visuel.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/pasu1049-hash/kit-edicion-video-claude/tree/HEAD/skills/editor-videos-1porciento

Demander à votre IA préférée

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

Documentation

Éditeur de vidéos — template 1%

Pipeline en Python (sans logiciel de montage) : la vidéo brute + un config.json → vidéo finale en qualité maximale + _PORTADA.png. Les scripts se trouvent dans scripts/ de ce skill. Les sorties et le dossier work/ sont créés dans le dossier depuis lequel vous exécutez la commande (utilisez un dossier par projet).

0. Avant de commencer (une seule fois)

  • Lisez MARCA.md de ce skill : couleur d'accent, nom de marque, pseudo, phrases. S'il est incomplet, demandez ces données à l'utilisateur et complétez-le.
  • Dépendances : pip install -r scripts/requirements.txt (numpy, pillow, imageio-ffmpeg, faster-whisper). La première transcription télécharge le modèle Whisper « medium » (~1,5 Go).

Raccourci : dans les commandes ci-dessous, S = chemin vers scripts/ de ce skill (ex. ~/.claude/skills/editor-videos-1porciento/scripts).

1. Flux par vidéo

  1. Configuration : copiez ejemplos/historia_ejemplo.json (9:16) ou ejemplos/feed_ejemplo.json (4:5) dans le dossier du projet et complétez video, words, salida, marca, acento, cierre, portada.
    • recorte : zone de la vidéo originale à utiliser (x, y, w, h en pixels de l'original). Doit respecter les proportions du format (9:16 story, 4:5 feed). Mesurez la taille de l'original avec ffprobe d'abord.
  2. Transcrire : python S/editar_video.py transcribir config.json → génère le fichier words.json avec le temps par mot.
  3. Corriger manuellement le words.json : noms propres, marques, nombres (« 1% »), expressions. Enregistrez-le sous *_words_ok.json et pointez le config vers ce fichier. Ajoutez dans le config "vocabulario" avec les noms qui se répètent pour que Whisper les identifie correctement.
  4. Silences : python S/auto_cortes.py video.mov 0.12 → imprime la liste des cortes (mesurée par énergie audio, PAS avec les temps de Whisper). Collez-la dans "cortes". Si une coupure tombe entre deux parties d'un même mot, supprimez-la.
  5. Mots-clés (claves) : les mots qui sont colorés avec la couleur d'accent dans les sous-titres. Écrivez-les exactement comme ils apparaissent dans le words.json (avec la ponctuation attachée, ex. "tiempo.").
  6. Motion graphics (motion) : utilisez-les TOUJOURS par défaut, 3 à 6 par vidéo, aux moments forts du script. Voir tableau ci-dessous.
  7. Zoom (zoom) et musique (musica) : activés par défaut.
  8. Vérifier les images avant le rendu long : python S/editar_video.py preview config.json 4.5 → work/_prev_4.5.jpg (seconde de la vidéo finale). Vérifiez les sous-titres, motion graphics et le cadrage du visage.
  9. Rendu : python S/editar_video.py render config.json → salida.mp4 + salida_PORTADA.png.
  10. Examinez des images du résultat (ffmpeg select de 3-4 images en une bande) avant de livrer. Une fois terminé, ouvrez le dossier avec les vidéos pour l'utilisateur.

Si l'utilisateur demande story ET feed, faites deux configs (même words.json, format/cadrage/position des sous-titres différents). On peut les rendre en parallèle avec 8 Go de RAM.

2. Règles que nous avons apprises (ne pas sauter)

  • Transcrire sans VAD (déjà configuré dans le script) : avec VAD, on perd la première phrase.
  • Vidéos iPhone HDR (HLG, 4K60) : NE PAS appliquer de tonemap avec zscale (introduit des artefacts). La vidéo brute avec l'égalisation douce du script donne un bon rendu.
  • Qualité maximale toujours : H.264 crf 14 preset slow, audio AAC 320k, voix normalisée à -14 LUFS. Ne réduisez pas la qualité pour réduire le poids, sauf demande explicite.
  • Position des sous-titres : subs_y ~1300 en story (zone sécurisée IG), ~1060 en feed. Les motion graphics sont placés en haut, loin du visage et des sous-titres.
  • Textes à l'écran : courts, en MAJUSCULES, directs. Pas de longues phrases.

3. Référence du config

clédescription
formato"historia" (1080×1920) ou omis = feed (1080×1350)
video, words, salidachemins de la vidéo brute, du words.json et du mp4 final
recorte{x,y,w,h} de l'original
pre / postsecondes de silence avant le premier mot / après le dernier
subs_yhauteur des sous-titres
clavesmots en couleur d'accent
cortes[[ini, fin], ...] en secondes de l'original, supprimés
acentocouleur de marque [R,G,B] (défaut corail [255,104,74])
marcanom de la marque (plaque d'entrée/sortie et couverture)
logochemin vers un PNG carré du logo (couverture, optionnel)
logo_ledphoto d'un panneau néon avec le logo → entrée/sortie « LED ». Sans cela, on utilise la plaque de couleur
placaentrée/sortie personnalisés : {"marca","color","kicker","filas":[...],"pie","size","entrada","cierre"}
sin_introtrue = démarre directement avec la vidéo
cierre{"titulo":[...],"by","fecha","plataformas","handle"} (sortie LED) — avec plaque, on utilise by, fecha, handle
cierre_segdurée de la sortie
portada{"segundo","kicker","titulo":[lignes],"size","fecha","pie"}
zoom`{"push":0.05,"cortes":0.08,"cara":[x,y],"punch":[{"palabra","hasta"
musica{"bpm":92,"seed":3,"vol":0.2,"ducking":0.75} — beat généré (sans droits d'auteur), baisse automatiquement quand il y a de la voix. Changez seed pour une autre variation
vocabulariotexte avec noms propres pour aider Whisper

Motion graphics (motion : liste d'événements)

Chaque événement : {"tipo", "palabra", "hasta" ou "dur", "extra", "txt", "pos":[x,y], "size", "rot", "anim", "escala", "offset"}. pos = centre de l'élément dans l'image finale. Il apparaît quand palabra est dite (si elle se répète, "n": 2 = deuxième occurrence) et disparaît avec hasta (+ extra s) ou après dur s. anim : "pop" (défaut), "slide" (avec "desde" px), "slam".

typedescriptionchamps propres
textogrand texte avec contourtxt, size, coral:true = couleur d'accent
chipétiquette arrondietxt, size, claro
sellotampon incliné comme un timbretxt, size, rot
slamgrand nombre/mot qui frappetxt, size
calendariofeuille de calendriertxt (jour), big (nombre), sub
envivobadge « EN VIVO »txt
plataformabadge de réseau social avec sa couleur (TIKTOK, YOUTUBE, KICK ; autre texte = badge sombre)txt
contadornombre qui comptevoir motion.py
misteriopanneau d'invité avec point d'interrogationlineas

Chaque motion graphic amène automatiquement son effet sonore.

4. Showreel (clips sans voix au rythme de la musique)

python S/showreel.py config.json — config avec clips (chaque clip dure beats temps et peut avoir label), bpm, formato, etiqueta_y, textos, placa, seed, vol. Avant d'en créer un, lisez main() dans showreel.py pour voir les champs exacts de chaque clip.

5. Quand utiliser un autre outil

  • Animations/motion design plus complexes (titres animés, explications, intros 3D, graphiques) : skill hyperframes (routeur officiel de HyperFrames).
  • Montage long pour YouTube, couper erreurs/répétitions, storytelling : skills du kit de Nate Herk (edit-video, cut-mistakes, short-form-edit, video-storytelling), exécutés depuis le dossier du kit.

Skills associés