Communitygithub.com

Vidéo de démonstration du navigateur

Produisez une vidéo MP4 1080p narrée et chapitrée d'un produit basé sur navigateur (application web, tableau de bord, outil interne, artefact intégré).

Qu'est-ce que Vidéo de démonstration du navigateur ?

Cette compétence permet de créer automatiquement des vidéos de démonstration ou de parcours guidé de produits web. Elle pilote Chrome en temps réel avec un curseur visuel, des anneaux de surbrillance, des notes et des cartes-titres, et génère une voix off via TTS (Amazon Polly ou macOS say). Chaque action est synchronisée avec la narration, les temps de chargement sont coupés, et le résultat final est mixé, normalisé et chapitré. Le pipeline se compose de scripts JavaScript pour l'écriture du scénario et l'enregistrement, d'un script Python pour le montage final, et d'un script de révision pour vérifier la qualité. La compétence est conçue pour être utilisée avec des agents comme Claude Code, et nécessite Chrome, Node.js, Playwright, ffmpeg/ffprobe, Python 3 et l'interface AWS CLI pour Polly. Elle est particulièrement utile pour créer des vidéos de produits internes, des démonstrations pour la direction ou des parcours clients, avec la possibilité de refaire une prise automatiquement en cas de changement de voix ou de correction d'étiquette.

Compatible avec✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/rnijhara/claude-skills/tree/HEAD/plugins/browser-demo-video/skills/browser-demo-video

Demander à votre IA préférée

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

Documentation

Que fait Vidéo de démonstration du navigateur ?

Vous écrivez le scénario de la vidéo sous forme de code, ce qui rend les prises reproductibles : un changement de voix ou une étiquette corrigée signifie une reprise automatique, pas un réenregistrement manuel. Le pipeline :

script.cjs ──tts.cjs──▶ audio/*.wav + durations.json
     │                                │
     └──────────record.cjs◀───────────┘   Chrome + overlay, CDP screencast → takes/<target>/frames + timeline.json
                    │
               post.py  ──▶ MP4 (coupures supprimées, narration + sons de clic, −16 LUFS, chapitres)
                    │
               review.py ──▶ planches contact + vérification du volume et des chapitres → vous inspectez, puis livrez

Moteur : scripts/ dans cette compétence. Projet par vidéo : ~/Movies/Demos/<slug>/ (jamais /tmp, qui est effacé), contenant video.config.cjs, script.cjs, audio/ et takes/. Exemple exécutable : examples/hello-orders/ (une petite page intégrée dans un shell hôte ; utilisez-le pour vérifier votre configuration). Lisez references/lessons.md avant la première prise.

Prérequis : Chrome, Node avec Playwright (record.cjs le trouve, ou définissez playwright dans la configuration), ffmpeg/ffprobe, Python 3 et l'interface AWS CLI pour Polly.

1. Validez la vidéo (avant tout code)

Confirmez et proposez un plan auquel l'utilisateur peut réagir :

  • Public. Les vidéos internes couvrent les rôles, les autorisations, les contrôles et les limitations connues, et se terminent par un chapitre « À savoir ». Les vidéos pour la direction et les clients couvrent les résultats et le chemin heureux uniquement.
  • Le déroulement de bout en bout, sous forme de chapitres, et la durée cible. Environ 10 à 12 minutes convenaient pour une plongée en profondeur interne.
  • Où enregistrer (décision). Le parcours clique sur de vrais boutons et écrit un état réel, donc il ne doit jamais s'exécuter sur des données réelles et partagées. Recommandez une copie, un espace de test ou un environnement de développement avec des données réalistes, ainsi qu'un moyen de le réinitialiser entre les prises. Si la création de cette copie écrit en production, cela nécessite un oui explicite.
  • Identités (décision). Si le flux nécessite deux personnes (créateur et vérificateur), soit un vrai collègue se connecte dans une seconde fenêtre, soit une personne joue les deux rôles et la vidéo l'indique à l'écran. Ne créez jamais d'utilisateurs et ne gérez pas les mots de passe ; si un compte de test est nécessaire, l'utilisateur le crée.
  • Voix (décision). Par défaut, la voix générative Polly « Amy » (en-GB), qui a bien fonctionné avec de vrais spectateurs. Proposez un échantillon d'environ 30 s de chaque voix candidate avant de tout générer : aws polly synthesize-speech --profile <profil dev> --region eu-west-2 --engine generative --voice-id Amy --output-format mp3 --text "<passage avec le jargon du produit>" sample-Amy.mp3 Utilisez un compte AWS non production. macOS say fonctionne hors ligne mais sonne synthétique. La propre voix de l'utilisateur est l'option la plus naturelle.
  • Cadrage. Seul le produit est dans le cadre : pas de panneaux latéraux de l'hôte, de listes ou de bannières. Configurez cela dans le hook setup de la configuration.

2. Configurez le projet

P=~/Movies/Demos/<slug>; K=~/.claude/skills/browser-demo-video
mkdir -p "$P" && cp $K/templates/video.config.cjs $K/templates/script.cjs "$P"/

Dans video.config.cjs, renseignez : l'url de l'environnement jetable, frame si le produit s'exécute dans une iframe, ready, setup (cadrage), theme (couleur d'accentuation du produit et pied de page), voice, et helpers.waitLoaded (le signal de chargement du produit).

Cartographiez l'interface utilisateur avant d'écrire les étapes. Ouvrez-la, listez les sélecteurs stables (ids, rôles, data-*, texte visible) et notez les chargements lents. Préférez les sélecteurs basés sur le texte affiché (tr:has-text("-1 250,00") [data-resolve]) aux clés générées.

3. Écrivez le script de la scène

Chaque étape a { id, chapter?, pre?, say?, act?, gap? }. L'API h est documentée en haut de templates/script.cjs.

  • La narration pilote le timing. act s'exécute pendant que le clip joue, et h.at(0.6) aligne une seconde action sur les mots. Gardez chaque say à une ou deux phrases parlées.
  • Écrivez les nombres comme ils sont prononcés (« quatre-vingt-dix-sept pour cent », « le quatorze septembre »).
  • Utilisez les décisions réelles d'utilisateurs réels lorsqu'elles existent, afin que les chiffres à l'écran correspondent à ce que l'équipe connaît.
  • Placez une carte de chapitre (h.card) avant chaque chapitre, et ajoutez des anneaux avec des étiquettes de 3 à 6 mots. Utilisez note() uniquement là où un point doit être souligné, comme une propriété de sécurité, une mise en garde ou « dans un usage réel… ».
  • Encadrez chaque chargement lent dans h.cut(() => h.waitLoaded(), 'Chargement …'). Cette durée est supprimée en post-production.
  • Exprimez chaque simplification à l'écran et dans la narration. Par exemple, une personne joue deux rôles : montrez le contrôle qui le bloque, montrez le réglage modifié « pour cet enregistrement uniquement », puis expliquez ce qui se passe dans un usage réel.
  • Pointez sur les téléchargements ; ne cliquez pas dessus (voir les leçons).

4. Générez la voix off

node $K/scripts/tts.cjs "$P". Seules les lignes modifiées sont régénérées. Claude ne peut pas écouter le résultat, nommez donc les mots risqués (acronymes, noms) et demandez à l'utilisateur de les vérifier. Avec macOS say, épetez les acronymes comme des lettres (« S A P »).

5. Exécution à blanc, puis connexion, puis enregistrement

  1. Exécution à blanc. Pointez TARGET=preview avec previewUrl sur une version locale si elle existe. Sinon, exécutez de courts segments sur l'environnement jetable : ONLY='^(c1|load0|where1)$' node $K/scripts/record.cjs "$P" record. Vérifiez quelques images avec l'outil Read (takes/prod/frames/*.jpg, failure.png en cas d'erreur), et vérifiez avec ffprobe que les images sont en 1920×1080. Réinitialisez l'environnement ensuite.
  2. Connectez-vous. Exécutez node $K/scripts/record.cjs "$P" login avec run_in_background. L'utilisateur se connecte dans la fenêtre qui s'ouvre, puis la ferme. S'il dit avoir terminé mais que la fenêtre est toujours ouverte, pkill -INT -f "record.cjs.* login".
  3. Prise complète. Réinitialisez l'environnement, puis exécutez node $K/scripts/record.cjs "$P" record avec run_in_background. Avant qu'elle ne démarre, dites à l'utilisateur que cela prend environ la durée de la narration plus un tiers, dans une fenêtre Chrome visible sur laquelle il ne doit pas cliquer. Attendez la notification de fin ; ne sondez pas avec sleep. Vérifiez le journal pour chaque étape ok et aucune ligne FAILED ou CRASHED.

6. Assemblez et révisez

python3 $K/scripts/post.py "$P/takes/prod" "$P/takes/prod/walkthrough.mp4"        # run_in_background ; ~10 min pour une vidéo de 10 min
python3 $K/scripts/review.py "$P/takes/prod" "$P/takes/prod/walkthrough.mp4" "$P/review"   # optionnel : step_id:0.8 picks

Lisez chaque planche review/s*.jpg. Recherchez des étiquettes coupées ou qui se chevauchent, des anneaux sur le mauvais élément, des états de chargement qui n'ont pas été coupés, et des superpositions résiduelles. Le volume doit être d'environ −16 LUFS et le nombre de chapitres doit correspondre au script. Corrigez les problèmes dans le script, réinitialisez l'environnement, et refaites la prise. Les reprises sont peu coûteuses.

7. Livrez et nettoyez

  • Livrez. Copiez la vidéo vers $P/<slug>.mp4 et lancez open. Si une version précédente existe, conservez-la renommée (par exemple old-<voice>-<slug>.mp4), pas écrasée.
  • Rapportez. Donnez la durée, la résolution, les chapitres, la voix, l'endroit où elle a été enregistrée, chaque simplification montrée, ce que vous n'avez pas pu vérifier (l'audio), et les défauts visuels restants.
  • Demandez avant de nettoyer. Obtenez l'accord de l'utilisateur avant de supprimer la copie jetable ou l'environnement, et avant de supprimer takes/ (les images prennent des Go). Gardez script.cjs, la configuration et audio/ pour que la vidéo puisse être réenregistrée ultérieurement.
  • Enregistrez-le. Si le travail appartient à un ticket ou un fichier de notes, notez l'emplacement de la vidéo et le fait que la suppression de la copie est en attente. Validez uniquement ce fichier.

Skills associés