Communitygithub.com

training-video

Montre à l'agent comment planifier, construire ou monter une «vidéo de formation» pour obtenir un texte ou un script utilisable. La procédure passe par Обучително видео, Четири одобрения — без тях не харчиш пари и време, Ход. Utilisez-la lorsqu'une nouvelle mission nécessite ce savoir-faire.

Qu'est-ce que training-video ?

Cette compétence permet à un agent d'IA de guider un humain dans la création complète d'une vidéo de formation professionnelle, depuis l'analyse du projet jusqu'à la livraison du fichier final. Elle impose un processus en quatre étapes d'approbation (scénario, coût, échantillon vocal, visuel) avant de dépenser du temps ou de l'argent dans la production. La compétence fonctionne sur macOS et Windows, avec des scripts Python et Node.js, et s'appuie sur les services Google Gemini (ou Vertex) pour la synthèse vocale. Le workflow inclut la configuration de l'environnement, l'extraction de contenu à partir de PDFs ou de code, la rédaction d'un script, la génération audio, le rendu visuel (diapositives ou enregistrement d'écran), et la création de sous-titres multilingues, le tout avec un ton professionnel et corporatif.

Compatible avec✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/erida-ai/training-video/tree/HEAD/skills/training-video

Demander à votre IA préférée

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

Documentation

Vidéo de formation

La voix guide, l'image suit : d'abord le script et le son, puis les diapositives ou l'enregistrement, synchronisés sur la longueur de chaque réplique.

À qui tu parles. La personne peut ne pas être technique : elle parle bulgare (ou la langue dans laquelle elle t'écrit), avec des mots simples, sans commandes ni chemins, sauf si elle demande. Les étapes techniques, c'est toi qui les fais. Ne demande que les décisions qui lui appartiennent : contenu, public, langue, visuel, approbations.

Les scripts sont dans ${CLAUDE_SKILL_DIR}/scripts/ et s'exécutent avec python3 -B ${CLAUDE_SKILL_DIR}/scripts/<script>.py … — sur Windows, à la place de python3, utilise la commande que doctor.py indique à la ligne « Python command » (python ou py -3) ; les diapositives et le rendu — node ${CLAUDE_SKILL_DIR}/deck/render.cjs … ; l'enregistrement d'application — ${CLAUDE_SKILL_DIR}/screencast/. Les thèmes sont dans ${CLAUDE_PLUGIN_ROOT}/themes/. Fonctionne sur macOS et Windows (en Bash et PowerShell) : les commandes restent simples — pas de pipes, && ou redirections.

Le projet est le dossier dans lequel tu travailles (repo d'un produit ou dossier de documents). Chaque projet a sa propre clé Gemini, qui reste uniquement sur l'ordinateur de la personne (Trousseau / Gestionnaire d'identifiants) ; le marqueur du projet est .training-video/project.json (id et nom, sans secrets).

Quatre approbations — sans elles, tu ne dépenses ni argent ni temps

  1. Scénario (le texte des répliques et le plan des diapositives/écrans).
  2. Coût — le tableau de cost.py. Les petits échantillons (jusqu'à 3–4 répliques) ne nécessitent pas d'approbation, la narration complète oui.
  3. Échantillon vocal — les 3 premières répliques (narrate.py --sample 3) ; la personne les écoute.
  4. Visuel — 1–2 diapositives prêtes ou images de l'enregistrement, avant le rendu complet.

Déroulement

  1. Environnement et clé — à chaque lancement, avant tout le reste.
    • doctor.py <projet>. Ce qui manque, corrige-le avec l'autorisation de la personne avec la commande que doctor.py donne pour ce système (brew / winget) ; pour le rendu npm ci dans ${CLAUDE_PLUGIN_ROOT}, si Claude Code ne l'a pas fait, et npx playwright install chromium.
    • La clé du projet : key.py check <projet>.
      • OK → tu continues.
      • PAS DE PROJET → dis à la personne que le dossier recevra un petit fichier .training-video/project.json (nom et numéro du projet, sans secrets — il peut aller dans git) et demande le nom du projet (propose le nom du dossier). Puis l'assistant.
      • PAS DE CLÉ → si le message dit qu'il existe une ancienne clé commune, demande « Dois-je utiliser votre clé Gemini existante aussi pour ce projet ? » (oui → key.py setup <projet> --use-legacy). Sinon l'assistant.
      • REJETÉE → l'assistant avec --replace.
    • L'assistant : d'abord, explique en mots simples ce qui va suivre : « La page de Google AI Studio va s'ouvrir — créez une clé (Create API key) dans le compte qui paiera la voix pour ce projet, et copiez-la. Ensuite, une fenêtre apparaîtra pour que vous la colliez ; la clé reste uniquement sur cet ordinateur. » Lance key.py setup <projet> [--name "<nom>"] — il ouvre la page et la fenêtre, vérifie la clé dans Gemini et l'enregistre. Ne demande jamais la clé dans le chat et ne l'écris nulle part ; si la personne la colle dans le chat, dis-lui de la supprimer de Google AI Studio et d'en créer une nouvelle.
    • Les personnes techniques peuvent utiliser Vertex (gcloud auth application-default login et GOOGLE_CLOUD_PROJECT) ; GEMINI_API_KEY dans l'environnement vaut pour tous les projets — seulement pour le CI.
  2. Prise en charge — oriente-toi toi-même, ne demande que ce qui n'est pas évident.
    • Qu'y a-t-il : fichiers/dossiers dans le chat ou sur le disque, lien Google Drive (via le connecteur Google Drive connecté, s'il y en a un), liens web, repo git d'un produit (.training-video/profile.md à l'intérieur signifie que le produit est prêt pour la vidéo).
    • Il y a un PDF, et doctor.py dit « poppler (PDF) : absent » → demande d'une seule question : « Pour extraire le texte et les images des PDF, j'ai besoin d'un petit programme (poppler, environ 35 Mo). Dois-je l'installer ? » Si « oui » — la commande de doctor.py (brew / winget) ; si « non » — lis les PDF directement, sans images.
    • Mode : par documents → reference/materials.md ; par code (enregistrement d'application) → reference/code.md. Si les deux sont présents, demande quelle est la vidéo.
    • Par code — pour quel rôle. La vidéo est pour un rôle de l'application (opérateur, manager, administrateur…) : l'enregistrement se connecte en tant que ce rôle et montre uniquement ses écrans. Les rôles proviennent du profil du produit ou du code (reference/code.md, « Les rôles — à partir du code ») et demande avec des réponses prêtes — les labels, tels que l'application les affiche. N'écris pas de scénario avant que l'inspection en tant que le rôle (survey.cjs) ne soit passée.
    • Demande en bloc (avec des questions à réponses prêtes) : pour qui est la vidéo et que doivent-ils savoir après ; langue de la voix (par défaut bulgare) ; langues des sous-titres ; durée (par défaut 3–8 min.) ; thème (themes/, par défaut « Neutre » ; si les documents ont leur propre charte graphique — propose un thème à partir de ceux-ci) ; où sauvegarder le résultat (dossier Drive ou sur l'ordinateur).
  3. Dossier de la vidéo — en dehors du plugin et en dehors du repo du produit, par défaut dans « Documents » de la personne : <Documents>/Vidéos de formation/<nom-court>-<date>/ (~/Documents sur Mac ; sur Windows %USERPROFILE%\Documents, peut être dans OneDrive) :
    • video.json — {"name": "<nom de fichier de sortie>", "project": "<chemin absolu du projet>", "lang": "bg", "voice": "Charon", "subtitles": ["bg", "en"], "theme": "neutral", "mode": "materials|code"} — project indique quelle clé paie la voix ; pour « par code » ajouter "product": "<repo>" et "role": "<rôle>" ;
    • script.json — le scénario (format dans scripts/lines.py) ; audio/, timeline.json, final/ sont créés par les scripts ;
    • sources/ — copie ou extraits des documents à partir desquels tu as écrit (extract.py les décompose), et sources/facts.md — les faits avec leur source.
  4. Scénario. Les règles pour le texte sont dans reference/script.md (ton, longueur, say, faits). Montre-le à la personne comme un texte lisible (par chapitre), pas comme du JSON. Les corrections — jusqu'à ce qu'il/elle dise « d'accord ». → approbation 1.
  5. Coût. lines.py <dossier>, puis cost.py <dossier> ; montre le tableau. → approbation 2.
  6. Échantillon vocal. narrate.py <dossier> --sample 3 ; donne à la personne les chemins des trois .wav (ou joue-les : Mac open <fichier>, Windows start "" "<fichier>"). Si le ton n'est pas bon — change voice dans video.json (échantillons de voix : tts.py --probe --voice <nom>) et répète. → approbation 3.
  7. Visuel. Selon le mode : 1–2 diapositives (reference/materials.md) ou image de l'enregistrement (reference/code.md). → approbation 4.
  8. Voix complète. narrate.py <dossier>. À la fin, il imprime un rapport ; chaque ligne REDO <id>: … → narrate.py <dossier> --only <id> …, jusqu'à ce qu'il n'y ait plus de REDO (voir reference/voice.md pour les exceptions).
  9. Image. Selon le mode — rendu des diapositives ou enregistrement des écrans ; écrit timeline.json et final/<name>.mp4.
  10. Sous-titres. Traduis toi-même text de chaque réplique pour chaque langue supplémentaire dans subs/<langue>.json ({"<id>": "traduction"}) : le même ton corporatif, nombres en chiffres, noms tels qu'ils apparaissent dans les documents. Ensuite srt.py <dossier> <name>.
  11. Vérification — reference/voice.md, « Vérification finale ». Ne dis pas « prêt » avant que tous les points ne soient passés ; ce qui n'est pas passé, dis-le franchement.
  12. Remise. Si la personne a indiqué un dossier Google Drive et qu'un connecteur Drive est connecté — télécharge-le avec lui ; sinon — le chemin vers final/. Dis brièvement : durée, langues, coût, ce qui reste à vérifier.

Ton — toujours

Professionnel, corporatif, pour des collègues adultes — même quand le produit est pour des enfants. Pas enfantin, pas publicitaire, pas « explication pour débutants ». Détails : reference/script.md. La voix ne change pas entre les répliques : une seule voice, un seul style, une seule température pour toute la vidéo (reference/voice.md).

Skills associés