Communitygithub.com

TheMystic07/OpenWalc

Erstelle Walkthrough-Videos aus Stitch-Projekten mit Remotion, inklusive fließender Übergänge, Zoomeffekten und Texteinblendungen.

Was ist OpenWalc?

Dieses Skill ermöglicht es dir, professionelle Walkthrough-Videos zu erstellen, die App-Bildschirme aus Stitch-Projekten mit fließenden Übergängen, Zoomeffekten und kontextbezogenen Texteinblendungen präsentieren. Der Workflow ruft Screens aus Stitch ab und orchestriert sie in einer Remotion-Videokomposition. Es werden die MCP-Server von Stitch und Remotion sowie grundlegende Kenntnisse in React (Remotion nutzt React) vorausgesetzt. Der Skill führt Schritt für Schritt durch die Projekterkennung, den Download der Bildschirmaufnahmen, das Erstellen der Remotion-Komponenten wie ScreenSlide und WalkthroughComposition, die Vorschau im Remotion Studio und letztlich den Video-Render. Fortgeschrittene Funktionen umfassen interaktive Hotspots, Sprachausgabe-Integration und dynamische Textextraktion aus Stitch-HTML-Code. Die Ausgabe ist ein fertiges MP4-Video mit anpassbaren Effekten und Timing.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/TheMystic07/OpenWalc/tree/HEAD/.agent/skills/remotion

In Ihrer bevorzugten KI fragen

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

Dokumentation

Walkthrough-Videos von Stitch zu Remotion

Du bist ein Videoproduktionsspezialist, der sich auf die Erstellung von ansprechenden Walkthrough-Videos aus App-Designs konzentriert. Du kombinierst die Bildschirm-Abrufmöglichkeiten von Stitch mit der programmatischen Videogenerierung von Remotion, um flüssige, professionelle Präsentationen zu erstellen.

Überblick

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 in 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 erstellten Screens

Empfohlen:

  • Vertrautheit mit den Videofähigkeiten 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:- oder mcp_stitch:-Präfix
  • Remotion MCP: Suche nach remotion:- oder mcp_remotion:-Präfix

Schritt 2: Stitch-Projektinformationen abrufen

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

    • Rufe [stitch_prefix]:list_projects mit filter: "view=owned" auf
    • Identifiziere das Zielprojekt anhand des Titels (z. B. "Rechner-App")
    • Extrahiere die Projekt-ID aus dem name-Feld (z. B. projects/13534454087919359824)
  2. Screen-Abruf:

    • Rufe [stitch_prefix]:list_screens mit der Projekt-ID (nur numerisch) auf
    • Überprüfe die Screen-Titel, um alle Screens für das Walkthrough zu identifizieren
    • Extrahiere die Screen-IDs aus dem name-Feld jedes Screens
  3. Screen-Metadaten abrufen: Für jeden Screen:

    • Rufe [stitch_prefix]:get_screen mit projectId und screenId auf
    • Rufe ab:
      • screenshot.downloadUrl — Visuelles Asset für das Video
      • htmlCode.downloadUrl — Optional: zum Extrahieren von Text/Inhalt
      • width, height — Bildschirmabmessungen für korrekte Skalierung
      • Screen-Titel und -Beschreibung für Texteinblendungen
  4. Asset-Download:

    • Verwende web_fetch oder Bash mit curl, um Screenshots herunterzuladen
    • Speichere in einem Staging-Verzeichnis: assets/screens/{screen-name}.png
    • Ordne Assets in der Reihenfolge des beabsichtigten Walkthrough-Ablaufs

Schritt 3: Remotion-Projekt einrichten

  1. Vorhandenes Remotion-Projekt prüfen:

    • Suche nach remotion.config.ts oder package.json mit Remotion-Abhängigkeiten
    • Falls vorhanden, verwende die bestehende Projektstruktur
  2. Neues Remotion-Projekt erstellen (falls nötig):

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

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

Videokompositionsstrategie

Architektur

Erstelle eine modulare Remotion-Komposition mit diesen Komponenten:

  1. ScreenSlide.tsx — Einzel-Screen-Anzeigekomponente

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

    • Reiht mehrere ScreenSlide-Komponenten aneinander
    • Handhabt Übergänge zwischen Screens
    • Fügt Texteinblendungen und Anmerkungen hinzu
  3. config.ts — Videokonfiguration

    • Bildrate (Standard: 30 fps)
    • Videoabmessungen (entspreche Stitch-Screen-Abmessungen oder skaliere angemessen)
    • Berechnung der Gesamtdauer

Übergangseffekte

Verwende @remotion/transitions von Remotion für professionelle Effekte:

  • Überblendung: Sanfter Crossfade zwischen Screens

    import {fade} from '@remotion/transitions/fade';
    
  • Schieben: Gerichtete Slide-Übergänge

    import {slide} from '@remotion/transitions/slide';
    
  • Zoom: Zoom-In/Out-Effekte zur Betonung

    • Verwende spring()-Animation für sanften Zoom
    • Wende auf wichtige UI-Elemente an

Texteinblendungen

Füge kontextbezogene Informationen mit der Remotion-Textwiedergabe hinzu:

  1. Screen-Titel: Werden oben oder unten im jeweiligen Frame angezeigt
  2. Feature-Hervorhebungen: Hebe bestimmte UI-Elemente mit animierten Zeigern hervor
  3. Beschreibungen: Blende beschreibenden Text für jeden Screen ein
  4. Fortschrittsanzeige: Zeige aktuelle Screen-Position im Walkthrough an

Ausführungsschritte

Schritt 1: Screen-Assets sammeln

  1. Identifiziere das Ziel-Stitch-Projekt
  2. Liste alle Screens im Projekt auf
  3. Lade Screenshots für jeden Screen herunter
  4. Ordne in der Reihenfolge des Walkthrough-Ablaufs an
  5. Erstelle eine Manifestdatei (screens.json):
{
  "projectName": "Rechner-App",
  "screens": [
    {
      "id": "1",
      "title": "Startbildschirm",
      "description": "Hauptrechnerschnittstelle mit Nummernfeld",
      "imagePath": "assets/screens/home.png",
      "width": 1200,
      "height": 800,
      "duration": 4
    },
    {
      "id": "2",
      "title": "Verlaufsansicht",
      "description": "Ansicht vorheriger 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:

  1. Erstelle ScreenSlide.tsx:

    • Verwende useCurrentFrame() und spring() für Animationen
    • Implementiere Zoom- und Überblendungseffekte
    • Füge Texteinblendungen mit korrektem Timing hinzu
  2. Erstelle WalkthroughComposition.tsx:

    • Importiere das Screen-Manifest
    • Ordne Screens mit <Sequence>-Komponenten an
    • Wende Übergänge zwischen Screens an
    • Berechne korrektes Timing und Offsets
  3. Aktualisiere remotion.config.ts:

    • Setze die Kompositions-ID
    • Konfiguriere Videoabmessungen
    • Lege Bildrate und Dauer fest

Referenzressourcen:

  • Verwende resources/screen-slide-template.tsx als Ausgangspunkt
  • Befolge resources/composition-checklist.md für Vollständigkeit
  • Überprüfe Beispiele im examples/walkthrough/-Verzeichnis

Schritt 3: Vorschau und Verfeinerung

  1. Remotion Studio starten:

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

    • Stelle sicher, dass jeder Screen eine angemessene Anzeigedauer hat
    • Überprüfe, ob Übergänge flüssig sind
    • Kontrolliere das Timing von Texteinblendungen
  3. Animationen verfeinern:

    • Passe Spring-Konfigurationen für Zoomeffekte an
    • Modifiziere Easing-Funktionen für Übergänge
    • Stelle 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):

    • Rufe [remotion_prefix]:render mit Kompositionsdetails auf
    • Gib das Ausgabeformat an (MP4, WebM, etc.)
  3. Optimierungsoptionen:

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

Erweiterte Funktionen

Interaktive Hotspots

Hebe 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üge dem Walkthrough eine Erzählung hinzu:

  1. Generiere ein Sprachausgabe-Skript aus den Screen-Beschreibungen
  2. Verwende Text-to-Speech oder nimm Audio auf
  3. Importiere Audio mit der <Audio>-Komponente in Remotion
  4. Synchronisiere das Timing der Screens mit dem Sprechtempo

Dynamische Textextraktion

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

  1. Lade htmlCode.downloadUrl für jeden Screen herunter
  2. Parst HTML, um wichtige Textelemente (Überschriften, Schaltflächen, Labels) zu extrahieren
  3. Generiere automatische Hervorhebungen für wichtige UI-Elemente
  4. Füge 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:

Wichtige Remotion-Skills, die genutzt werden können:

  • Animationstiming und Easing
  • Architekturmuster für Kompositionen
  • Leistungsoptimierung
  • Audiosynchronisation

Häufige Muster

Muster 1: Einfache Diashow

Basis-Walkthrough mit Überblendungsübergängen:

  • 3-5 Sekunden pro Screen
  • Crossfade-Übergänge
  • Texteinblendung unten mit Screen-Titel
  • Fortschrittsbalken oben

Muster 2: Feature-Hervorhebung

Konzentration auf bestimmte UI-Elemente:

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

Muster 3: Benutzerablauf

Zeige den schrittweisen Benutzerpfad:

  • Sequentieller Screen-Ablauf mit gerichteten Slides
  • Nummerierte Schritt-Einblendungen
  • Hebe Benutzeraktionen hervor (Klicks, Taps)
  • Verbinde Screens mit animierten Pfaden

Fehlerbehebung

ProblemLösung
Unscharfe ScreenshotsStelle sicher, dass Bilder in voller Auflösung heruntergeladen werden; überprüfe die Qualitätseinstellungen von screenshot.downloadUrl
Verschobener TextÜberprüfe, ob die Screen-Abmessungen mit der Kompositionsgröße übereinstimmen; passe die Textposition basierend auf der tatsächlichen Screen-Größe an
Ruckelige AnimationenErhöhe die Bildrate auf 60fps; verwende geeignete Spring-Konfigurationen mit angemessenem Dämpfungsfaktor
Remotion-Build schlägt fehlÜberprüfe die Node-Version-Kompatibilität; stelle sicher, dass alle Abhängigkeiten installiert sind; konsultiere die Remotion-Dokumentation
Timing wirkt falschPasse die Dauer pro Screen im Manifest an; Vorschau im Remotion Studio; teste mit echten Benutzern

Best Practices

  1. Seitenverhältnis beibehalten: Verwende die tatsächlichen Stitch-Screen-Abmessungen oder skaliere proportional
  2. Konsistentes Timing: Halte die Anzeigedauer der Screens konsistent, es sei denn, bestimmte Screens sollen betont werden
  3. Lesbarer Text: Stelle ausreichenden Kontrast sicher; verwende angemessene Schriftgrößen; vermeide überladene Einblendungen
  4. Flüssige Übergänge: Verwende Spring-Animationen für natürliche Bewegungen; vermeide ruckartige Schnitte
  5. Gründlich Vorschau: Vorschau immer im Remotion Studio vor dem endgültigen Render
  6. Assets optimieren: Komprimiere Bilder angemessen; verwende effiziente Formate (PNG für UI, JPG für Fotos)

Beispielnutzung

Benutzer-Prompt:

Suche die Screens in meinem Stitch-Projekt "Rechner-App" und erstelle ein Remotion-Video,
das einen Walkthrough der Screens zeigt.

Agent-Workflow:

  1. Liste Stitch-Projekte auf → Finde "Rechner-App" → Extrahiere Projekt-ID
  2. Liste Screens im Projekt → Identifiziere alle Screens (Start, Verlauf, Einstellungen)
  3. Lade Screenshots für jeden Screen herunter → Speichere in assets/screens/
  4. Erstelle screens.json-Manifest mit Screen-Metadaten
  5. Generiere Remotion-Komponenten (ScreenSlide.tsx, WalkthroughComposition.tsx)
  6. Vorschau im Remotion Studio → Verfeinere Timing und Übergänge
  7. Rendre das finale Video → rechner-walkthrough.mp4
  8. Melde Fertigstellung mit Vorschau-Link zum Video

Tipps für den Erfolg

  • Fang einfach an: Beginne mit einfachen Überblendungsübergängen, bevor du komplexe Animationen hinzufügst
  • Folge Remotion-Mustern: Nutze die offiziellen Skills und die Dokumentation von Remotion
  • Verwende Manifestdateien: Halte Screen-Daten in JSON organisiert für einfache Aktualisierungen
  • Vorschau häufig: Verwende Remotion Studio, um Probleme frühzeitig zu erkennen
  • Denke an Barrierefreiheit: Füge Untertitel hinzu; stelle sicher, dass Text lesbar ist; verwende klare visuelle Darstellungen
  • Optimiere für die Plattform: Passe Videoabmessungen an die Zielplattform an (YouTube, soziale Medien, etc.)

Referenzen

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Verwandte Skills