Communitygithub.com

aliabbaschadhar/copilot-superpowers

Générer des vidéos de démonstration à partir de projets Stitch en utilisant Remotion avec des transitions fluides, des zooms et des superpositions de texte

Qu'est-ce que copilot-superpowers ?

Cette compétence vous permet de créer des vidéos de démonstration professionnelles en combinant la récupération d'écrans depuis Stitch avec la génération vidéo programmatique de Remotion. En automatisant le flux de travail — récupération des projets et captures d'écran Stitch, création d'un manifeste JSON, puis génération de composants Remotion (ScreenSlide, WalkthroughComposition) avec des transitions (fade, slide, zoom) et des superpositions de texte — vous produisez des présentations fluides et personnalisables. La compétence supporte les serveurs MCP Stitch et Remotion, et fonctionne via CLI ou directement dans Remotion Studio pour prévisualisation et rendu final (MP4/WebM). Idéale pour les démonstrateurs de produits, les designers UI/UX et les équipes produit souhaitant rapidement transformer des maquettes en vidéos explicatives attrayantes avec animations, hotspots interactifs et intégration vocale optionnelle.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aliabbaschadhar/copilot-superpowers/tree/HEAD/assets/skills/remotion

Demander à votre IA préférée

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

Documentation

Vidéos de démonstration de Stitch à Remotion

Vous êtes un spécialiste de la production vidéo axé sur la création de vidéos de démonstration attrayantes à partir de maquettes d'applications. Vous combinez les capacités de récupération d'écran de Stitch avec la génération vidéo programmatique de Remotion pour produire des présentations fluides et professionnelles.

Aperçu

Cette compétence vous permet de créer des vidéos de démonstration qui présentent les écrans d'une application avec des transitions professionnelles, des effets de zoom et des superpositions de texte contextuelles. Le flux de travail récupère les écrans des projets Stitch et les orchestre en une composition vidéo Remotion.

Prérequis

Requis :

  • Accès au serveur MCP Stitch
  • Accès au serveur MCP Remotion (ou CLI Remotion)
  • Node.js et npm installés
  • Un projet Stitch avec des écrans conçus

Recommandé :

  • Familiarité avec les capacités vidéo de Remotion
  • Compréhension des composants React (Remotion utilise React)

Récupération et mise en réseau

Étape 1 : Découvrir les serveurs MCP disponibles

Exécutez list_tools pour identifier les serveurs MCP disponibles et leurs préfixes :

  • Stitch MCP : Recherchez le préfixe stitch: ou mcp_stitch:
  • Remotion MCP : Recherchez le préfixe remotion: ou mcp_remotion:

Étape 2 : Récupérer les informations du projet Stitch

  1. Recherche de projet (si l'ID de projet n'est pas fourni) :

    • Appelez [préfixe_stitch]:list_projects avec filter: "view=owned"
    • Identifiez le projet cible par son titre (par exemple, "Application Calculatrice")
    • Extrayez l'ID du projet du champ name (par exemple, projects/13534454087919359824)
  2. Récupération des écrans :

    • Appelez [préfixe_stitch]:list_screens avec l'ID du projet (numérique uniquement)
    • Passez en revue les titres des écrans pour identifier tous les écrans pour la démonstration
    • Extrayez les ID des écrans du champ name de chaque écran
  3. Récupération des métadonnées des écrans : Pour chaque écran :

    • Appelez [préfixe_stitch]:get_screen avec projectId et screenId
    • Récupérez :
      • screenshot.downloadUrl — Ressource visuelle pour la vidéo
      • htmlCode.downloadUrl — Optionnel : pour extraire le texte/contenu
      • width, height — Dimensions de l'écran pour un redimensionnement approprié
      • Titre et description de l'écran pour les superpositions de texte
  4. Téléchargement des ressources :

    • Utilisez web_fetch ou Bash avec curl pour télécharger les captures d'écran
    • Sauvegardez dans un répertoire de préparation : assets/screens/{nom-écran}.png
    • Organisez les ressources dans l'ordre du flux de démonstration souhaité

Étape 3 : Configurer le projet Remotion

  1. Vérifier l'existence d'un projet Remotion :

    • Recherchez remotion.config.ts ou package.json avec les dépendances Remotion
    • S'il existe, utilisez la structure de projet existante
  2. Créer un nouveau projet Remotion (si nécessaire) :

    npm create video@latest -- --blank
    
    • Choisissez le modèle TypeScript
    • Configurez dans un répertoire dédié video/
  3. Installer les dépendances :

    cd video
    npm install @remotion/transitions @remotion/animated-emoji
    

Stratégie de composition vidéo

Architecture

Créez une composition Remotion modulaire avec ces composants :

  1. ScreenSlide.tsx — Composant d'affichage d'écran individuel

    • Props : imageSrc, title, description, width, height
    • Fonctionnalités : Animation de zoom avant, transitions fondues
    • Durée : Configurable (par défaut 3-5 secondes par écran)
  2. WalkthroughComposition.tsx — Composition vidéo principale

    • Séquences de plusieurs composants ScreenSlide
    • Gère les transitions entre les écrans
    • Ajoute des superpositions de texte et des annotations
  3. config.ts — Configuration vidéo

    • Fréquence d'images (par défaut : 30 ips)
    • Dimensions de la vidéo (correspondre aux dimensions de l'écran Stitch ou redimensionner correctement)
    • Calcul de la durée totale

Effets de transition

Utilisez @remotion/transitions de Remotion pour des effets professionnels :

  • Fondu : Transition en fondu enchaîné fluide entre les écrans

    import {fade} from '@remotion/transitions/fade';
    
  • Glissement : Transitions de glissement directionnelles

    import {slide} from '@remotion/transitions/slide';
    
  • Zoom : Effets de zoom avant/arrière pour l'accentuation

    • Utilisez l'animation spring() pour un zoom fluide
    • Appliquez aux éléments d'interface utilisateur importants

Superpositions de texte

Ajoutez des informations contextuelles en utilisant le rendu de texte de Remotion :

  1. Titres d'écran : Affichez en haut ou en bas de chaque image
  2. Points forts des fonctionnalités : Mettez en évidence des éléments d'interface spécifiques avec des pointeurs animés
  3. Descriptions : Apparition en fondu du texte descriptif pour chaque écran
  4. Indicateur de progression : Affichez la position actuelle de l'écran dans la démonstration

Étapes d'exécution

Étape 1 : Rassembler les ressources d'écran

  1. Identifiez le projet Stitch cible
  2. Listez tous les écrans du projet
  3. Téléchargez les captures d'écran pour chaque écran
  4. Organisez dans l'ordre du flux de démonstration
  5. Créez un fichier manifeste (screens.json) :
{
  "projectName": "Application Calculatrice",
  "screens": [
    {
      "id": "1",
      "title": "Écran d'accueil",
      "description": "Interface principale de la calculatrice avec pavé numérique",
      "imagePath": "assets/screens/home.png",
      "width": 1200,
      "height": 800,
      "duration": 4
    },
    {
      "id": "2",
      "title": "Vue Historique",
      "description": "Affichage des calculs précédents",
      "imagePath": "assets/screens/history.png",
      "width": 1200,
      "height": 800,
      "duration": 3
    }
  ]
}

Étape 2 : Générer les composants Remotion

Créez les composants vidéo en suivant les bonnes pratiques de Remotion :

  1. Créez ScreenSlide.tsx :

    • Utilisez useCurrentFrame() et spring() pour les animations
    • Implémentez les effets de zoom et de fondu
    • Ajoutez des superpositions de texte avec un timing approprié
  2. Créez WalkthroughComposition.tsx :

    • Importez le manifeste des écrans
    • Séquencez les écrans avec les composants <Sequence>
    • Appliquez des transitions entre les écrans
    • Calculez le timing et les décalages appropriés
  3. Mettez à jour remotion.config.ts :

    • Définissez l'ID de composition
    • Configurez les dimensions de la vidéo
    • Définissez la fréquence d'images et la durée

Ressources de référence :

  • Utilisez resources/screen-slide-template.tsx comme point de départ
  • Suivez resources/composition-checklist.md pour être complet
  • Consultez les exemples dans le répertoire examples/walkthrough/

Étape 3 : Prévisualiser et affiner

  1. Démarrer Remotion Studio :

    npm run dev
    
    • Ouvre un aperçu dans le navigateur
    • Permet l'édition et l'affinement en temps réel
  2. Ajuster le timing :

    • Assurez-vous que chaque écran a une durée d'affichage appropriée
    • Vérifiez que les transitions sont fluides
    • Contrôlez le timing des superpositions de texte
  3. Affiner les animations :

    • Ajustez les configurations spring pour les effets de zoom
    • Modifiez les fonctions d'assouplissement pour les transitions
    • Assurez-vous que le texte est lisible en tout temps

Étape 4 : Rendre la vidéo

  1. Rendu avec la CLI Remotion :

    npx remotion render WalkthroughComposition output.mp4
    
  2. Alternative : Utiliser le MCP Remotion (si disponible) :

    • Appelez [préfixe_remotion]:render avec les détails de la composition
    • Spécifiez le format de sortie (MP4, WebM, etc.)
  3. Options d'optimisation :

    • Définissez le niveau de qualité (--quality)
    • Configurez le codec (--codec h264 ou h265)
    • Activez le rendu parallèle (--concurrency)

Fonctionnalités avancées

Points chauds interactifs

Mettez en évidence les éléments cliquables ou les fonctionnalités importantes :

import {interpolate, useCurrentFrame} from 'remotion';

const Hotspot = ({x, y, label}) => {
  const frame = useCurrentFrame();
  const scale = spring({
    frame,
    fps: 30,
    config: {damping: 10, stiffness: 100}
  });
  
  return (
    <div style={{
      position: 'absolute',
      left: x,
      top: y,
      transform: `scale(${scale})`
    }}>
      <div className="pulse-ring" />
      <span>{label}</span>
    </div>
  );
};

Intégration de voix-off

Ajoutez une narration à la démonstration :

  1. Générez un script de voix-off à partir des descriptions d'écran
  2. Utilisez la synthèse vocale ou enregistrez l'audio
  3. Importez l'audio dans Remotion avec le composant <Audio>
  4. Synchronisez le timing des écrans avec le rythme de la voix-off

Extraction dynamique de texte

Extrayez le texte du code HTML Stitch pour des annotations automatiques :

  1. Téléchargez htmlCode.downloadUrl pour chaque écran
  2. Analysez le HTML pour extraire les éléments de texte clés (titres, boutons, étiquettes)
  3. Générez des points forts automatiques pour les éléments d'interface importants
  4. Ajoutez à la composition sous forme de superpositions de texte minutées

Structure des fichiers

projet/
├── video/                      # Répertoire du projet Remotion
│   ├── src/
│   │   ├── WalkthroughComposition.tsx
│   │   ├── ScreenSlide.tsx
│   │   ├── composants/
│   │   │   ├── Hotspot.tsx
│   │   │   └── TextOverlay.tsx
│   │   └── Root.tsx
│   ├── public/
│   │   └── assets/
│   │       └── screens/        # Captures d'écran Stitch téléchargées
│   │           ├── home.png
│   │           └── history.png
│   ├── remotion.config.ts
│   └── package.json
├── screens.json                # Manifeste des écrans
└── output.mp4                  # Vidéo rendue

Intégration avec les compétences Remotion

Remotion maintient ses propres compétences d'agent qui définissent les bonnes pratiques. Consultez-les pour des techniques avancées :

Compétences Remotion clés à exploiter :

  • Timing et assouplissement des animations
  • Modèles d'architecture de composition
  • Optimisation des performances
  • Synchronisation audio

Modèles courants

Modèle 1 : Diaporama simple

Démonstration de base avec transitions fondues :

  • 3 à 5 secondes par écran
  • Transitions en fondu enchaîné
  • Superposition de texte en bas avec le titre de l'écran
  • Barre de progression en haut

Modèle 2 : Mise en évidence des fonctionnalités

Concentrez-vous sur des éléments d'interface spécifiques :

  • Zoom sur des zones spécifiques
  • Cercles/flèches animés pointant vers les fonctionnalités
  • Accéléré au ralenti sur les interactions clés
  • Comparaisons avant/après côte à côte

Modèle 3 : Parcours utilisateur

Affichez le parcours utilisateur étape par étape :

  • Flux d'écran séquentiel avec diapositives directionnelles
  • Superposition d'étapes numérotées
  • Mettez en évidence les actions utilisateur (clics, tapotements)
  • Connectez les écrans avec des chemins animés

Dépannage

ProblèmeSolution
Captures d'écran flouesAssurez-vous que les images téléchargées sont en pleine résolution ; vérifiez les paramètres de qualité de screenshot.downloadUrl
Texte mal alignéVérifiez que les dimensions de l'écran correspondent à la taille de la composition ; ajustez le positionnement du texte en fonction de la taille réelle de l'écran
Animations saccadéesAugmentez la fréquence d'images à 60 ips ; utilisez des configurations spring appropriées avec un amortissement adéquat
Échec de la construction RemotionVérifiez la compatibilité de la version Node ; assurez-vous que toutes les dépendances sont installées ; consultez la documentation Remotion
Timing inappropriéAjustez la durée par écran dans le manifeste ; prévisualisez dans Remotion Studio ; testez avec de vrais utilisateurs

Bonnes pratiques

  1. Maintenez le rapport hauteur/largeur : Utilisez les dimensions réelles de l'écran Stitch ou redimensionnez proportionnellement
  2. Timing cohérent : Gardez la durée d'affichage des écrans cohérente, sauf pour mettre l'accent sur des écrans spécifiques
  3. Texte lisible : Assurez un contraste suffisant ; utilisez des tailles de police appropriées ; évitez les superpositions encombrées
  4. Transitions fluides : Utilisez des animations spring pour un mouvement naturel ; évitez les coupures brusques
  5. Prévisualisez minutieusement : Prévisualisez toujours dans Remotion Studio avant le rendu final
  6. Optimisez les ressources : Compressez les images correctement ; utilisez des formats efficaces (PNG pour l'interface utilisateur, JPG pour les photos)

Exemple d'utilisation

Invite utilisateur :

Recherche les écrans dans mon projet Stitch "Application Calculatrice" et crée une vidéo Remotion 
qui présente une démonstration des écrans.

Flux de travail de l'agent :

  1. Liste des projets Stitch → Trouve "Application Calculatrice" → Extrait l'ID du projet
  2. Liste des écrans du projet → Identifie tous les écrans (Accueil, Historique, Paramètres)
  3. Télécharge les captures d'écran pour chaque écran → Sauvegarde dans assets/screens/
  4. Crée le manifeste screens.json avec les métadonnées des écrans
  5. Génère les composants Remotion (ScreenSlide.tsx, WalkthroughComposition.tsx)
  6. Prévisualise dans Remotion Studio → Affine le timing et les transitions
  7. Rendu de la vidéo finale → calculator-walkthrough.mp4
  8. Signale l'achèvement avec un lien d'aperçu vidéo

Conseils pour réussir

  • Commencez simplement : Commencez par des transitions fondues de base avant d'ajouter des animations complexes
  • Suivez les modèles Remotion : Exploitez les compétences officielles et la documentation de Remotion
  • Utilisez des fichiers manifeste : Gardez les données d'écran organisées en JSON pour des mises à jour faciles
  • Prévisualisez fréquemment : Utilisez Remotion Studio pour détecter les problèmes tôt
  • Pensez à l'accessibilité : Ajoutez des légendes ; assurez-vous que le texte est lisible ; utilisez des visuels clairs
  • Optimisez pour la plateforme : Faites correspondre les dimensions de la vidéo à la plateforme cible (YouTube, réseaux sociaux, etc.)

Références

Quand l'utiliser

Utilisez cette compétence lorsque vous traitez des tâches liées à son domaine principal ou à ses fonctionnalités telles que décrites ci-dessus.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills associés