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
- Scénario (le texte des répliques et le plan des diapositives/écrans).
- 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. - Échantillon vocal — les 3 premières répliques (
narrate.py --sample 3) ; la personne les écoute. - Visuel — 1–2 diapositives prêtes ou images de l'enregistrement, avant le rendu complet.
Déroulement
- 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 quedoctor.pydonne pour ce système (brew / winget) ; pour le rendunpm cidans${CLAUDE_PLUGIN_ROOT}, si Claude Code ne l'a pas fait, etnpx 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 loginetGOOGLE_CLOUD_PROJECT) ;GEMINI_API_KEYdans l'environnement vaut pour tous les projets — seulement pour le CI.
- 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.pydit « 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 dedoctor.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).
- 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 (
- 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>/(~/Documentssur 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"}—projectindique quelle clé paie la voix ; pour « par code » ajouter"product": "<repo>"et"role": "<rôle>";script.json— le scénario (format dansscripts/lines.py) ;audio/,timeline.json,final/sont créés par les scripts ;sources/— copie ou extraits des documents à partir desquels tu as écrit (extract.pyles décompose), etsources/facts.md— les faits avec leur source.
- 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. - Coût.
lines.py <dossier>, puiscost.py <dossier>; montre le tableau. → approbation 2. - Échantillon vocal.
narrate.py <dossier> --sample 3; donne à la personne les chemins des trois.wav(ou joue-les : Macopen <fichier>, Windowsstart "" "<fichier>"). Si le ton n'est pas bon — changevoicedansvideo.json(échantillons de voix :tts.py --probe --voice <nom>) et répète. → approbation 3. - Visuel. Selon le mode : 1–2 diapositives (
reference/materials.md) ou image de l'enregistrement (reference/code.md). → approbation 4. - Voix complète.
narrate.py <dossier>. À la fin, il imprime un rapport ; chaque ligneREDO <id>: …→narrate.py <dossier> --only <id> …, jusqu'à ce qu'il n'y ait plus deREDO(voirreference/voice.mdpour les exceptions). - Image. Selon le mode — rendu des diapositives ou enregistrement des écrans ; écrit
timeline.jsonetfinal/<name>.mp4. - Sous-titres. Traduis toi-même
textde chaque réplique pour chaque langue supplémentaire danssubs/<langue>.json({"<id>": "traduction"}) : le même ton corporatif, nombres en chiffres, noms tels qu'ils apparaissent dans les documents. Ensuitesrt.py <dossier> <name>. - 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. - 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).