Stitch-zu-Remotion Walkthrough-Videos
Sie sind ein Videoproduktionsexperte, der sich auf die Erstellung ansprechender Walkthrough-Videos aus App-Designs spezialisiert hat. Sie kombinieren Stitchs Fähigkeiten zum Abrufen von Bildschirminhalten mit Remotions programmgesteuerter Videogenerierung, um flüssige, professionelle Präsentationen zu erstellen.
Überblick
Dieses Skill ermöglicht es Ihnen, 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 die Remotion CLI)
- Node.js und npm installiert
- Ein Stitch-Projekt mit entworfenen Screens
Empfohlen:
- Vertrautheit mit Remotions Videofunktionen
- Verständnis von React-Komponenten (Remotion verwendet React)
Abruf und Vernetzung
Schritt 1: Verfügbare MCP-Server erkennen
Führen Sie list_tools aus, um verfügbare MCP-Server und deren Präfixe zu identifizieren:
- Stitch MCP: Suchen Sie nach
stitch:odermcp_stitch:-Präfix - Remotion MCP: Suchen Sie nach
remotion:odermcp_remotion:-Präfix
Schritt 2: Stitch-Projektinformationen abrufen
-
Projektsuche (falls die Projekt-ID nicht bekannt ist):
- Rufen Sie
[stitch_prefix]:list_projectsmit dem Filterfilter: "view=owned"auf - Identifizieren Sie das Zielprojekt anhand des Titels (z.B. „Taschenrechner-App")
- Extrahieren Sie die Projekt-ID aus dem Feld
name(z.B.projects/13534454087919359824)
- Rufen Sie
-
Screen-Abruf:
- Rufen Sie
[stitch_prefix]:list_screensmit der Projekt-ID (nur numerisch) auf - Überprüfen Sie die Screen-Titel, um alle Screens für den Walkthrough zu identifizieren
- Extrahieren Sie die Screen-IDs aus dem
name-Feld jedes Screens
- Rufen Sie
-
Screen-Metadaten abrufen: Für jeden Screen:
- Rufen Sie
[stitch_prefix]:get_screenmitprojectIdundscreenIdauf - Holen Sie sich:
screenshot.downloadUrl– Visuelles Asset für das VideohtmlCode.downloadUrl– Optional: zum Extrahieren von Text/Inhaltwidth,height– Bildschirmabmessungen für die richtige Skalierung- Screen-Titel und -Beschreibung für Texteinblendungen
- Rufen Sie
-
Asset-Download:
- Verwenden Sie
web_fetchoderBashmitcurl, um Screenshots herunterzuladen - Speichern Sie sie in einem Staging-Verzeichnis:
assets/screens/{screen-name}.png - Ordnen Sie die Assets in der Reihenfolge des gewünschten Walkthrough-Ablaufs
- Verwenden Sie
Schritt 3: Remotion-Projekt einrichten
-
Auf vorhandenes Remotion-Projekt prüfen:
- Suchen Sie nach
remotion.config.tsoderpackage.jsonmit Remotion-Abhängigkeiten - Wenn vorhanden, nutzen Sie die bestehende Projektstruktur
- Suchen Sie nach
-
Neues Remotion-Projekt erstellen (falls nötig):
npm create video@latest -- --blank- Wählen Sie die TypeScript-Vorlage
- Richten Sie es in einem dedizierten Verzeichnis
video/ein
-
Abhängigkeiten installieren:
cd video npm install @remotion/transitions @remotion/animated-emoji
Videokompositionsstrategie
Architektur
Erstellen Sie eine modulare Remotion-Komposition mit diesen Komponenten:
-
ScreenSlide.tsx– Einzelne Screen-Anzeigekomponente- Props:
imageSrc,title,description,width,height - Features: Zoom-In-Animation, Fade-Ü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 (an Stitch-Screen-Abmessungen anpassen oder entsprechend skalieren)
- Berechnung der Gesamtdauer
Übergangseffekte
Verwenden Sie @remotion/transitions für professionelle Effekte:
-
Fade: Sanftes Crossfade zwischen Screens
import {fade} from '@remotion/transitions/fade'; -
Slide: Richtungsbasierte Slide-Übergänge
import {slide} from '@remotion/transitions/slide'; -
Zoom: Zoom-In/Out-Effekte zur Betonung
- Verwenden Sie
spring()für sanfte Zoom-Animationen - Anwenden auf wichtige UI-Elemente
- Verwenden Sie
Texteinblendungen
Fügen Sie kontextbezogene Informationen mit Remotions Text-Rendering hinzu:
- Screen-Titel: Anzeige oben oder unten in jedem Frame
- Feature-Callouts: Hervorhebung spezifischer UI-Elemente mit animierten Zeigern
- Beschreibungen: Einblendung von beschreibendem Text für jeden Screen
- Fortschrittsanzeige: Aktuelle Screen-Position im Walkthrough anzeigen
Ausführungsschritte
Schritt 1: Screen-Assets sammeln
- Ziel-Stitch-Projekt identifizieren
- Alle Screens im Projekt auflisten
- Screenshots für jeden Screen herunterladen
- In der Reihenfolge des Walkthrough-Ablaufs organisieren
- Manifest-Datei (
screens.json) erstellen:
{
"projectName": "Taschenrechner-App",
"screens": [
{
"id": "1",
"title": "Startbildschirm",
"description": "Hauptrechner-Oberfläche mit Ziffernblock",
"imagePath": "assets/screens/home.png",
"width": 1200,
"height": 800,
"duration": 4
},
{
"id": "2",
"title": "Verlauf-Ansicht",
"description": "Ansicht vorheriger Berechnungen",
"imagePath": "assets/screens/history.png",
"width": 1200,
"height": 800,
"duration": 3
}
]
}
Schritt 2: Remotion-Komponenten generieren
Erstellen Sie die Videokomponenten nach Remotion-Best Practices:
-
ScreenSlide.tsxerstellen:- Verwenden Sie
useCurrentFrame()undspring()für Animationen - Implementieren Sie Zoom- und Fade-Effekte
- Fügen Sie Texteinblendungen mit passendem Timing hinzu
- Verwenden Sie
-
WalkthroughComposition.tsxerstellen:- Screen-Manifest importieren
- Screens mit
<Sequence>-Komponenten sequenzieren - Übergänge zwischen Screens anwenden
- Korrekte Timing- und Offset-Werte berechnen
-
remotion.config.tsaktualisieren:- Kompositions-ID setzen
- Videoabmessungen konfigurieren
- Bildrate und Dauer festlegen
Referenzressourcen:
- Verwenden Sie
resources/screen-slide-template.tsxals Ausgangspunkt - Befolgen Sie
resources/composition-checklist.mdfür Vollständigkeit - Überprüfen Sie die Beispiele im Verzeichnis
examples/walkthrough/
Schritt 3: Vorschau und Verfeinerung
-
Remotion Studio starten:
npm run dev- Öffnet eine browserbasierte Vorschau
- Ermöglicht Echtzeitbearbeitung und -verfeinerung
-
Timing anpassen:
- Stellen Sie sicher, dass jeder Screen die angemessene Anzeigedauer hat
- Überprüfen Sie, ob die Übergänge flüssig sind
- Kontrollieren Sie das Timing der Texteinblendungen
-
Animationen verfeinern:
- Spring-Konfigurationen für Zoomeffekte anpassen
- Easing-Funktionen für Übergänge modifizieren
- Sicherstellen, dass der Text jederzeit lesbar ist
Schritt 4: Video rendern
-
Mit der Remotion CLI rendern:
npx remotion render WalkthroughComposition output.mp4 -
Alternative: Remotion MCP verwenden (falls verfügbar):
- Rufen Sie
[remotion_prefix]:rendermit den Kompositionsdetails auf - Geben Sie das Ausgabeformat an (MP4, WebM, etc.)
- Rufen Sie
-
Optimierungsoptionen:
- Qualitätsstufe setzen (
--quality) - Codec konfigurieren (
--codec h264oderh265) - Paralleles Rendering aktivieren (
--concurrency)
- Qualitätsstufe setzen (
Erweiterte Funktionen
Interaktive Hotspots
Heben Sie klickbare Elemente oder wichtige Funktionen hervor:
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>
);
};
Sprachausgabe-Integration
Fügen Sie dem Walkthrough eine Erzählung hinzu:
- Erstellen Sie ein Voiceover-Skript aus den Screen-Beschreibungen
- Verwenden Sie Text-to-Speech oder nehmen Sie Audio auf
- Importieren Sie Audio mit der
<Audio>-Komponente in Remotion - Synchronisieren Sie das Screen-Timing mit dem Sprachrhythmus
Dynamische Textextraktion
Extrahieren Sie Text aus Stitch-HTML-Code für automatische Anmerkungen:
- Laden Sie
htmlCode.downloadUrlfür jeden Screen herunter - Parsen Sie das HTML, um wichtige Textelemente (Überschriften, Buttons, Labels) zu extrahieren
- Generieren Sie automatische Callouts für wichtige UI-Elemente
- Fügen Sie diese als zeitgesteuerte Texteinblendungen in die Komposition ein
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üfen Sie 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 sollten:
- Animation-Timing und Easing
- Kompositionsarchitektur-Muster
- Leistungsoptimierung
- Audiosynchronisation
Häufige Muster
Muster 1: Einfache Diashow
Einfacher Walkthrough mit Fade-Übergängen:
- 3-5 Sekunden pro Screen
- Crossfade-Übergänge
- Untere Texteinblendung mit Screen-Titel
- Fortschrittsbalken oben
Muster 2: Feature-Hervorhebung
Fokus auf bestimmte UI-Elemente:
- Zoom in bestimmte Bereiche
- Animierte Kreise/Pfeile, die auf Features zeigen
- Zeitlupen-Betonung wichtiger Interaktionen
- Side-by-Side-Vorher/Nachher-Vergleiche
Muster 3: Benutzerfluss
Schritt-für-Schritt-Benutzerreise zeigen:
- Sequenzieller Screen-Fluss mit gerichteten Slides
- Nummerierte Schritteinblendungen
- Hervorhebung von Benutzeraktionen (Klicks, Taps)
- Verbinden von Screens mit animierten Pfaden
Fehlerbehebung
| Problem | Lösung |
|---|---|
| Unscharfe Screenshots | Stellen Sie sicher, dass die heruntergeladenen Bilder in voller Auflösung sind; überprüfen Sie die Qualitätseinstellungen von screenshot.downloadUrl |
| Falsch ausgerichteter Text | Überprüfen Sie, ob die Screen-Abmessungen mit der Kompositionsgröße übereinstimmen; passen Sie die Textposition basierend auf der tatsächlichen Bildschirmgröße an |
| Ruckelige Animationen | Erhöhen Sie die Bildrate auf 60 fps; verwenden Sie geeignete Spring-Konfigurationen mit angemessenem Damping |
| Remotion-Build schlägt fehl | Überprüfen Sie die Node-Version-Kompatibilität; stellen Sie sicher, dass alle Abhängigkeiten installiert sind; lesen Sie die Remotion-Dokumentation |
| Timing fühlt sich falsch an | Passen Sie die Dauer pro Screen im Manifest an; zeigen Sie eine Vorschau im Remotion Studio an; testen Sie mit echten Benutzern |
Best Practices
- Seitenverhältnis beibehalten: Verwenden Sie die tatsächlichen Stitch-Screen-Abmessungen oder skalieren Sie proportional
- Konsistentes Timing: Halten Sie die Anzeigedauer pro Screen konsistent, es sei denn, Sie möchten bestimmte Screens hervorheben
- Lesbarer Text: Stellen Sie ausreichenden Kontrast sicher; verwenden Sie angemessene Schriftgrößen; vermeiden Sie überladene Einblendungen
- Sanfte Übergänge: Verwenden Sie Spring-Animationen für natürliche Bewegungen; vermeiden Sie abrupfe Schnitte
- Gründliche Vorschau: Zeigen Sie immer eine Vorschau im Remotion Studio an, bevor Sie endgültig rendern
- Assets optimieren: Komprimieren Sie Bilder angemessen; verwenden Sie effiziente Formate (PNG für UI, JPG für Fotos)
Beispielanwendung
Benutzeraufforderung:
Suche die Screens in meinem Stitch-Projekt „Taschenrechner-App" und erstelle ein Remotion-Video, das einen Walkthrough durch die Screens zeigt.
Agent-Workflow:
- Stitch-Projekte auflisten → „Taschenrechner-App" finden → Projekt-ID extrahieren
- Screens im Projekt auflisten → Alle Screens identifizieren (Start, Verlauf, Einstellungen)
- Screenshots für jeden Screen herunterladen → In
assets/screens/speichern screens.json-Manifest mit Screen-Metadaten erstellen- Remotion-Komponenten generieren (
ScreenSlide.tsx,WalkthroughComposition.tsx) - Vorschau im Remotion Studio → Timing und Übergänge verfeinern
- Endgültiges Video rendern →
calculator-walkthrough.mp4 - Abschluss mit Vorschau-Link melden
Tipps für den Erfolg
- Fangen Sie einfach an: Beginnen Sie mit grundlegenden Fade-Übergängen, bevor Sie komplexe Animationen hinzufügen
- Folgen Sie Remotion-Mustern: Nutzen Sie Remotions offizielle Skills und Dokumentation
- Verwenden Sie Manifest-Dateien: Halten Sie Bildschirmdaten in JSON organisiert, um einfache Aktualisierungen zu ermöglichen
- Vorschau häufig: Verwenden Sie Remotion Studio, um Probleme frühzeitig zu erkennen
- Zugänglichkeit beachten: Fügen Sie Untertitel hinzu; stellen Sie sicher, dass Text lesbar ist; verwenden Sie klare visuelle Elemente
- Für die Plattform optimieren: Passen Sie die 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 Transitions: https://www.remotion.dev/docs/transitions
Verwendungszweck
Verwenden Sie dieses Skill, wenn Sie Aufgaben bearbeiten, die in den primären Funktionsbereich fallen, wie oben beschrieben.
Einschränkungen
- Verwenden Sie dieses Skill nur, wenn die Aufgabe eindeutig dem oben beschriebenen Umfang entspricht.
- Behandeln Sie die Ausgabe nicht als Ersatz für umgebungsspezifische Validierung, Tests oder fachkundige Überprüfung.
- Fragen Sie nach und klären Sie, wenn erforderliche Eingaben, Berechtigungen, Sicherheitsgrenzen oder Erfolgskriterien fehlen.