Communitygithub.com

TheSmokeDev/taskchad-os

Traite des fichiers vidéo pour la création de contenu YouTube et génère des graphiques pour les réseaux sociaux : transcription de vidéos/clips en transcriptions horodatées avec sous-titres SRT et chapitres générés par IA, miniatures YouTube avec référence de visage, infographies pour publications LinkedIn, et images personnalisées pour toute plateforme avec dimensions flexibles.

Qu'est-ce que taskchad-os ?

Cette compétence permet de transformer des fichiers vidéo en contenu prêt à publier sur YouTube et les réseaux sociaux, en automatisant des tâches clés de production. Elle offre quatre capacités principales : la transcription de clips vidéo en transcriptions complètes avec sous-titres SRT et chapitres générés par IA via Gemini ; la génération de miniatures YouTube percutantes utilisant des références de visage, de style et même un échange de visage via Replicate pour une ressemblance exacte ; la création d'infographies professionnelles pour LinkedIn sans visage ; et un générateur d'images générique avec dimensions personnalisables pour Instagram, Twitter, Facebook, etc. L'outil s'appuie sur des API externes (OpenAI Whisper pour la transcription, Gemini pour la génération d'images, Replicate pour l'échange de visage) et nécessite Python 3.9+, le gestionnaire de paquets uv, et FFmpeg. Le SKILL.md fournit des instructions détaillées pour choisir le bon script en fonction de la plateforme, des paramètres de ligne de commande complets, et des bonnes pratiques pour la cohérence de marque, notamment pour les miniatures (palette de couleurs, tons de peau naturels, composition).

Compatible avec~Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/TheSmokeDev/taskchad-os/tree/HEAD/.claude/skills/video-processor

Demander à votre IA préférée

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

Documentation

Processeur Vidéo

Traite des fichiers vidéo pour la création de contenu YouTube et génère des graphiques pour les réseaux sociaux. Cette compétence offre quatre capacités principales :

  1. Transcription et chapitres : Convertit les clips vidéo en transcriptions horodatées, sous-titres SRT et chapitres YouTube générés par IA
  2. Génération de miniatures YouTube : Crée des miniatures YouTube alimentées par IA avec des références de visage et une correspondance de style
  3. Images pour publications LinkedIn : Génère des infographies et images professionnelles pour publications LinkedIn
  4. Génération d'images génériques : Crée des images personnalisées pour toute plateforme avec des dimensions et des prompts flexibles

Quand Utiliser Cette Compétence

Utilisez cette compétence lorsque l'utilisateur :

  • Souhaite transcrire des fichiers vidéo ou des clips
  • A besoin de générer des chapitres YouTube
  • Souhaite régénérer des chapitres à partir de transcriptions existantes
  • Veut créer des miniatures YouTube
  • Veut créer des images ou infographies pour publications LinkedIn
  • Souhaite générer des images pour d'autres plateformes (Instagram, Twitter, Facebook, etc.)
  • Mentionne l'échange de visage pour les miniatures
  • Demande à fournir des références de visage ou de style pour les graphiques

Choisir le Bon Outil de Génération d'Images

La compétence fournit trois scripts de génération d'images. Choisissez en fonction de la plateforme et des besoins :

Utilisez thumbnail.py (miniatures YouTube) lorsque :

  • L'utilisateur mentionne "YouTube", "miniature" ou "vignette vidéo"
  • Un rapport d'aspect 16:9 est demandé
  • Un style dramatique et accrocheur avec des visages est souhaité
  • Par défaut : 1920x1080

Utilisez linkedin-post.py (infographies LinkedIn) lorsque :

  • L'utilisateur mentionne "LinkedIn", "publication LinkedIn" ou "infographie professionnelle"
  • Une infographie au format carré est demandée
  • Un thème professionnel et sombre, sans visage
  • Par défaut : 1200x1200

Utilisez image-gen.py (générique) lorsque :

  • Des dimensions personnalisées sont spécifiées (Instagram, Twitter, Facebook, etc.)
  • La plateforme n'est ni YouTube ni LinkedIn
  • L'utilisateur demande explicitement un outil flexible/personnalisé
  • L'utilisateur fournit un prompt complet avec des exigences de style spécifiques
  • Paramètre requis : --dimensions LARGEURxHAUTEUR

Priorité : Préférez toujours thumbnail.py ou linkedin-post.py lorsque le cas d'usage correspond. Utilisez image-gen.py comme solution de repli pour les autres plateformes ou besoins personnalisés.

Installation et Prérequis

Le processeur vidéo se trouve dans le dossier video-processor/ du dépôt du projet.

Prérequis :

  • Python 3.9+
  • Gestionnaire de paquets uv
  • FFmpeg (pour la transcription)
  • Clé API OpenAI (pour la transcription Whisper)
  • Clé API Gemini (pour les chapitres et miniatures)
  • Jeton API Replicate (optionnel, pour l'échange de visage)

Configuration de l'environnement :

cd video-processor
uv sync
# Assurez-vous que .env existe avec les clés API nécessaires

1. Transcription Vidéo et Chapitres

Commande de Transcription de Base

Transcrivez des clips vidéo et générez une transcription, des sous-titres et des chapitres :

cd video-processor
uv run transcribe.py <chemin_du_dossier>

Exemple :

uv run transcribe.py ./ma-video-youtube/

Format d'Entrée

Les vidéos doivent se trouver dans un dossier avec des préfixes numériques pour l'ordre :

ma-video-youtube/
├── 1.mp4          # Introduction
├── 2.mp4          # Contenu principal
├── 3.mov          # Démonstration
└── 4.mp4          # Conclusion

Formats supportés : MP4, MOV, MKV, AVI, WEBM, M4V

Fichiers de Sortie

Le script génère trois fichiers dans le même dossier :

  1. transcript.md - Markdown avec horodatages

    # Transcription
    
    [00:00] Bon retour sur la chaîne...
    [00:15] Aujourd'hui, nous allons parler de...
    
  2. transcript.srt - Sous-titres SRT pour éditeurs vidéo/YouTube

    1
    00:00:00,000 --> 00:00:15,500
    Bon retour sur la chaîne...
    
  3. chapters.txt - Suggestions de chapitres YouTube (générées par IA)

    0:00 Introduction
    2:30 Configuration
    5:45 Tutoriel principal
    

Fonctionnalités

  • Support multi-clips : Traite les clips numérotés avec un calcul automatique du décalage temporel
  • Support des longues vidéos : Découpe automatiquement les vidéos de plus de 20 minutes (limite API)
  • Transcription horodatée : Format Markdown avec horodatages précis
  • Chapitres IA : Gemini génère des marqueurs de chapitres contextuels

Régénérer Uniquement les Chapitres

Si vous avez déjà une transcription et souhaitez régénérer les chapitres :

cd video-processor
uv run chapters.py <transcript.md ou chemin_du_dossier>

Exemples :

# Pointer directement vers le fichier de transcription
uv run chapters.py ./ma-video/transcript.md

# Ou pointer vers le dossier contenant transcript.md
uv run chapters.py ./ma-video/

Cas d'utilisation :

  • Ajuster les chapitres sans retranscrire
  • Régénérer après modification de la transcription
  • Utiliser un modèle Gemini différent

Remarques Importantes

  • Les clips doivent se trouver dans un dossier plat (pas de sous-dossiers)
  • Les vidéos sont traitées dans l'ordre numérique par préfixe de nom de fichier
  • Coût estimé : ~$0.006 par minute d'audio (API Whisper)
  • Les longues vidéos sont automatiquement découpées pour gérer les limites API
  • Connexion Internet requise

2. Génération de Miniatures

Commande de Base pour Miniature

Générez des miniatures YouTube alimentées par IA :

cd video-processor
uv run thumbnail.py "votre idée de miniature ici"

Comportement par défaut :

  • Génère 3 variantes
  • Sauvegarde dans : ./output/Thumbnails/[AAAA-MM-JJ]/
  • Utilise assets/face.jpg s'il existe
  • Sortie : fichiers PNG 1920x1080
  • Directives de marque : Consultez references/brand-guidelines.md pour la palette de couleurs, la composition et les meilleures pratiques de style

Paramètres de la Miniature

Requis

  • idea (positionnel) : Votre concept/idée de miniature

Options de Référence de Visage

  • --face CHEMIN : Spécifiez une image de référence de visage (par défaut : assets/face.jpg)
  • --no-face : N'inclure aucune référence de visage
  • --face-swap : Post-traitez avec Replicate pour échanger avec un vrai visage (nécessite REPLICATE_API_TOKEN)

Style et Références

  • --style CHEMIN : Image de style de référence pour la miniature - l'IA fait correspondre la mise en page et l'esthétique
  • --ref CHEMIN : Image de référence supplémentaire (peut être utilisée plusieurs fois)

Logo et Sortie

  • --logo CHEMIN : Logo à superposer sur la miniature
  • --logo-position [bottom-right|bottom-left|top-right|top-left] : Emplacement du logo (par défaut : bottom-right)
  • -o, --output CHEMIN : Répertoire ou chemin de fichier de sortie
  • --variations N : Nombre de variantes à générer (par défaut : 3)

Exemples de Miniatures

Basique - 3 variantes avec paramètres par défaut :

uv run thumbnail.py "réaction choquée aux licenciements massifs chez Google"

Avec référence de style :

uv run thumbnail.py "ma nouvelle idée de vidéo" --style ./miniature-existante.jpg --face ./moi.jpg

Avec échange de visage pour une ressemblance exacte :

uv run thumbnail.py "excité à propos de la nouvelle fonctionnalité IA" --face ./moi.jpg --face-swap

Variante unique pour test rapide :

uv run thumbnail.py "idée de test rapide" --variations 1

Répertoire de sortie personnalisé :

uv run thumbnail.py "mon concept vidéo" -o ./dossier-personnalise/

Sans visage (seulement la scène) :

uv run thumbnail.py "code dramatique à l'écran avec erreur" --no-face

Avec superposition de logo :

uv run thumbnail.py "mon concept vidéo" --logo ./assets/logo.png

Configuration de la Référence de Visage

Pour des miniatures cohérentes :

  1. Ajoutez votre(s) photo(s) de profil dans le dossier assets/ :

    video-processor/assets/
    ├── face.jpg           # Visage par défaut (chargé automatiquement)
    ├── face-excited.jpg   # Expressions alternatives
    ├── face-shocked.jpg
    └── logo.png           # Logo de la chaîne
    
  2. Le script utilise automatiquement assets/face.jpg s'il existe

  3. Remplacez avec --face pour différentes expressions

  4. Utilisez --no-face pour ignorer complètement la référence de visage

Références de Style

Le paramètre --style permet de faire correspondre l'esthétique des miniatures existantes :

  • Mise en page et composition globales
  • Schémas de couleurs et ambiance
  • Style du texte (poids de la police, couleurs, emplacement)
  • Style et effets d'arrière-plan

Idéal pour maintenir une image de marque cohérente sur la chaîne.

Directives de Marque et Bonnes Pratiques

IMPORTANT : Avant de générer des miniatures, lisez references/brand-guidelines.md pour :

  • Utilisation de la couleur bleue de la marque (comme accent, pas de manière dominante)
  • Exigences de teinte de peau naturelle (pas de teinte bleue sur le visage)
  • Palettes de couleurs équilibrées (mélange de couleurs vives)
  • Modèles de mise en évidence du texte (1-2 mots-clés en bleu)
  • Directives de composition (mise en page, flux visuel)
  • Exemples éprouvés issus de miniatures passées réussies

Ces directives garantissent que les miniatures maintiennent la cohérence de la marque tout en évitant les pièges courants comme la sursaturation ou l'éclairage non naturel.

Échange de Visage pour une Ressemblance Exacte

Les visages générés par IA peuvent ne pas être exacts. Utilisez --face-swap pour le post-traitement :

uv run thumbnail.py "mon idée de vidéo" --face ./moi.jpg --face-swap

Comment ça fonctionne :

  1. Génère la miniature avec l'IA (en utilisant le visage comme référence pour le positionnement)
  2. Post-traite avec Replicate pour échanger avec votre vrai visage

Configuration :

Spécifications des Miniatures

ÉlémentValeur
Résolution1920x1080 (1080p)
Rapport d'aspect16:9
FormatPNG (ou JPG avec --output .jpg)
Variantes par défaut3
ModèleGemini 3 Pro (Nano Banana Pro) par défaut

Remarques Importantes sur les Miniatures

  • Le modèle Gemini supporte les images de référence ; Imagen non
  • Coût : ~$0.13 par image avec Gemini 3 Pro
  • L'échange de visage ajoute ~$0.003 par miniature
  • 3 miniatures avec échange de visage : ~$0.40 au total
  • Connexion Internet requise

3. Génération d'Images pour Publications LinkedIn

Commande de Base pour Image LinkedIn

Générez des images et infographies pour publications LinkedIn alimentées par IA :

cd video-processor
uv run linkedin-post.py "votre concept de publication ici"

Comportement par défaut :

  • Génère 3 variantes
  • Sauvegarde dans : ./output/LinkedIn/[AAAA-MM-JJ]/
  • Sortie : fichiers PNG 1200x1200 (format carré LinkedIn)
  • Optimisé pour les mises en page d'infographies (pas de visage, fond blanc, design plat)

Paramètres de l'Image LinkedIn

Requis

  • idea (positionnel) : Votre concept/idée de publication LinkedIn

Style et Références

  • --style CHEMIN : Image de style de référence - l'IA fait correspondre la mise en page et l'esthétique
  • --ref CHEMIN : Image de référence supplémentaire (peut être utilisée plusieurs fois)

Logo et Sortie

  • --logo CHEMIN : Logo à superposer sur l'image
  • --logo-position [bottom-right|bottom-left|top-right|top-left] : Emplacement du logo (par défaut : bottom-right)
  • -o, --output CHEMIN : Répertoire ou chemin de fichier de sortie
  • --variations N : Nombre de variantes à générer (par défaut : 3)

Exemples d'Images LinkedIn

Basique - 3 variantes :

uv run linkedin-post.py "Pyramide de validation IA avec 5 niveaux montrant les responsabilités humain vs agent"

Avec référence de style :

uv run linkedin-post.py "mon concept d'infographie" --style ./infographie-existante.jpg

Variante unique pour test :

uv run linkedin-post.py "test rapide" --variations 1

Répertoire de sortie personnalisé :

uv run linkedin-post.py "mon concept" -o ./dossier-personnalise/

Avec superposition de logo :

uv run linkedin-post.py "mon infographie" --logo ./assets/logo.png

Spécifications des Images LinkedIn

ÉlémentValeur
Résolution1200x1200 (carré LinkedIn)
Rapport d'aspect1:1
FormatPNG (ou JPG avec --output .jpg)
Variantes par défaut3
ModèleGemini 3 Pro (Nano Banana Pro) par défaut
StyleInfographie professionnelle, sans visage, design plat

Remarques Importantes sur les Images LinkedIn

  • Optimisé pour les infographies professionnelles pour entreprises
  • Thème sombre avec esthétique moderne et épurée
  • AUCUN visage ou personne inclus (pur style diagramme/infographie)
  • Thème de couleur bleue avec dégradés
  • Densité d'information plus élevée que les miniatures YouTube
  • Coût : ~$0.13 par image avec Gemini 3 Pro
  • Connexion Internet requise

4. Génération d'Images Génériques

Commande de Base pour Image Générique

Générez des images alimentées par IA avec des dimensions personnalisées pour toute plateforme :

cd video-processor
uv run image-gen.py "votre concept d'image" --dimensions LARGEURxHAUTEUR

Fonctionnalités clés :

  • Dimensions personnalisées (paramètre requis)
  • Encapsulation minimale du prompt (flexibilité maximale)
  • Supporte les références de style
  • Sauvegarde dans : ./output/Images/[AAAA-MM-JJ]/
  • Par défaut : 3 variantes

Paramètres de l'Image Générique

Requis

  • idea (positionnel) : Votre concept d'image avec les détails complets du prompt
  • --dimensions LARGEURxHAUTEUR : Dimensions de l'image (ex. : 1080x1080, 1200x675)

Style et Références

  • --style CHEMIN : Image de style de référence - l'IA fait correspondre l'esthétique
  • --ref CHEMIN : Image de référence supplémentaire (peut être utilisée plusieurs fois)

Logo et Sortie

  • --logo CHEMIN : Logo à superposer sur l'image
  • --logo-position [bottom-right|bottom-left|top-right|top-left] : Emplacement du logo (par défaut : bottom-right)
  • -o, --output CHEMIN : Répertoire ou chemin de fichier de sortie
  • --variations N : Nombre de variantes à générer (par défaut : 3)

Exemples d'Images Génériques

Publication carrée Instagram :

uv run image-gen.py "photo de produit minimaliste sur fond blanc" --dimensions 1080x1080

Story Instagram :

uv run image-gen.py "design de citation motivante verticale" --dimensions 1080x1920

Image pour publication Twitter :

uv run image-gen.py "graphique d'annonce tech avec thème bleu" --dimensions 1200x675

Photo de couverture Facebook :

uv run image-gen.py "en-tête professionnel pour entreprise" --dimensions 820x312

Avec référence de style :

uv run image-gen.py "mon concept" --dimensions 1200x1200 --style ./reference.jpg

Référence des Dimensions Courantes

PlateformeTailleRapport d'aspectCommande
Miniature YouTube1920x108016:9Utilisez thumbnail.py à la place
Carré LinkedIn1200x12001:1Utilisez linkedin-post.py à la place
Carré Instagram1080x10801:1--dimensions 1080x1080
Story Instagram1080x19209:16--dimensions 1080x1920
Publication Twitter1200x67516:9--dimensions 1200x675
Publication Facebook1200x6301.91:1--dimensions 1200x630
Épingle Pinterest1000x15002:3--dimensions 1000x1500

Remarques Importantes sur les Images Génériques

  • Utilisation recommandée lorsque les autres outils ne correspondent pas à la plateforme
  • Flexibilité maximale avec un contrôle total des dimensions et du prompt
  • Idéal pour créer des actifs visuels uniques pour le contenu des réseaux sociaux
  • Supporte plusieurs images de référence pour une esthétique cohérente
  • Coût : ~$0.13 par image avec Gemini 3 Pro
  • Connexion Internet requise

Variables d'Environnement

Créez un fichier .env dans le dossier video-processor/ avec les clés suivantes :

OPENAI_API_KEY=sk-votre_clé_ici
GEMINI_API_KEY=votre_clé_gemini_ici
REPLICATE_API_TOKEN=r8-votre_jeton_ici  # Optionnel, pour l'échange de visage

Structure du Projet

video-processor/
├── video-processor/       # Code source et scripts
│   ├── transcribe.py      # Script de transcription
│   ├── chapters.py        # Script de génération de chapitres
│   ├── thumbnail.py       # Script de génération de miniatures
│   ├── linkedin-post.py   # Script de génération d'images LinkedIn
│   ├── image-gen.py       # Script de génération d'images générique
│   └── ...
├── assets/                # Fichiers de référence (visages, logos)
│   ├── face.jpg
│   ├── face-excited.jpg
│   ├── face-shocked.jpg
│   └── logo.png
├── references/            # Documentation supplémentaire
│   └── brand-guidelines.md
├── output/                # Images générées
│   ├── Thumbnails/
│   ├── LinkedIn/
│   └── Images/
├── pyproject.toml
└── .env                   # Clés API

Notes de Coût

ServiceCoût
Whisper API (transcription)~$0.006/minute audio
Gemini 3 Pro (images)~$0.13/image
Replicate (échange de visage)~$0.003/échange
Total pour 3 miniatures + échange de visage~$0.40

Skills associés