Communitygithub.com

stitch-remotion

Vous êtes un spécialiste de la production vidéo axé sur la création de vidéos de présentation engageantes à 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.

Qu'est-ce que stitch-remotion ?

Cette compétence permet de créer des vidéos de présentation interactives à partir de maquettes d'applications en combinant Stitch (récupération d'écrans) et Remotion (génération vidéo programmatique). Elle est utile pour les développeurs et concepteurs souhaitant produire rapidement des démonstrations professionnelles de leurs applications sans montage manuel. La compétence prend en charge les environnements Claude Code, Cursor et autres agents exploitant les MCP Stitch et Remotion. Le flux de travail commence par la récupération des écrans d'un projet Stitch via le serveur MCP Stitch, le téléchargement des captures d'écran et des métadonnées, puis la création d'une composition Remotion avec des transitions fluides (fondu, glissement, zoom), des superpositions de texte et des annotations interactives. Le résultat final est une vidéo MP4 ou WebM prête à être partagée ou intégrée.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/XideaDev/codot-skill/tree/HEAD/skills/stitch/stitch-remotion

Demander à votre IA préférée

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

Documentation

Adaptation au runtime Codot

  • Stitch MCP : fourni de manière centralisée via Codot Settings → MCP (recherchez les outils préfixés par stitch: ou mcp__stitch__). Ne reconfigurez pas les fichiers MCP par agent.
  • Vérification visuelle et navigateur : privilégiez les outils browser_* intégrés de Codot (browser_navigate, browser_snapshot, browser_screenshot, browser_console) plutôt que le MCP Chrome DevTools externe pour inspecter les serveurs de dev locaux ou les pages rendues.
  • Livraison visuelle : show_preview est hors ligne et ne peut pas accéder au réseau ; le HTML exporté par Stitch repose sur le CDN Tailwind/polices et s'affiche vide s'il est passé directement. Utilisez la compétence stitch-preview (serveur statique local + browser_* pour une fidélité/interaction totale, ou stitch-offline.mjs + show_preview pour un aperçu HTML dans le chat, ou show_preview directement sur des captures d'écran .png).
  • Téléchargement des ressources : utilisez toujours download_file du MCP Stitch (avec htmlCode.name / screenshot.name), jamais curl sur downloadUrl (qui nécessite des identifiants et renvoie un wrapper JSON). Si la sortie de download_file est tronquée dans un fichier temporaire, décodez-la avec stitch-preview/scripts/save-stitch-file.mjs.
  • Paramètres d'objet : si un outil MCP échoue avec expected object, got string (certains runtimes d'agent sérialisent les arguments d'objet en chaînes), passez au workflow de secours uniquement textuel dans stitch-manage-design-system au lieu de réessayer le même appel en échec.
  • Appels de longue durée : si generate_screen_from_text ou edit_screens expire, interrogez list_screens toutes les 60 secondes pendant environ 5 minutes (5 interrogations) ; si aucun nouvel écran n'apparaît, réémettez l'appel une fois au lieu d'attendre indéfiniment.
  • Correspondance d'outils : mappez les noms d'outils génériques (Read, Write, Edit, Bash) sur les outils du harnais Codot actif (read, write, edit, bash).

Vidéos de présentation Stitch vers Remotion

Vous êtes un spécialiste de la production vidéo axé sur la création de vidéos de présentation engageantes à 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.

Présentation

Cette compétence vous permet de créer des vidéos de présentation qui mettent en valeur 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 dans une composition vidéo Remotion.

Prérequis

Requis :

  • Accès au serveur MCP Stitch
  • Accès au serveur MCP Remotion (ou à l'interface 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)
    • Examinez les titres des écrans pour identifier tous les écrans de la présentation
    • 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 le name de la ressource d'écran (projects/{project}/screens/{screen})
    • Récupérez :
      • screenshot.name (projects/{project}/files/{file}) — Ressource visuelle pour la vidéo
      • htmlCode.name (projects/{project}/files/{file}) — Optionnel : pour extraire du texte/contenu
      • width, height — Dimensions de l'écran pour un dimensionnement correct
      • Titre et description de l'écran pour les superpositions de texte
  4. Téléchargement des ressources :

    • Appelez [préfixe_stitch]:download_file du MCP Stitch avec screenshot.name (n'utilisez pas curl ou web_fetch sur downloadUrl, qui nécessite des identifiants et renvoie un wrapper JSON)
    • Si la sortie de download_file est tronquée dans un fichier temporaire, décodez-la avec : node skills/stitch/stitch-preview/scripts/save-stitch-file.mjs <sortie-outil> assets/screens/{nom-écran}.png
    • Organisez les ressources dans l'ordre du flux de présentation souhaité

Étape 3 : Configurer le projet Remotion

  1. Vérifier s'il existe un projet Remotion existant :

    • Recherchez remotion.config.ts ou package.json avec des dépendances Remotion
    • Si c'est le cas, 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 en fondu
    • Durée : Configurable (par défaut 3 à 5 secondes par écran)
  2. WalkthroughComposition.tsx — Composition vidéo principale

    • Séquençage de plusieurs composants ScreenSlide
    • Gestion des transitions entre les écrans
    • Ajout de superpositions de texte et d'annotations
  3. config.ts — Configuration vidéo

    • Fréquence d'images (par défaut : 30 ips)
    • Dimensions de la vidéo (correspondent aux dimensions des écrans Stitch ou mise à l'échelle appropriée)
    • Calcul de la durée totale

Effets de transition

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

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

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

    import {slide} from '@remotion/transitions/slide';
    
  • Zoom : effets de zoom avant/arrière pour mettre en valeur

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

Superpositions de texte

Ajoutez des informations contextuelles à l'aide du rendu texte de Remotion :

  1. Titres d'écran : affichés en haut ou en bas de chaque image
  2. Annotations de fonctionnalités : mettez en évidence des éléments d'interface spécifiques avec des pointeurs animés
  3. Descriptions : texte descriptif qui apparaît en fondu pour chaque écran
  4. Indicateur de progression : affiche la position actuelle de l'écran dans la présentation

É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 des captures d'écran pour chaque écran
  4. Organisez-les dans l'ordre du flux de présentation
  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 de l'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 d'écran
    • 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/

Étape 3 : Prévisualiser et affiner

  1. Démarrez Remotion Studio :

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

    • Assurez-vous que chaque écran a une durée d'affichage appropriée
    • Vérifiez que les transitions sont fluides
    • Vérifiez le timing des superpositions de texte
  3. Affinez 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 à tout moment

Étape 4 : Rendre la vidéo

  1. Rendu à l'aide de la CLI Remotion :

    npx remotion render WalkthroughComposition output.mp4
    
  2. Alternative : utilisez 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

Zones interactives (Hotspots)

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 narration (Voiceover)

Ajoutez une narration à la présentation :

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

Extraction dynamique de texte

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

  1. Appelez [préfixe_stitch]:download_file avec htmlCode.name pour chaque écran (décodez la sortie tronquée avec save-stitch-file.mjs)
  2. Analysez le HTML pour extraire les éléments de texte clés (titres, boutons, étiquettes)
  3. Générez des annotations automatiques pour les éléments d'interface utilisateur importants
  4. Ajoutez à la composition sous forme de superpositions de texte chronométrées

Structure de fichiers

project/
├── video/                      # Répertoire du projet Remotion
│   ├── src/
│   │   ├── WalkthroughComposition.tsx
│   │   ├── ScreenSlide.tsx
│   │   ├── components/
│   │   │   ├── 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

Présentation de base avec transitions en fondu :

  • 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 régions spécifiques
  • Cercles/flèches animés pointant vers les fonctionnalités
  • Accentuation au ralenti des interactions clés
  • Comparaisons avant/après côte à côte

Modèle 3 : Parcours utilisateur

Montrez le parcours utilisateur étape par étape :

  • Flux d'écrans séquentiel avec glissements directionnels
  • Superposition d'étapes numérotées
  • Mise en évidence des actions utilisateur (clics, tap)
  • Connexion des é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 via download_file (screenshot.name) plutôt que des vignettes compressées
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 des utilisateurs réels

Bonnes pratiques

  1. Maintenez le rapport hauteur/largeur : utilisez les dimensions réelles des écrans Stitch ou mettez-les à l'échelle proportionnellement
  2. Timing cohérent : conservez une durée d'affichage cohérente pour chaque écran, sauf si vous souhaitez 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 de manière appropriée ; utilisez des formats efficaces (PNG pour l'UI, JPG pour les photos)

Exemple d'utilisation

Invite utilisateur :

Consulte les écrans de mon projet Stitch "Application Calculatrice" et crée une vidéo Remotion 
qui montre une présentation des écrans.

Flux de travail de l'agent :

  1. Lister les projets Stitch → Trouver "Application Calculatrice" → Extraire l'ID du projet
  2. Lister les écrans du projet → Identifier tous les écrans (Accueil, Historique, Paramètres)
  3. Télécharger des captures d'écran pour chaque écran → Enregistrer dans assets/screens/
  4. Créer un manifeste screens.json avec les métadonnées d'écran
  5. Générer les composants Remotion (ScreenSlide.tsx, WalkthroughComposition.tsx)
  6. Prévisualiser dans Remotion Studio → Affiner le timing et les transitions
  7. Rendre la vidéo finale → calculator-walkthrough.mp4
  8. Signaler la fin avec un lien de prévisualisation vidéo

Conseils pour réussir

  • Commencez simplement : commencez par un diaporama de base avant d'ajouter des fonctionnalités avancées
  • Itérez rapidement : utilisez l'aperçu en direct de Remotion Studio pour des itérations rapides
  • Testez avec de vraies données : utilisez des captures d'écran réelles de Stitch pour des résultats précis
  • Recueillez des retours : partagez des prévisualisations avec les parties prenantes pour validation
  • Documentez votre travail : conservez un manifeste d'écran et des configurations pour une reproductibilité

Skills associés