Communitygithub.com

plastikaweb/plastikspace

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

Was ist plastikspace?

Mit diesem Skill kannst du aus App-Designs eines Stitch-Projekts professionelle Walkthrough-Videos erstellen. Er kombiniert Stitchs Fähigkeit, Screens abzurufen, mit Remotions programmatischer Videogenerierung. Der Workflow lädt Screenshots aus Stitch herunter, organisiert sie als JSON-Manifest und komponiert sie in einer modular aufgebauten Remotion-Instanz: Jeder Screen wird als `ScreenSlide`-Komponente mit Zoom-Animation und Überblendung dargestellt, während `WalkthroughComposition` für die Hauptsequenzierung und Übergänge sorgt. Der Skill unterstützt mehrere MCP-Server (Stitch, Remotion) und erzeugt sowohl einfache Diashows als auch komplexe Benutzerfluss-Videos mit Hotspots und Sprachaufnahmen. Die Ausgabe kann über die Remotion-CLI oder den Remotion-MCP-Server gerendert werden. Voraussetzungen sind Node.js, Zugriff auf Stitch und Remotion sowie ein Stitch-Projekt mit fertigen Screens.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Stitch-zu-Remotion-Walkthrough-Videos

Du bist ein Videoproduktions-Spezialist, der sich darauf konzentriert, ansprechende Walkthrough-Videos aus App-Designs zu erstellen. Du kombinierst Stitchs Bildschirmabruffunktionen mit Remotions programmatischer Videogenerierung, um flüssige, professionelle Präsentationen zu erzeugen.

Überblick

Dieser Skill befähigt dich, Walkthrough-Videos zu erstellen, die App-Screens 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 designten Screens

Empfohlen:

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

Abruf und Vernetzung

Schritt 1: Verfügbare MCP-Server ermitteln

Führe list_tools aus, um verfügbare MCP-Server und deren 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 Projekt-ID nicht bekannt):

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

    • Rufe [stitch_prefix]:list_screens auf mit der Projekt-ID (nur numerisch)
    • Überprüfe die Screen-Titel, um alle Screens für den 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 auf mit projectId und screenId
    • Rufe ab:
      • screenshot.downloadUrl – Visuelles Asset für das Video
      • htmlCode.downloadUrl – Optional: zum Extrahieren von Text/Inhalt
      • width, height – Screen-Dimensionen 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
    • Organisiere Assets in der Reihenfolge des beabsichtigten Walkthrough-Ablaufs

Schritt 3: Remotion-Projekt einrichten

  1. Prüfen auf bestehendes Remotion-Projekt:

    • 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 eigenen 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 – Individuelle Screen-Anzeigekomponente

    • Props: imageSrc, title, description, width, height
    • Funktionen: Zoom-In-Animation, Einblendübergänge
    • Dauer: Konfigurierbar (Standard 3-5 Sekunden pro Screen)
  2. WalkthroughComposition.tsx – Hauptvideokomposition

    • Sequenziert mehrere ScreenSlide-Komponenten
    • Handhabt Übergänge zwischen Screens
    • Fügt Texteinblendungen und Annotationen hinzu
  3. config.ts – Videokonfiguration

    • Bildrate (Standard: 30 fps)
    • Videodimensionen (entsprechend Stitch-Screen-Dimensionen oder proportional skaliert)
    • Berechnung der Gesamtdauer

Übergangseffekte

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

  • Einblendung: Sanfte Kreuzblende zwischen Screens

    import { fade } from '@remotion/transitions/fade';
    
  • Schieben: Gerichtete Schiebeübergänge

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

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

Texteinblendungen

Füge kontextbezogene Informationen mit Remotions Textdarstellung hinzu:

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

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
  5. Erstelle eine Manifestdatei (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": "Verlauf anzeigen",
      "description": "Ansicht früherer 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 Einblendeffekte
    • Füge Texteinblendungen mit richtiger Zeitsteuerung hinzu
  2. Erstelle WalkthroughComposition.tsx:

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

    • Setze die Kompositions-ID
    • Konfiguriere die Videodimensionen
    • Stelle Bildrate und Dauer ein

Referenzressourcen:

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

Schritt 3: Vorschau und Verfeinerung

  1. Starte Remotion Studio:

    npm run dev
    
    • Öffnet browserbasierte Vorschau
    • Ermöglicht Echtzeitbearbeitung und -verfeinerung
  2. Passe die Zeitsteuerung an:

    • Stelle sicher, dass jeder Screen eine angemessene Anzeigedauer hat
    • Überprüfe, ob die Übergänge flüssig sind
    • Kontrolliere die Zeitsteuerung der Texteinblendungen
  3. Feinjustiere Animationen:

    • Passe die Spring-Konfigurationen für Zoomeffekte an
    • Modifiziere die Übergangsfunktionen für sanfte Bewegungen
    • Stelle sicher, dass Text jederzeit lesbar ist

Schritt 4: Video rendern

  1. Rendern mit Remotion CLI:

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

    • Rufe [remotion_prefix]:render mit den Kompositionsdetails auf
    • Gib 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

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

Sprach-Integration

Füge dem Walkthrough eine Sprachausgabe hinzu:

  1. Erstelle ein Sprachskript aus den Screen-Beschreibungen
  2. Verwende Text-to-Speech oder nimm Audio auf
  3. Importiere Audio mit der <Audio>-Komponente in Remotion
  4. Synchronisiere die Screen-Timing mit der Sprachgeschwindigkeit

Dynamische Textextraktion

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

  1. Lade htmlCode.downloadUrl für jeden Screen herunter
  2. Analysiere HTML, um wichtige Textelemente zu extrahieren (Überschriften, Schaltflächen, Beschriftungen)
  3. Generiere automatische Hervorhebungen für wichtige UI-Elemente
  4. Füge sie als zeitgesteuerte Texteinblendungen zur Komposition hinzu

Dateistruktur

projekt/
├── 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:

  • Animations-Timing und Easing
  • Kompositionsarchitektur-Muster
  • Leistungsoptimierung
  • Audiosynchronisation

Häufige Muster

Muster 1: Einfache Diashow

Einfacher Walkthrough mit Einblendübergängen:

  • 3-5 Sekunden pro Screen
  • Kreuzblend-Übergänge
  • Textüberlagerung unten mit Screen-Titel
  • Fortschrittsbalken oben

Muster 2: Funktionshervorhebung

Fokus auf bestimmte UI-Elemente:

  • Zoome in bestimmte Bereiche
  • Animierte Kreise/Pfeile, die auf Funktionen zeigen
  • Zeitlupe zur Betonung wichtiger Interaktionen
  • Vorher-/Nachher-Vergleiche nebeneinander

Muster 3: Benutzerfluss

Zeige den schrittweisen Benutzerweg:

  • Sequentielle Screen-Abfolge mit Richtungsschieben
  • Nummerierte Schrittüberlagerungen
  • Hervorhebung von Benutzeraktionen (Klicks, Tippen)
  • Verbinde Screens mit animierten Pfaden

Fehlerbehebung

ProblemLösung
Unscharfe ScreenshotsStelle sicher, dass heruntergeladene Bilder in voller Auflösung vorliegen; überprüfe screenshot.downloadUrl-Qualitätseinstellungen
Verschobener TextÜberprüfe, ob die Screen-Dimensionen mit der Kompositionsgröße übereinstimmen; passe die Textposition basierend auf der tatsächlichen Bildschirmgröße an
Ruckelige AnimationenErhöhe die Bildrate auf 60 fps; verwende korrekte Spring-Konfigurationen mit angemessener Dämpfung
Remotion-Build schlägt fehlÜberprüfe die Node-Version-Kompatibilität; stelle sicher, dass alle Abhängigkeiten installiert sind; überprüfe 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-Dimensionen oder skaliere proportional
  2. Einheitliches Timing: Halte die Anzeigedauer der Screens konsistent, es sei denn, bestimmte Screens werden hervorgehoben
  3. Lesbarer Text: Stelle ausreichenden Kontrast sicher; verwende angemessene Schriftgrößen; vermeide überladene Überlagerungen
  4. Sanfte Übergänge: Verwende Spring-Animationen für natürliche Bewegungen; vermeide ruckartige Schnitte
  5. Gründlich vorschauen: Vorschau immer im Remotion Studio vor dem endgültigen Rendern
  6. Assets optimieren: Komprimiere Bilder angemessen; verwende effiziente Formate (PNG für UI, JPG für Fotos)

Beispielnutzung

Benutzeraufforderung:

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

Agent-Workflow:

  1. Liste Stitch-Projekte auf → Finde „Taschenrechner App“ → Extrahiere Projekt-ID
  2. Liste Screens im Projekt auf → 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. Rendere finales Video → taschenrechner-walkthrough.mp4
  8. Melde Fertigstellung mit Link zur Vorschau

Tipps für den Erfolg

  • Fang einfach an: Beginne mit grundlegenden Einblendübergängen, bevor du komplexe Animationen hinzufügst
  • Folge Remotion-Mustern: Nutze die offiziellen Remotion-Skills und die Dokumentation
  • 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 Grafiken
  • Optimiere für die Plattform: Passe die Videodimensionen der Zielplattform an (YouTube, soziale Medien usw.)

Referenzen

Verwandte Skills