Communitygithub.com

ahnchiyoon87/claude-skills

Enregistre le parcours réel d'utilisation d'un service avec Playwright, ajoute des sous-titres narratifs du point de vue de l'utilisateur, et produit une vidéo de démonstration de 5 minutes ou moins. Idéal pour les demandes du type « filme-moi ça », « vidéo de démo », « vidéo de démonstration », « mets le processus en vidéo ». Ne traite pas les slides de présentation ni les guides pratiques.

Qu'est-ce que claude-skills ?

Ce skill permet de créer automatiquement une vidéo de démonstration (≤ 5 min) d'un service, en enregistrant l'ensemble du parcours utilisateur avec Playwright, puis en y ajoutant des sous-titres explicatifs au niveau du consommateur. Le processus suit six étapes : découpage de la scène (3 à 6 scènes), enregistrement réel avec `recordVideo` (à vitesse humaine, `slowMo` 300 ms), rédaction des sous-titres sans jargon technique, montage de la vidéo sous 5 minutes, composition avec `ffmpeg` pour brûler les sous-titres, et vérification finale (durée ≤ 300 s, rendu des caractères coréens correct). Le skill respecte strictement le réalisme : pas d'écrans fictifs, pas de clics forcés, pas de données mockées ; si le parcours échoue, il le signale. Les opérations irréversibles (fusion PR, modification de données réelles, paiement) sont limitées aux environnements de test définis par le projet. Le résultat fourni est un fichier mp4 + srt, accompagné d'un rapport détaillant la durée réelle, la description de chaque scène, les images de contrôle et les éventuels points non vérifiés. Le skill s'appuie sur les paramètres du projet (dans `CLAUDE.md`) pour le déploiement du service, les comptes de test et le style vidéo.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ahnchiyoon87/claude-skills/tree/HEAD/skills/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

Vidéo de démonstration

Une vidéo de démonstration, c'est montrer le parcours d'utilisation réel d'un service, du point de vue de l'utilisateur, en moins de 5 minutes.

« Filme ce processus et ajoute une explication simple » : une seule ligne suffit pour que tout soit fait automatiquement avec les valeurs par défaut ci-dessous.

Valeurs par défaut : Enregistrement Playwright (1280×720) · Narration par sous-titres (SRT + incrustation), voix sur demande uniquement · Résultat : mp4 + srt.

La manière de lancer le service, les comptes de test et le style vidéo suivent le CLAUDE.md du projet.

Étapes

  1. Découpage en scènes — Décomposer la demande en un flux de 3 à 6 scènes, telles que vécues par l'utilisateur. Pour chaque scène, indiquer « ce que l'on voit » et « une ou deux phrases d'explication ».

  2. Enregistrement réel complet — Lancer le service et enregistrer, du début à la fin, en effectuant les manipulations réelles avec recordVideo de Playwright (taille = viewport). À vitesse humaine (slowMo ~300 ms), attendre après chaque clic que le résultat s'affiche à l'écran. Le fichier vidéo n'est finalisé qu'après fermeture du contexte. En cas d'échec, ne réenregistrer que la scène concernée. Noter les horodatages de référence (début, résultat visible, fin) pour chaque scène.

  3. Rédaction des sous-titres — Dire « ce que cela apporte de bon », sans jargon technique ni nom de code. 1 à 2 phrases par scène, après l'apparition du résultat.

    • Mauvais : « Je crée une PR qui change la règle hit policy de DMN rule 3 en FIRST. »
    • Bon : « Les règles en conflit sont nettoyées, donc une même commande ne reçoit pas deux fois la remise. »
  4. Montage sous 5 minutes — Rogner les temps de chargement ou les accélérer. Conserver les instants de manipulation et les 2–3 secondes de lecture du résultat. Si la durée dépasse, fusionner les scènes. Ne pas supprimer les étapes clés mentionnées dans la demande.

  5. Composition — Concaténer les segments avec ffmpeg, recalculer le SRT en fonction des temps de la version finale montée, puis incruster les sous-titres. Sous Windows, se placer dans le dossier de travail et utiliser des chemins relatifs (problème d'échappement des :). Police : Malgun Gothic sous Windows, Noto Sans CJK KR (ou toute police coréenne installée) sous Linux.

    ffmpeg -i edited.mp4 -vf "subtitles=demo.srt:force_style='FontName=Malgun Gothic,FontSize=22'" -c:a copy demo.mp4
    
  6. Vérification — Contrôler la durée avec ffprobe -v error -show_entries format=duration -of csv=p=0 demo.mp4 (≤ 300 s). Extraire quelques images aux horodatages des sous-titres (ffmpeg -ss <secondes> -i demo.mp4 -frames:v 1 f_<secondes>.png) et les ouvrir directement pour vérifier que ce que disent les sous-titres correspond à l'écran et que le coréen ne s'affiche pas mal.

Règles à respecter

  • Ne pas utiliser d'écrans factices, de réponses mock, d'injection de valeurs DOM ni de clics forcés. Si le parcours complet échoue, signaler l'échec.
  • Les opérations difficilement réversibles (fusion réelle de PR, modification de données en production, envoi, paiement) ne doivent être effectuées que dans l'environnement de test défini par le projet. En l'absence d'un tel environnement, demander à l'utilisateur juste avant la scène concernée. Veiller à ce qu'aucun mot de passe ou jeton ne soit visible à l'écran ou dans les sous-titres.
  • Rapport : chemins des fichiers mp4 et srt, durée réelle, description par scène, images contrôlées visuellement, points non vérifiés. La publication ou l'envoi ne se fait que sur demande explicite.

Skills associés