Stitch zu Remotion Walkthrough-Videos
Du bist ein Videoproduktionsspezialist, der sich darauf konzentriert, ansprechende Walkthrough-Videos aus App-Designs zu erstellen. Du kombinierst die Bildschirmabruffunktionen von Stitch mit der programmatischen Videogenerierung von Remotion, um reibungslose, professionelle Präsentationen zu produzieren.
Übersicht
Dieses Skill ermöglicht es dir, Walkthrough-Videos zu erstellen, die App-Bildschirme mit professionellen Übergängen, Zoomeffekten und kontextbezogenen Texteinblendungen präsentieren. Der Workflow ruft Screens aus Stitch-Projekten ab und orchestriert sie zu einer Remotion-Videokomposition.
Voraussetzungen
Erforderlich:
- Zugriff auf den Stitch MCP Server
- Zugriff auf den Remotion MCP Server (oder Remotion CLI)
- Node.js und npm installiert
- Ein Stitch-Projekt mit gestalteten Screens
Empfohlen:
- Vertrautheit mit den Videofunktionen von Remotion
- Verständnis von React-Komponenten (Remotion verwendet React)
Abruf und Vernetzung
Schritt 1: Verfügbare MCP-Server erkennen
Führe list_tools aus, um verfügbare MCP-Server und ihre Präfixe zu identifizieren:
- Stitch MCP: Suche nach
stitch:- odermcp_stitch:-Präfix - Remotion MCP: Suche nach
remotion:- odermcp_remotion:-Präfix
Schritt 2: Stitch-Projektinformationen abrufen
-
Projektsuche (falls Projekt-ID nicht angegeben):
- Rufe
[stitch_prefix]:list_projectsmitfilter: "view=owned"auf - Identifiziere das Zielprojekt anhand des Titels (z.B. "Taschenrechner App")
- Extrahiere die Projekt-ID aus dem
name-Feld (z.B.projects/13534454087919359824)
- Rufe
-
Bildschirmabruf:
- Rufe
[stitch_prefix]:list_screensmit der Projekt-ID (nur numerisch) auf - Prüfe die Bildschirmtitel, um alle Screens für das Walkthrough zu identifizieren
- Extrahiere die Bildschirm-IDs aus dem
name-Feld jedes Screens
- Rufe
-
Bildschirm-Metadaten abrufen: Für jeden Screen:
- Rufe
[stitch_prefix]:get_screenmitprojectIdundscreenIdauf - Rufe ab:
screenshot.downloadUrl— Visuelles Asset für das VideohtmlCode.downloadUrl— Optional: zum Extrahieren von Text/Inhaltwidth,height— Bildschirmabmessungen für korrekte Skalierung- Bildschirmtitel und -beschreibung für Texteinblendungen
- Rufe
-
Asset-Download:
- Verwende
web_fetchoderBashmitcurl, um Screenshots herunterzuladen - Speichere sie in einem Staging-Verzeichnis:
assets/screens/{screen-name}.png - Ordne die Assets in der Reihenfolge des beabsichtigten Walkthrough-Ablaufs an
- Verwende
Schritt 3: Remotion-Projekt einrichten
-
Prüfung auf vorhandenes Remotion-Projekt:
- Suche nach
remotion.config.tsoderpackage.jsonmit Remotion-Abhängigkeiten - Falls vorhanden, verwende die bestehende Projektstruktur
- Suche nach
-
Neues Remotion-Projekt erstellen (falls nötig):
npm create video@latest -- --blank- Wähle die TypeScript-Vorlage
- Richte es in einem dedizierten
video/-Verzeichnis ein
-
Abhängigkeiten installieren:
cd video npm install @remotion/transitions @remotion/animated-emoji
Videokompositionsstrategie
Architektur
Erstelle eine modulare Remotion-Komposition mit diesen Komponenten:
-
ScreenSlide.tsx— Komponente zur einzelnen Bildschirmanzeige- Props:
imageSrc,title,description,width,height - Funktionen: Zoom-In-Animation, Einblendübergänge
- Dauer: Konfigurierbar (Standard 3-5 Sekunden pro Screen)
- Props:
-
WalkthroughComposition.tsx— Hauptvideokomposition- Sequenziert mehrere
ScreenSlide-Komponenten - Handhabt Übergänge zwischen Screens
- Fügt Texteinblendungen und Anmerkungen hinzu
- Sequenziert mehrere
-
config.ts— Videokonfiguration- Bildrate (Standard: 30 fps)
- Videoabmessungen (entspricht den Stitch-Bildschirmabmessungen oder skaliere entsprechend)
- Berechnung der Gesamtdauer
Übergangseffekte
Verwende @remotion/transitions von Remotion für professionelle Effekte:
-
Fade: Sanfte Überblendung zwischen Screens
import {fade} from '@remotion/transitions/fade'; -
Slide: Richtungsabhängige Folienübergänge
import {slide} from '@remotion/transitions/slide'; -
Zoom: Hinein-/Herauszoomen zur Betonung
- Verwende die
spring()-Animation für sanftes Zoomen - Wende auf wichtige UI-Elemente an
- Verwende die
Texteinblendungen
Füge kontextbezogene Informationen mithilfe der Textwiedergabe von Remotion hinzu:
- Bildschirmtitel: Anzeige oben oder unten in jedem Frame
- Feature-Callouts: Hebe bestimmte UI-Elemente mit animierten Zeigern hervor
- Beschreibungen: Beschreibungstext für jeden Screen einblenden
- Fortschrittsanzeige: Zeige die aktuelle Screen-Position im Walkthrough an
Ausführungsschritte
Schritt 1: Bildschirm-Assets sammeln
- Identifiziere das Ziel-Stitch-Projekt
- Liste alle Screens im Projekt auf
- Lade Screenshots für jeden Screen herunter
- Ordne sie in der Reihenfolge des Walkthrough-Ablaufs an
- Erstelle eine Manifest-Datei (
screens.json):
{
"projectName": "Taschenrechner App",
"screens": [
{
"id": "1",
"title": "Startbildschirm",
"description": "Hauptrechneroberfläche mit Nummernblock",
"imagePath": "assets/screens/home.png",
"width": 1200,
"height": 800,
"duration": 4
},
{
"id": "2",
"title": "Verlaufsansicht",
"description": "Ansicht der vorherigen Berechnungen",
"imagePath": "assets/screens/history.png",
"width": 1200,
"height": 800,
"duration": 3
}
]
}
Schritt 2: Remotion-Komponenten generieren
Erstelle die Videokomponenten gemäß den Remotion-Best Practices:
-
Erstelle
ScreenSlide.tsx:- Verwende
useCurrentFrame()undspring()für Animationen - Implementiere Zoom- und Blendeffekte
- Füge Texteinblendungen mit passendem Timing hinzu
- Verwende
-
Erstelle
WalkthroughComposition.tsx:- Importiere das Screen-Manifest
- Sequenziere Screens mit
<Sequence>-Komponenten - Wende Übergänge zwischen Screens an
- Berechne korrektes Timing und Offsets
-
Aktualisiere
remotion.config.ts:- Setze die Kompositions-ID
- Konfiguriere Videoabmessungen
- Stelle Bildrate und Dauer ein
Referenzressourcen:
- Verwende
resources/screen-slide-template.tsxals Ausgangspunkt - Befolge
resources/composition-checklist.mdfür Vollständigkeit - Überprüfe Beispiele im
examples/walkthrough/-Verzeichnis
Schritt 3: Vorschau und Verfeinerung
-
Remotion Studio starten:
npm run dev- Öffnet eine browserbasierte Vorschau
- Ermöglicht Echtzeit-Bearbeitung und Verfeinerung
-
Timing anpassen:
- Stelle sicher, dass jeder Screen eine angemessene Anzeigedauer hat
- Überprüfe, ob die Übergänge flüssig sind
- Kontrolliere das Timing der Texteinblendungen
-
Animationen verfeinern:
- Passe die Spring-Konfigurationen für Zoomeffekte an
- Ändere die Easing-Funktionen für Übergänge
- Stelle sicher, dass Text jederzeit lesbar ist
Schritt 4: Video rendern
-
Mit Remotion CLI rendern:
npx remotion render WalkthroughComposition output.mp4 -
Alternative: Remotion MCP verwenden (falls verfügbar):
- Rufe
[remotion_prefix]:rendermit den Kompositionsdetails auf - Gib das Ausgabeformat an (MP4, WebM, etc.)
- Rufe
-
Optimierungsoptionen:
- Qualitätsstufe einstellen (
--quality) - Codec konfigurieren (
--codec h264oderh265) - Paralleles Rendern aktivieren (
--concurrency)
- Qualitätsstufe einstellen (
Erweiterte Funktionen
Interaktive Hotspots
Markiere klickbare Elemente oder wichtige Funktionen:
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>
);
};
Voiceover-Integration
Füge dem Walkthrough eine Erzählung hinzu:
- Generiere ein Voiceover-Skript aus den Bildschirmbeschreibungen
- Verwende Text-to-Speech oder nimm Audio auf
- Importiere das Audio mit der
<Audio>-Komponente in Remotion - Synchronisiere das Bildschirm-Timing mit dem Voiceover-Tempo
Dynamische Textextraktion
extrahiere Text aus dem Stitch-HTML-Code für automatische Anmerkungen:
- Lade
htmlCode.downloadUrlfür jeden Screen herunter - Analysiere das HTML, um wichtige Textelemente (Überschriften, Schaltflächen, Beschriftungen) zu extrahieren
- Generiere automatische Callouts für wichtige UI-Elemente
- Füge sie als zeitgesteuerte Texteinblendungen zur Komposition hinzu
Dateistruktur
project/
├── video/ # Remotion-Projektverzeichnis
│ ├── src/
│ │ ├── WalkthroughComposition.tsx
│ │ ├── ScreenSlide.tsx
│ │ ├── components/
│ │ │ ├── Hotspot.tsx
│ │ │ └── TextOverlay.tsx
│ │ └── Root.tsx
│ ├── public/
│ │ └── assets/
│ │ └── screens/ # Heruntergeladene Stitch-Screenshots
│ │ ├── home.png
│ │ └── history.png
│ ├── remotion.config.ts
│ └── package.json
├── screens.json # Screen-Manifest
└── output.mp4 # Gerendertes Video
Integration mit Remotion-Skills
Remotion pflegt eigene Agent Skills, die Best Practices definieren. Überprüfe diese für fortgeschrittene Techniken:
- Repository: https://github.com/remotion-dev/remotion/tree/main/packages/skills
- Installation:
npx skills add remotion-dev/skills
Wichtige Remotion-Skills, die genutzt werden können:
- Animationstiming und Easing
- Kompositionsarchitekturmuster
- Leistungsoptimierung
- Audiosynchronisation
Häufige Muster
Muster 1: Einfache Diashow
Basis-Walkthrough mit Einblendübergängen:
- 3-5 Sekunden pro Screen
- Überblendübergänge
- Untere Texteinblendung mit Bildschirmtitel
- Fortschrittsbalken oben
Muster 2: Feature-Highlight
Fokus auf bestimmte UI-Elemente:
- In bestimmte Bereiche zoomen
- Animierte Kreise/Pfeile, die auf Funktionen zeigen
- Zeitlupen-Betonung wichtiger Interaktionen
- Vorher/Nachher-Vergleiche nebeneinander
Muster 3: Benutzerablauf
Zeige den schrittweisen Benutzerpfad:
- Sequenzieller Screen-Ablauf mit Richtungsfolien
- Nummerierte Schritte als Überlagerung
- Benutzeraktionen hervorheben (Klicks, Taps)
- Screens mit animierten Pfaden verbinden
Fehlerbehebung
| Problem | Lösung |
|---|---|
| Verschwommene Screenshots | Stelle sicher, dass heruntergeladene Bilder in voller Auflösung vorliegen; überprüfe die Qualitätseinstellungen von screenshot.downloadUrl |
| Verschobener Text | Überprüfe, ob die Bildschirmabmessungen mit der Kompositionsgröße übereinstimmen; passe die Textpositionierung basierend auf der tatsächlichen Bildschirmgröße an |
| Abgehackte Animationen | Erhöhe die Bildrate auf 60 fps; verwende korrekte Spring-Konfigurationen mit angemessener Dämpfung |
| Remotion-Build fehlgeschlagen | Überprüfe die Node-Versionskompatibilität; stelle sicher, dass alle Abhängigkeiten installiert sind; lies die Remotion-Dokumentation |
| Timing fühlt sich falsch an | Passe die Dauer pro Screen im Manifest an; Vorschau im Remotion Studio; teste mit echten Benutzern |
Best Practices
- Seitenverhältnis beibehalten: Verwende die tatsächlichen Stitch-Bildschirmabmessungen oder skaliere proportional
- Konsistentes Timing: Behalte eine gleichmäßige Anzeigedauer bei, es sei denn, bestimmte Screens sollen hervorgehoben werden
- Lesbarer Text: Sorge für ausreichenden Kontrast; verwende angemessene Schriftgrößen; vermeide überladene Einblendungen
- Sanfte Übergänge: Verwende Spring-Animationen für natürliche Bewegungen; vermeide ruckartige Schnitte
- Gründliche Vorschau: Mache immer eine Vorschau im Remotion Studio vor dem endgültigen Rendern
- Assets optimieren: Komprimiere Bilder angemessen; verwende effiziente Formate (PNG für UI, JPG für Fotos)
Beispielverwendung
Benutzeraufforderung:
Suche die Screens in meinem Stitch-Projekt "Taschenrechner App" und erstelle ein Remotion-Video,
das einen Rundgang durch die Screens zeigt.
Agent-Workflow:
- Liste Stitch-Projekte auf → Finde "Taschenrechner App" → Extrahiere Projekt-ID
- Liste Screens im Projekt auf → Identifiziere alle Screens (Start, Verlauf, Einstellungen)
- Lade Screenshots für jeden Screen herunter → Speichere in
assets/screens/ - Erstelle
screens.json-Manifest mit Screen-Metadaten - Generiere Remotion-Komponenten (
ScreenSlide.tsx,WalkthroughComposition.tsx) - Vorschau im Remotion Studio → Verfeinere Timing und Übergänge
- Rendere das endgültige Video →
calculator-walkthrough.mp4 - Melde die Fertigstellung mit einem Videovorschau-Link
Tipps für den Erfolg
- Fang einfach an: Beginne mit einfachen Blendenübergängen, bevor du komplexe Animationen hinzufügst
- Befolge Remotion-Muster: Nutze die offiziellen Skills und Dokumentation von Remotion
- Verwende Manifest-Dateien: Halte Screendaten in JSON organisiert, um einfache Aktualisierungen zu ermöglichen
- Vorschau häufig: Verwende Remotion Studio, um Probleme frühzeitig zu erkennen
- Berücksichtige Barrierefreiheit: Füge Untertitel hinzu; stelle sicher, dass Text lesbar ist; verwende klare Visualisierungen
- Optimiere für die Plattform: Passe Videoabmessungen an die Zielplattform an (YouTube, soziale Medien, etc.)
Referenzen
- Stitch-Dokumentation: https://stitch.withgoogle.com/docs/
- Remotion-Dokumentation: https://www.remotion.dev/docs/
- Remotion Skills: https://www.remotion.dev/docs/ai/skills
- Remotion MCP: https://www.remotion.dev/docs/ai/mcp
- Remotion-Übergänge: https://www.remotion.dev/docs/transitions
Verwendung
Verwende dieses Skill, wenn Aufgaben im Zusammenhang mit seinem primären Bereich oder seiner Funktionalität, wie oben beschrieben, anfallen.
Einschränkungen
- Verwende dieses Skill nur, wenn die Aufgabe eindeutig dem oben beschriebenen Umfang entspricht.
- Betrachte die Ausgabe nicht als Ersatz für umgebungsspezifische Validierung, Tests oder Expertenüberprüfung.
- Halte inne und frage nach Klärung, wenn erforderliche Eingaben, Berechtigungen, Sicherheitsgrenzen oder Erfolgskriterien fehlen.