Communitygithub.com

mertz1999/luma-assistant

Crée des pages vidéo de démonstration SaaS cinématographiques et des présentations de produits enregistrables à l'écran. À utiliser lorsque Codex est invité à construire une route /demo, une présentation animée d'un produit, une page d'enregistrement d'écran, une démo de produit narrée, une histoire UI pilotée par le curseur, ou un système de vidéo de démonstration réutilisable pour une application ou un site web.

Qu'est-ce que luma-assistant ?

Ce skill permet de générer des pages de démonstration vidéo professionnelles pour produits SaaS, automatisant la création de parcours utilisateur scénarisés avec transitions animées, cursus simulés et synchronisation audio. Il est conçu pour des agents IA comme Codex ou Claude Code et supporte les frameworks modernes (Next.js, Framer Motion). Le skill structure la démo en scènes définies par des données (durée, titre, légende, cible du curseur) et gère le défilement temporel précis pour éviter les réinitialisations lors des rechargements. Il inclut des directives strictes pour ne pas inventer de fonctionnalités inexistantes, valider le rendu sur différentes tailles d'écran, et respecter les préférences de mouvement réduit. Le résultat est une page en plein écran avec zooms cinématographiques, légendes superposées, cadres de téléphone pour les flux mobiles, et un moment de révélation du résultat. Ce skill est particulièrement utile pour les démos de vente, les présentations de financement, ou les pages d'accueil de produits avec narration intégrée.

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

Résultat

Construisez une page de démonstration en plein écran, avec défilement automatique, pouvant être enregistrée comme une vidéo soignée d'un produit SaaS. Privilégiez une courte histoire client plutôt qu'un tour des fonctionnalités : accroche du problème, action produit, moment client, révélation du résultat, résultat commercial, appel à l'action final.

Utilisez ce skill pour créer ou améliorer des routes telles que /demo, /presentation, /video-demo, ou toute page HTML/React autonome équivalente.

Entrées Requises

Collectez ou déduisez ces informations avant l'implémentation. Ne demandez que ce qui bloque.

  • Nom du produit, domaine, public cible et promesse principale.
  • Durée cible et format d'image, généralement 30-60 secondes et 16:9.
  • Routes existantes de l'application à montrer : inscription, tableau de bord, création de produit, création de lien, page client, analyses.
  • Ressources de marque : logo, couleurs, polices, images produit, images client, captures d'écran, icônes, maquettes de téléphone.
  • Contraintes réelles du flux de travail : ce que l'application fait réellement, ce qui est manuel, ce qui est automatique, les données disponibles.
  • Script de voix-off ou chronologie. Si l'utilisateur a généré un fichier audio, utilisez les horodatages exacts.
  • Appel à l'action final et URL d'enregistrement.

N'inventez jamais un comportement que le produit ne supporte pas. Si un magasin copie manuellement un lien, dites-le au lieu de dire que l'application l'envoie automatiquement.

Storyboard

Structure par défaut de 30 à 50 secondes :

  1. Accroche du problème : montrez une question ou une douleur réaliste d'un client.
  2. Action administrateur : ajouter un produit, créer un lien privé, copier un message.
  3. Moment client : le client reçoit le lien, l'ouvre, télécharge une image, démarre une génération.
  4. Révélation du résultat : avant/produit/résultat côte à côte avec une animation de révélation nette.
  5. Résultat commercial : indicateurs du tableau de bord qui comptent.
  6. Appel à l'action final : promesse courte du produit et domaine.

Utilisez le vrai domaine du produit et son langage réel. Pour le commerce social, montrez une UI de messagerie de style Instagram uniquement comme dispositif visuel de narration, sauf si le produit s'intègre réellement aux API Instagram.

Schéma d'Implémentation

Utilisez la pile existante de l'application. Pour les applications Next.js, privilégiez :

  • Une route comme src/app/demo/page.tsx.
  • Un composant client pour la présentation chronométrée.
  • Framer Motion pour les transitions de scènes, le mouvement du curseur, les effets de révélation, le scintillement et le zoom.
  • Les composants UI existants, le logo, la palette et les ressources.
  • Un aperçu de scène par paramètre de requête, par exemple /demo?scene=resultReveal.

Comportement du composant de démonstration principal :

  • Définissez les scènes comme des données : id, title, caption, durationMs, cursor et des métadonnées optionnelles de focus visuel/caméra.
  • Calculez les heures de début de scène à partir de durationMs.
  • Utilisez une chronologie basée sur l'horloge système pour que les rechargements à chaud ou les nouveaux rendus ne réinitialisent pas la lecture de manière inattendue.
  • Ajoutez les contrôles de lecture, pause, redémarrage, précédent et suivant, sauf si l'utilisateur souhaite une page d'enregistrement pur.
  • Si vous synchronisez avec un audio généré, faites en sorte que les durées des scènes correspondent exactement aux plages d'horodatage audio.
  • Ajoutez des attributs data-demo-cursor-target aux contrôles UI importants et calculez les positions du curseur à partir de getBoundingClientRect(). Évitez les coordonnées de curseur codées en dur lorsqu'une cible réelle existe.
  • Utilisez ResizeObserver et requestAnimationFrame pour maintenir les cibles du curseur précises quelle que soit la taille de la fenêtre.
  • Respectez les paramètres de mouvement réduit.

Direction Visuelle

Donnez-lui l'impression d'une vidéo de démonstration/lancement SaaS moderne :

  • Scène en plein écran, pas une page de documentation normale.
  • Zooms cinématographiques sur les clics importants.
  • Mouvement fluide du curseur qui continue depuis la position précédente du curseur.
  • Légendes superposées courtes : "1. Ajouter produit", "2. Envoyer lien", "3. Le client essaie".
  • Captures d'écran réelles de l'application ou maquettes UI réalistes dans des cadres de navigateur/téléphone.
  • Un moment de révélation du résultat avec flash, fondu, flou à netteté, ou comparaison côte à côte.
  • Un plan final net du tableau de bord avec 2 à 4 indicateurs clés.
  • Pas de paragraphes denses, pas de logs développeur, pas de jargon technique fictif.

Pour les flux clients mobiles, utilisez un cadre de téléphone. Assurez-vous que le contenu à l'intérieur reste lisible sur les fenêtres d'affichage de bureau et d'enregistrement mobile.

Narration et Chronométrage

Si l'utilisateur a besoin d'une voix-off, fournissez une invite pour un modèle vocal :

  • Ton : confiant, chaleureux, premium, clair, pas robotique.
  • Rythme : correspondre à la durée cible.
  • Notes de prononciation pour le nom du produit.
  • Script horodaté par scène.

Si l'utilisateur fournit des horodatages audio générés, mettez à jour les durées des scènes avec ces plages exactes et vérifiez la durée totale.

Voir references/storyboard-and-voiceover.md pour des modèles de timing et de narration réutilisables.

Validation

Avant de terminer :

  • Exécutez l'application localement ou confirmez le serveur de développement/production existant.
  • Exécutez les vérifications pertinentes : vérification de type, lint, build, ou équivalent du framework.
  • Utilisez des vérifications Playwright/navigateur aux tailles de bureau et mobile.
  • Vérifiez qu'il n'y a pas de débordement horizontal.
  • Vérifiez que le contenu du cadre de téléphone est visible.
  • Vérifiez que le curseur atterrit sur les boutons prévus en utilisant les mesures DOM.
  • Vérifiez que chaque scène d'aperçu fonctionne via les paramètres de requête, si implémentée.
  • Vérifiez que l'URL publique finale ou l'URL locale renvoie 200 OK.
  • Si une iframe vidéo est intégrée, vérifiez que l'iframe est présente dans le HTML rendu.

Signalez séparément tout avertissement connu lié au développement, comme les échecs WebSocket HMR Next.js sur les serveurs de développement avec adresse IP publique.

Livraison

Retournez :

  • L'URL de la page de démonstration.
  • Les routes/fichiers ajoutés ou modifiés.
  • Le tableau des durées de scènes.
  • L'invite de voix-off si demandée.
  • Les commandes/résultats de validation.
  • Toute note d'enregistrement, comme la taille de fenêtre recommandée et s'il faut masquer les contrôles.

Skills associés