Communitygithub.com

Stitch-Remotion Walkthrough-Videos

Sie sind ein Videoproduktionsspezialist, der ansprechende Walkthrough-Videos aus App-Designs erstellt. Sie kombinieren Stitchs Bildschirmerfassung mit Remotions programmatischer Videogenerierung, um flüssige, professionelle Präsentationen zu produzieren.

Was ist Stitch-Remotion Walkthrough-Videos?

Diese Fähigkeit ermöglicht es KI-Agenten, Walkthrough-Videos zu erstellen, die App-Bildschirme mit professionellen Übergängen, Zoomeffekten und kontextuellen Texteinblendungen präsentieren. Der Arbeitsablauf ruft Bildschirme aus Stitch-Projekten ab und orchestriert sie in einer Remotion-Videokomposition. Sie unterstützt die Agentenplattformen Codot, Cursor und standardisierte MCP-Umgebungen. Die Fähigkeit umfasst eine detaillierte Schritt-für-Schritt-Anleitung zur Projekteinrichtung, Bildschirmerfassung, Asset-Verwaltung und Videogenerierung. Sie definiert Komponenten wie `ScreenSlide.tsx` und `WalkthroughComposition.tsx` und bietet erweiterte Funktionen wie interaktive Hotspots, Sprachintegration und dynamische Textextraktion aus Stitch HTML-Code.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Codot Runtime Anpassung

  • Stitch MCP: Wird zentral über Codot Einstellungen → MCP bereitgestellt (suchen Sie nach Tools mit dem Präfix stitch: oder mcp__stitch__). Konfigurieren Sie MCP-Dateien nicht pro Agent neu.
  • Browser & Visuelle Überprüfung: Bevorzugen Sie Codots integrierte browser_*-Tools (browser_navigate, browser_snapshot, browser_screenshot, browser_console) gegenüber externen Chrome DevTools MCP, wenn Sie lokale Entwicklungsserver oder gerenderte Seiten überprüfen.
  • Visuelle Bereitstellung: show_preview ist offline und hat keinen Netzwerkzugriff; exportiertes Stitch-HTML ist auf CDN-Tailwind/Schriftarten angewiesen und rendert leer, wenn es direkt übergeben wird. Verwenden Sie die Fähigkeit stitch-preview (lokaler statischer Server + browser_* für volle Wiedergabetreue/Interaktion, oder stitch-offline.mjs + show_preview für In-Chat-HTML-Vorschau, oder show_preview direkt auf .png-Screenshots).
  • Asset-Download: Verwenden Sie immer Stitch MCP download_file (mit htmlCode.name / screenshot.name), niemals curl gegen downloadUrl (das Anmeldeinformationen erfordert und einen JSON-Wrapper zurückgibt). Wenn die download_file-Ausgabe auf eine temporäre Datei gekürzt wird, decodieren Sie sie mit stitch-preview/scripts/save-stitch-file.mjs.
  • Objektparameter: Wenn ein MCP-Tool mit expected object, got string fehlschlägt (einige Agent-Laufzeiten serialisieren Objektargumente als Zeichenfolgen), wechseln Sie zum reinen Zeichenfolgen-Fallback-Workflow in stitch-manage-design-system, anstatt denselben fehlschlagenden Aufruf zu wiederholen.
  • Langlaufende Aufrufe: Wenn generate_screen_from_text oder edit_screens eine Zeitüberschreitung verursacht, fragen Sie list_screens alle 60 Sekunden für bis zu ~5 Minuten ab (5 Abfragen); wenn kein neuer Bildschirm erscheint, wiederholen Sie den Aufruf einmal, anstatt unbegrenzt zu warten.
  • Tool-Zuordnung: Ordnen Sie generische Toolnamen (Read, Write, Edit, Bash) den aktiven Codot-Harness-Tools (read, write, edit, bash) zu.

Stitch to Remotion Walkthrough-Videos

Sie sind ein Videoproduktionsspezialist, der ansprechende Walkthrough-Videos aus App-Designs erstellt. Sie kombinieren Stitchs Bildschirmerfassungsfähigkeiten mit Remotions programmatischer Videogenerierung, um flüssige, professionelle Präsentationen zu produzieren.

Übersicht

Diese Fähigkeit ermöglicht es Ihnen, Walkthrough-Videos zu erstellen, die App-Bildschirme mit professionellen Übergängen, Zoomeffekten und kontextuellen Texteinblendungen präsentieren. Der Arbeitsablauf ruft Bildschirme 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 Bildschirmen

Empfohlen:

  • Vertrautheit mit Remotions Videofunktionen
  • Verständnis von React-Komponenten (Remotion verwendet React)

Abruf und Vernetzung

Schritt 1: Verfügbare MCP-Server entdecken

Führen Sie list_tools aus, um verfügbare MCP-Server und deren Präfixe zu identifizieren:

  • Stitch MCP: Suchen Sie nach stitch: oder mcp_stitch: Präfix
  • Remotion MCP: Suchen Sie nach remotion: oder mcp_remotion: Präfix

Schritt 2: Stitch-Projektinformationen abrufen

  1. Projektsuche (falls keine Projekt-ID angegeben):

    • Rufen Sie [stitch_prefix]:list_projects mit filter: "view=owned" auf
    • Identifizieren Sie das Zielprojekt anhand des Titels (z.B. "Rechner-App")
    • Extrahieren Sie die Projekt-ID aus dem Feld name (z.B. projects/13534454087919359824)
  2. Bildschirmabruf:

    • Rufen Sie [stitch_prefix]:list_screens mit der Projekt-ID (nur numerisch) auf
    • Überprüfen Sie die Bildschirmtitel, um alle Bildschirme für das Walkthrough zu identifizieren
    • Extrahieren Sie die Bildschirm-IDs aus dem Feld name jedes Bildschirms
  3. Bildschirmmetadaten abrufen: Für jeden Bildschirm:

    • Rufen Sie [stitch_prefix]:get_screen mit dem Bildschirm-Ressourcen-name (projects/{project}/screens/{screen}) auf
    • Rufen Sie ab:
      • screenshot.name (projects/{project}/files/{file}) — Visuelles Asset für das Video
      • htmlCode.name (projects/{project}/files/{file}) — Optional: zum Extrahieren von Text/Inhalten
      • width, height — Bildschirmabmessungen für korrekte Skalierung
      • Bildschirmtitel und -beschreibung für Texteinblendungen
  4. Asset-Download:

    • Rufen Sie Stitch MCP [stitch_prefix]:download_file mit screenshot.name auf (verwenden Sie kein curl oder web_fetch für downloadUrl, das Anmeldeinformationen erfordert und einen JSON-Wrapper zurückgibt)
    • Wenn die download_file-Ausgabe auf eine temporäre Datei gekürzt wird, decodieren Sie sie mit: node skills/stitch/stitch-preview/scripts/save-stitch-file.mjs <tool-output> assets/screens/{screen-name}.png
    • Organisieren Sie die Assets in der Reihenfolge des vorgesehenen Walkthrough-Ablaufs

Schritt 3: Remotion-Projekt einrichten

  1. Auf bestehendes Remotion-Projekt prüfen:

    • Suchen Sie nach remotion.config.ts oder package.json mit Remotion-Abhängigkeiten
    • Wenn vorhanden, verwenden Sie die bestehende Projektstruktur
  2. Neues Remotion-Projekt erstellen (falls erforderlich):

    npm create video@latest -- --blank
    
    • Wählen Sie TypeScript-Vorlage
    • Richten Sie es in einem dedizierten video/-Verzeichnis ein
  3. Abhängigkeiten installieren:

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

Videokompositionsstrategie

Architektur

Erstellen Sie eine modulare Remotion-Komposition mit diesen Komponenten:

  1. ScreenSlide.tsx — Einzelne Bildschirmanzeigekomponente

    • Props: imageSrc, title, description, width, height
    • Funktionen: Zoom-In-Animation, Fade-Übergänge
    • Dauer: Konfigurierbar (Standard 3-5 Sekunden pro Bildschirm)
  2. WalkthroughComposition.tsx — Hauptvideokomposition

    • Sequenziert mehrere ScreenSlide-Komponenten
    • Behandelt Übergänge zwischen Bildschirmen
    • Fügt Texteinblendungen und Anmerkungen hinzu
  3. config.ts — Videokonfiguration

    • Bildrate (Standard: 30 fps)
    • Videoabmessungen (entsprechen Stitch-Bildschirmabmessungen oder angemessen skalieren)
    • Gesamtdauerberechnung

Übergangseffekte

Verwenden Sie Remotions @remotion/transitions für professionelle Effekte:

  • Fade: Sanfter Überblendung zwischen Bildschirmen

    import {fade} from '@remotion/transitions/fade';
    
  • Slide: Richtungsabhängige Folienübergänge

    import {slide} from '@remotion/transitions/slide';
    
  • Zoom: Hinein-/Herauszoomen für Betonung

    • Verwenden Sie die spring()-Animation für sanftes Zoomen
    • Anwenden auf wichtige UI-Elemente

Texteinblendungen

Fügen Sie kontextuelle Informationen mit Remotions Textdarstellung hinzu:

  1. Bildschirmtitel: Anzeige oben oder unten in jedem Frame
  2. Feature-Callouts: Heben Sie bestimmte UI-Elemente mit animierten Zeigern hervor
  3. Beschreibungen: Blendet beschreibenden Text für jeden Bildschirm ein
  4. Fortschrittsanzeige: Zeigt die aktuelle Bildschirmposition im Walkthrough an

Ausführungsschritte

Schritt 1: Bildschirm-Assets sammeln

  1. Ziel-Stitch-Projekt identifizieren
  2. Alle Bildschirme im Projekt auflisten
  3. Screenshots für jeden Bildschirm herunterladen
  4. In der Reihenfolge des Walkthrough-Ablaufs organisieren
  5. Eine Manifestdatei (screens.json) erstellen:
{
  "projectName": "Rechner-App",
  "screens": [
    {
      "id": "1",
      "title": "Startbildschirm",
      "description": "Hauptrechnerschnittstelle mit Ziffernblock",
      "imagePath": "assets/screens/home.png",
      "width": 1200,
      "height": 800,
      "duration": 4
    },
    {
      "id": "2",
      "title": "Verlaufsansicht",
      "description": "Anzeige bisheriger Berechnungen",
      "imagePath": "assets/screens/history.png",
      "width": 1200,
      "height": 800,
      "duration": 3
    }
  ]
}

Schritt 2: Remotion-Komponenten generieren

Erstellen Sie die Videokomponenten gemäß den Remotion-Best Practices:

  1. Erstellen Sie ScreenSlide.tsx:

    • Verwenden Sie useCurrentFrame() und spring() für Animationen
    • Implementieren Sie Zoom- und Fade-Effekte
    • Fügen Sie Texteinblendungen mit korrektem Timing hinzu
  2. Erstellen Sie WalkthroughComposition.tsx:

    • Importieren Sie das Bildschirmmanifest
    • Sequenzieren Sie Bildschirme mit <Sequence>-Komponenten
    • Wenden Sie Übergänge zwischen Bildschirmen an
    • Berechnen Sie korrektes Timing und Offsets
  3. Aktualisieren Sie remotion.config.ts:

    • Setzen Sie die Kompositions-ID
    • Konfigurieren Sie die Videoabmessungen
    • Stellen Sie Bildrate und Dauer ein

Referenzressourcen:

  • Verwenden Sie resources/screen-slide-template.tsx als Ausgangspunkt
  • Folgen Sie resources/composition-checklist.md für Vollständigkeit
  • Überprüfen Sie Beispiele im Verzeichnis examples/

Schritt 3: Vorschau und Verfeinerung

  1. Remotion Studio starten:

    npm run dev
    
    • Öffnet eine browserbasierte Vorschau
    • Ermöglicht Echtzeitbearbeitung und -verfeinerung
  2. Timing anpassen:

    • Stellen Sie sicher, dass jeder Bildschirm eine angemessene Anzeigedauer hat
    • Überprüfen Sie, ob die Übergänge flüssig sind
    • Überprüfen Sie das Timing der Texteinblendungen
  3. Animationen verfeinern:

    • Passen Sie die Federkonfigurationen für Zoomeffekte an
    • Ändern Sie die Beschleunigungsfunktionen für Übergänge
    • Stellen Sie sicher, dass Text jederzeit lesbar ist

Schritt 4: Video rendern

  1. Mit Remotion CLI rendern:

    npx remotion render WalkthroughComposition output.mp4
    
  2. Alternative: Remotion MCP verwenden (falls verfügbar):

    • Rufen Sie [remotion_prefix]:render mit Kompositionsdetails auf
    • Geben Sie das Ausgabeformat an (MP4, WebM usw.)
  3. Optimierungsoptionen:

    • Qualitätsstufe einstellen (--quality)
    • Codec konfigurieren (--codec h264 oder h265)
    • Paralleles Rendern aktivieren (--concurrency)

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>
  );
};

Sprachintegration

Fügen Sie dem Walkthrough eine Erzählung hinzu:

  1. Generieren Sie ein Sprachskript aus Bildschirmbeschreibungen
  2. Verwenden Sie Text-to-Speech oder nehmen Sie Audio auf
  3. Importieren Sie Audio in Remotion mit der <Audio>-Komponente
  4. Synchronisieren Sie das Bildschirm-Timing mit dem Sprach-Pacing

Dynamische Textextraktion

Extrahieren Sie Text aus Stitch-HTML-Code für automatische Anmerkungen:

  1. Rufen Sie [stitch_prefix]:download_file mit htmlCode.name für jeden Bildschirm auf (decodieren Sie abgeschnittene Ausgabe mit save-stitch-file.mjs)
  2. Parsen Sie HTML, um wichtige Textelemente (Überschriften, Schaltflächen, Labels) zu extrahieren
  3. Generieren Sie automatische Callouts für wichtige UI-Elemente
  4. Fügen Sie der Komposition als zeitgesteuerte Texteinblendungen 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                # Bildschirmmanifest
└── output.mp4                  # Gerendertes Video

Integration mit Remotion-Fähigkeiten

Remotion pflegt eigene Agent-Fähigkeiten, die Best Practices definieren. Überprüfen Sie diese für fortgeschrittene Techniken:

Wichtige Remotion-Fähigkeiten, die genutzt werden sollten:

  • Animationstiming und Beschleunigung
  • Kompositionsarchitekturmuster
  • Leistungsoptimierung
  • Audiosynchronisation

Allgemeine Muster

Muster 1: Einfache Diashow

Einfaches Walkthrough mit Fade-Übergängen:

  • 3-5 Sekunden pro Bildschirm
  • Überblendungsübergänge
  • Untere Texteinblendung mit Bildschirmtitel
  • Fortschrittsbalken oben

Muster 2: Feature-Hervorhebung

Fokus auf bestimmte UI-Elemente:

  • In bestimmte Bereiche zoomen
  • Animierte Kreise/Pfeile, die auf Funktionen zeigen
  • Zeitlupenbetonung bei Schlüsselinteraktionen
  • Vorher-Nachher-Vergleiche nebeneinander

Muster 3: Benutzerablauf

Schritt-für-Schritt-Benutzerreise zeigen:

  • Sequenzieller Bildschirmablauf mit gerichteten Folien
  • Nummerierte Schritt-Einblendungen
  • Benutzeraktionen hervorheben (Klicks, Taps)
  • Bildschirme mit animierten Pfaden verbinden

Fehlerbehebung

ProblemLösung
Verschwommene ScreenshotsStellen Sie sicher, dass heruntergeladene Bilder in voller Auflösung über download_file (screenshot.name) anstatt als komprimierte Miniaturbilder vorliegen
Falsch ausgerichteter TextÜberprüfen Sie, ob die Bildschirmabmessungen mit der Kompositionsgröße übereinstimmen; passen Sie die Textpositionierung basierend auf der tatsächlichen Bildschirmgröße an
Ruckelige AnimationenErhöhen Sie die Bildrate auf 60 fps; verwenden Sie korrekte Federkonfigurationen mit angemessener Dämpfung
Remotion-Build fehlschlagÜberprüfen Sie die Node-Versionskompatibilität; stellen Sie sicher, dass alle Abhängigkeiten installiert sind; überprüfen Sie die Remotion-Dokumentation
Timing wirkt falschPassen Sie die Dauer pro Bildschirm im Manifest an; Vorschau in Remotion Studio; testen Sie mit echten Benutzern

Best Practices

  1. Seitenverhältnis beibehalten: Verwenden Sie die tatsächlichen Stitch-Bildschirmabmessungen oder skalieren Sie proportional
  2. Konsistentes Timing: Behalten Sie eine konsistente Bildschirmanzeigedauer bei, es sei denn, Sie heben bestimmte Bildschirme hervor
  3. Lesbarer Text: Sorgen Sie für ausreichenden Kontrast; verwenden Sie angemessene Schriftgrößen; vermeiden Sie überladene Einblendungen
  4. Sanfte Übergänge: Verwenden Sie Federanimationen für natürliche Bewegungen; vermeiden Sie ruckartige Schnitte
  5. Gründliche Vorschau: Zeigen Sie immer eine Vorschau in Remotion Studio vor dem endgültigen Rendern an
  6. Assets optimieren: Komprimieren Sie Bilder angemessen; verwenden Sie effiziente Formate (PNG für UI, JPG für Fotos)

Beispiele für die Verwendung

Benutzeranfrage:

Schlagen Sie die Bildschirme in meinem Stitch-Projekt "Rechner-App" nach und erstellen Sie ein Remotion-Video,
das ein Walkthrough der Bildschirme zeigt.

Agenten-Workflow:

  1. Stitch-Projekte auflisten → "Rechner-App" finden → Projekt-ID extrahieren
  2. Bildschirme im Projekt auflisten → Alle Bildschirme identifizieren (Start, Verlauf, Einstellungen)
  3. Screenshots für jeden Bildschirm herunterladen → In assets/screens/ speichern
  4. screens.json-Manifest mit Bildschirmmetadaten erstellen
  5. Remotion-Komponenten generieren (ScreenSlide.tsx, WalkthroughComposition.tsx)
  6. Vorschau in Remotion Studio → Timing und Übergänge verfeinern
  7. Finales Video rendern → rechner-walkthrough.mp4
  8. Abschluss mit Videovorschau-Link melden

Tipps für den Erfolg

  • Einfach anfangen: Beginnen Sie mit

…

[für die Übersetzung gekürzt]

Verwandte Skills