Communitygithub.com

screen-demo

Réalisez une vidéo de démonstration soignée (et un GIF) de n'importe quel site ou application web, par code. Claude examine la page, planifie un parcours, et un script le joue dans Chromium avec un curseur fluide, des clics réels, de la frappe et des défilements doux, puis produit une vidéo 1920×1080 (ou verticale, ou carrée) avec des zooms sur l'essentiel, des anneaux de surbrillance, des légendes et une carte de titre.

Qu'est-ce que screen-demo ?

**screen-demo** est une compétence pour Claude Code (ou tout agent IA terminal) qui transforme une URL en vidéo de démonstration professionnelle. L'agent agit comme un réalisateur : il inspecte la page, rédige un parcours (tour) en JSON, puis un script Playwright l'exécute dans Chromium en capturant images par image les défilements, les mouvements du curseur et la frappe à 30 ips, pour un rendu fluide même sur des pages lourdes. La sortie peut être une vidéo MP4 1920×1080 (paysage) au format 16:9, verticale 9:16 pour Shorts/Reels, ou carrée, avec possibilité de générer un GIF. Le workflow comprend : inspection de la page avec superposition des éléments cliquables numérotés, écriture du parcours avec légendes et zooms, enregistrement puis rendu. L'utilisateur peut ajuster les légendes et zooms sans ré-enregistrer en éditant le fichier `tour.json`. La compétence intègre des règles de sécurité strictes : jamais de connexion avec mot de passe, pas de saisie de données personnelles, refus des bannières cookies, et respect des droits d'affichage. L'outil est idéal pour créer des démos produit, des vidéos de présentation pour README, des GIF de page d'accueil, ou des walkthroughs d'application.

Compatible avec✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/gabrielebolognese/screen-demo/tree/HEAD/skills/screen-demo

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 screen-demo ?

Transforme une URL en vidéo de démonstration. Vous êtes le réalisateur : vous regardez la page, écrivez le parcours en JSON, et le script le joue, capture les images de la page (jamais le bureau) et monte la vidéo. Les défilements, le glissement du curseur et la frappe sont capturés image par image à 30 ips, donc ils sont fluides même sur une page lourde ; ce que la page fait d'elle-même après un clic ou un chargement provient du screencast en direct.

Configuration (une fois)

  1. Python 3.10+ avec Pillow et un Playwright récent : python -m pip install -U playwright pillow, puis python -m playwright install chromium.
  2. ffmpeg dans le PATH (winget install ffmpeg, brew install ffmpeg).

Vérifiez avec python tests/selftest.py (une page locale, sans réseau, environ une minute).

Processus

  1. Demandez à quoi sert la vidéo : l'URL, les 2 à 4 choses à montrer (le héros, une fonctionnalité, le prix, un flux d'inscription), le format (landscape 16:9 pour YouTube et les README, vertical 9:16 pour les Shorts et Reels, square), et s'ils veulent un GIF. Uniquement leur propre site ou application, ou une page publique qu'ils sont autorisés à montrer.
  2. Regardez la page : python scripts/demo.py inspect URL REPERTOIRE [--format vertical]. Lisez chaque REPERTOIRE/page-N.jpg (la page en tranches de la taille de la fenêtre, chaque élément cliquable encadré avec un numéro rouge) et REPERTOIRE/elements.txt. Une bannière de cookies ou une popup apparaît ici : la première étape du parcours la ferme (le bouton « Refuser » ou « Fermer »).
  3. Écrivez REPERTOIRE/tour.json (format dans references/tour-format.md) : une carte de titre, puis de courtes étapes. Un bon parcours : une légende qui dit ce que fait le produit, un défilement jusqu'à la première chose qui vaut le coup d'être vue, un zoom dessus, un clic ou de la frappe qui montre le produit en action, une surbrillance sur le résultat, une légende par idée. 15 à 40 secondes. Les cibles sont les numéros de l'inspection (#12), ou css=... ou text=....
  4. Enregistrez : python scripts/demo.py record REPERTOIRE/tour.json SORTIE [--gif]. Il joue le parcours, affiche chaque étape qui a échoué, et produit SORTIE/demo.mp4 (et SORTIE/demo.gif).
  5. Regardez SORTIE/keys.jpg (une image de chaque étape) avant de déclarer terminé : un zoom au mauvais endroit, une légende qui recouvre le point de l'image, une étape qui a échoué (l'élément a bougé ou était masqué), une bannière encore gênante. Pour ne changer que les légendes, les zooms ou la carte de titre, éditez SORTIE/tour.json et lancez python scripts/demo.py render SORTIE [--gif] (pas de nouvel enregistrement) ; sinon, enregistrez à nouveau.
  6. Livrez : le chemin de demo.mp4 (et du GIF), sa durée, et une ligne par idée qu'il montre.

Règles

  • Ne jamais se connecter avec un mot de passe, ne jamais taper un mot de passe ou un numéro de carte (le script refuse les champs de mot de passe et de paiement), ne jamais acheter, envoyer, publier ou supprimer quoi que ce soit, ne jamais soumettre un formulaire avec les données personnelles de quelqu'un. Une démonstration d'une zone connectée nécessite que l'utilisateur fournisse lui-même une page de compte de test.
  • Refusez les bannières de cookies (le moins de données) sauf si l'utilisateur dit le contraire.
  • Gardez les légendes courtes (3 à 8 mots) ; une idée par légende ; le mouvement de la vidéo fait le reste.
  • Respectez le site : pas de parcours d'une page que l'utilisateur n'est pas autorisé à montrer.

Exemple

Utilisateur : « fais une démo de 20 secondes de ma landing page https://example.com pour le README, montre l'inscription »

Vous lancez inspect, lisez les 3 tranches, voyez une bannière de cookies (#2 « Refuser tout »), le héros, un champ « Essayez-le » (#9) et une carte de tarification (#21) ; vous écrivez un parcours : une carte de titre, cliquez #2, légende « Des notes qui s'écrivent toutes seules », tapez dans #9, cliquez #10, surbrillance du résultat, légende « Gratuit pour toujours », défilez jusqu'à #21, zoom ; enregistrez avec --gif, ouvrez keys.jpg, voyez que le zoom a bien cadré le prix, et répondez avec demo.mp4 (21 s), demo.gif (3 Mo) et les quatre idées.

Skills associés