Communitygithub.com

phoroth/AGENTIC

Erstelle Walkthrough-Videos aus Stitch-Projekten mit Remotion – mit sanften Übergängen, Zoomeffekten und Texteinblendungen

Was ist AGENTIC?

Diese Fähigkeit (Skill) ermöglicht es dir, professionelle Walkthrough-Videos aus App-Designs zu erstellen, indem du die Bildschirmabrufe von Stitch mit der programmatischen Videogenerierung von Remotion kombinierst. Du durchläufst einen Workflow, der zuerst Bildschirme aus einem Stitch-Projekt identifiziert und herunterlädt, sie in einer JSON-Manifestdatei organisiert und dann mit Remotion-Komponenten wie `ScreenSlide.tsx` und `WalkthroughComposition.tsx` zu einer flüssigen Videokomposition zusammenfügt. Der Skill unterstützt verschiedene Übergangseffekte (Fade, Slide, Zoom), Texteinblendungen und fortgeschrittene Features wie interaktive Hotspots, Voiceover-Integration und dynamische Textextraktion aus Stitch-HTML. Er ist besonders nützlich für Entwickler und Designer, die schnell hochwertige Produktvorführungen erstellen möchten, und funktioniert mit jedem Remotion-Setup (CLI, MCP-Server oder Studio).

Funktioniert mit~Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/phoroth/AGENTIC/tree/HEAD/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 Videoproduktionsspezialist, der sich darauf konzentriert, ansprechende Walkthrough-Videos aus App-Designs zu erstellen. Du kombinierst die Bildschirmabruffähigkeiten von Stitch mit der programmatischen Videogenerierung von Remotion, um flüssige, professionelle Präsentationen zu erstellen.

Überblick

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

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 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 angegeben):

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

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

    • 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/Inhalten
      • width, height – Bildschirmabmessungen für korrekte Skalierung
      • Bildschirmtitel 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. Auf 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
    

Videokompositions-Strategie

Architektur

Erstelle eine modulare Remotion-Komposition mit diesen Komponenten:

  1. ScreenSlide.tsx – Komponente zur Anzeige einzelner Bildschirme

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

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

    • Bildrate (Standard: 30 fps)
    • Videoabmessungen (an Stitch-Bildschirmabmessungen anpassen oder entsprechend skalieren)
    • Berechnung der Gesamtdauer

Übergangseffekte

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

  • Fade: Sanfter Crossfade zwischen Bildschirmen

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

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

    • Verwende spring()-Animation für sanften Zoom
    • Auf wichtige UI-Elemente anwenden

Texteinblendungen

Füge kontextbezogene Informationen mit der Textdarstellung von Remotion hinzu:

  1. Bildschirmtitel: Oben oder unten auf jedem Frame anzeigen
  2. Feature-Hervorhebungen: Bestimmte UI-Elemente mit animierten Zeigern hervorheben
  3. Beschreibungen: Beschreibenden Text für jeden Bildschirm einblenden
  4. Fortschrittsanzeige: Aktuelle Bildschirmposition im Walkthrough anzeigen

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": "Rechen-App",
  "screens": [
    {
      "id": "1",
      "title": "Startbildschirm",
      "description": "Hauptrechneroberfläche mit Ziffernblock",
      "imagePath": "assets/screens/home.png",
      "width": 1200,
      "height": 800,
      "duration": 4
    },
    {
      "id": "2",
      "title": "Verlaufsansicht",
      "description": "Anzeige vorheriger Berechnungen",
      "imagePath": "assets/screens/history.png",
      "width": 1200,
      "height": 800,
      "duration": 3
    }
  ]
}

Schritt 2: Remotion-Komponenten generieren

Erstelle die Videokomponenten nach den Best Practices von Remotion:

  1. ScreenSlide.tsx erstellen:

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

    • Importiere das Bildschirm-Manifest
    • Sequenziere Bildschirme mit <Sequence>-Komponenten
    • Wende Übergänge zwischen Bildschirmen an
    • Berechne korrektes Timing und Offsets
  3. remotion.config.ts aktualisieren:

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

Referenzressourcen:

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

Schritt 3: Vorschau und Verfeinerung

  1. Remotion Studio starten:

    npm run dev
    
    • Öffnet eine browserbasierte Vorschau
    • Ermöglicht Echtzeit-Bearbeitung und Verfeinerung
  2. Timing anpassen:

    • Stelle sicher, dass jeder Bildschirm eine angemessene Anzeigedauer hat
    • Überprüfe, ob Übergänge sanft sind
    • Prüfe das Timing der Texteinblendungen
  3. Animationen verfeinern:

    • Passe Spring-Konfigurationen für Zoomeffekte an
    • Ändere 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 usw.)
  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>
  );
};

Voiceover-Integration

Füge dem Walkthrough eine Erzählung hinzu:

  1. Erstelle ein Voiceover-Skript aus den Bildschirmbeschreibungen
  2. Verwende Text-to-Speech oder nimm Audio auf
  3. Importiere Audio in Remotion mit der <Audio>-Komponente
  4. Synchronisiere das Bildschirm-Timing mit dem Voiceover-Tempo

Dynamische Textextraktion

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

  1. Lade htmlCode.downloadUrl für jeden Bildschirm herunter
  2. Parse HTML, um wichtige Textelemente zu extrahieren (Überschriften, Schaltflächen, Beschriftungen)
  3. Generiere automatische Callouts für wichtige UI-Elemente
  4. 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                # Bildschirm-Manifest
└── output.mp4                  # Gerendertes Video

Integration mit Remotion-Fähigkeiten

Remotion pflegt eigene Agent Skills, die Best Practices definieren. Überprüfe diese für fortgeschrittene Techniken:

Wichtige Remotion-Fähigkeiten, die genutzt werden können:

  • Animations-Timing und Easing
  • Kompositions-Architekturmuster
  • Leistungsoptimierung
  • Audiosynchronisation

Häufige Muster

Muster 1: Einfache Diashow

Einfacher Walkthrough mit Fade-Übergängen:

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

Muster 2: Funktion hervorheben

Fokus auf bestimmte UI-Elemente:

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

Muster 3: Benutzerablauf

Zeige den schrittweisen Benutzerpfad:

  • Sequenzieller Bildschirmablauf mit richtungsbasierten Folien
  • Nummerierte Schritteinblendungen
  • Hervorhebung von Benutzeraktionen (Klicks, Tippen)
  • Verbinde Bildschirme mit animierten Pfaden

Fehlerbehebung

ProblemLösung
Unscharfe ScreenshotsStelle sicher, dass heruntergeladene Bilder in voller Auflösung sind; ü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
Ruckelige AnimationenErhöhe die Bildrate auf 60 fps; verwende korrekte Spring-Konfigurationen mit angemessener Dämpfung
Remotion-Build fehlgeschlagenÜberprüfe die Node-Version-Kompatibilität; stelle sicher, dass alle Abhängigkeiten installiert sind; lese die Remotion-Dokumentation
Timing fühlt sich falsch anPasse die Dauer pro Bildschirm im Manifest an; Vorschau im Remotion Studio; teste mit tatsächlichen Nutzern

Best Practices

  1. Seitenverhältnis beibehalten: Verwende die tatsächlichen Stitch-Bildschirmabmessungen oder skaliere proportional
  2. Konsistentes Timing: Halte die Anzeigedauer der Bildschirme konsistent, es sei denn, bestimmte Bildschirme sollen hervorgehoben werden
  3. Lesbarer Text: Stelle ausreichenden Kontrast sicher; verwende angemessene Schriftgrößen; vermeide überladene Einblendungen
  4. Sanfte Übergänge: Verwende Spring-Animationen für natürliche Bewegungen; vermeide abrupte Schnitte
  5. Gründliche Vorschau: Mache immer eine Vorschau 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)

Beispielverwendung

Benutzeraufforderung:

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

Agent-Workflow:

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

Tipps für den Erfolg

  • Fange einfach an: Beginne mit grundlegenden Fade-Übergängen, bevor du komplexe Animationen hinzufügst
  • Befolge Remotion-Muster: Nutze die offiziellen Fähigkeiten und die Dokumentation von Remotion
  • Verwende Manifestdateien: Halte Bildschirmdaten in JSON organisiert für einfache Aktualisierungen
  • Mache häufig Vorschau: Verwende Remotion Studio, um Probleme frühzeitig zu erkennen
  • Denke an Barrierefreiheit: Füge Untertitel hinzu; stelle sicher, dass Text lesbar ist; verwende klare Visualisierungen
  • Optimiere für die Plattform: Passe die Videoabmessungen an die Zielplattform an (YouTube, soziale Medien usw.)

Referenzen

Wann verwenden

Verwende diese Fähigkeit bei Aufgaben, die mit ihrem primären Bereich oder ihrer Funktionalität wie oben beschrieben zusammenhängen.

Einschränkungen

  • Verwende diese Fähigkeit nur, wenn die Aufgabe eindeutig zum oben beschriebenen Umfang passt.
  • Behandle 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.

Verwandte Skills