Communitygithub.com

aliabbaschadhar/copilot-superpowers

Erstelle Walkthrough-Videos aus Stitch-Projekten mit Remotion – mit fließenden Übergängen, Zoom-Effekten und Textüberlagerungen.

Was ist copilot-superpowers?

Diese Skill befähigt KI-Agenten, professionelle Walkthrough-Videos aus App-Designs zu generieren, indem sie die Bildschirmabruf-Funktionen von Stitch mit der programmatischen Videogenerierung von Remotion kombinieren. Der Workflow durchläuft mehrere Schritte: Zuerst wird ein Stitch-Projekt identifiziert und dessen Screens gelistet. Dann werden Screenshots und Metadaten wie Titel, Beschreibung und Abmessungen heruntergeladen und in einem lokalen Asset-Ordner organisiert. Anschließend wird ein Remotion-Videoprojekt aufgesetzt – entweder neu oder ein bestehendes – und die Komponenten `ScreenSlide`, `WalkthroughComposition` und eine Konfigurationsdatei werden generiert. Der Agent kann Übergänge wie Fade, Slide und Zoom hinzufügen sowie Textüberlagerungen und Hotspots für interaktive Elemente einblenden. Die Skill unterstützt die Plattformen Stitch (via MCP) und Remotion (via MCP oder CLI) und arbeitet auf Basis von Node.js/npm. Besonders nützlich ist die flexible Handhabung von Übergängen und Animationen über Remotions `spring()`- und `interpolate`-Funktionen, die natürliche Bewegungen ermöglichen. Die finale Ausgabe ist eine MP4-Datei, die über die Remotion CLI oder den Remotion MCP gerendert wird. Die Skill eignet sich hervorragend für Produktdemos, Feature-Highlights und User-Flow-Präsentationen, die innerhalb von Minuten automatisiert erstellt werden können.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aliabbaschadhar/copilot-superpowers/tree/HEAD/assets/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 generieren

Du bist ein auf die Erstellung ansprechender Walkthrough-Videos aus App-Designs spezialisierter Videoproduktionsexperte. Du kombinierst die Bildschirmabruf-Fähigkeiten von Stitch mit der programmatischen Videogenerierung von Remotion, um flüssige, professionelle Präsentationen zu produzieren.

Übersicht

Mit dieser Skill kannst du Walkthrough-Videos erstellen, die App-Bildschirme mit professionellen Übergängen, Zoomeffekten und kontextbezogenen Textüberlagerungen 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 die Remotion CLI)
  • Node.js und npm installiert
  • Ein Stitch-Projekt mit entworfenen Bildschirmen

Empfohlen:

  • Vertrautheit mit den Videofunktionen von Remotion
  • Grundverständnis von React-Komponenten (Remotion verwendet React)

Abruf und Vernetzung

Schritt 1: Verfügbare MCP Server entdecken

Führe list_tools aus, um verfügbare MCP Server und ihre Präfixe zu identifizieren:

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

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. "Taschenrechner 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
    • Prüfe die Bildschirmtitel, um alle Bildschirme für das 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 Textüberlagerungen
  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. Prüfe 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 ein dediziertes video/-Verzeichnis ein
  3. Abhängigkeiten installieren:

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

Strategie für die Videokomposition

Architektur

Erstelle eine modulare Remotion-Komposition mit diesen Komponenten:

  1. ScreenSlide.tsx — Komponente zur Anzeige einzelner Bildschirme

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

    • Reiht mehrere ScreenSlide-Komponenten aneinander
    • Kümmert sich um Übergänge zwischen Bildschirmen
    • Fügt Textüberlagerungen und Annotationen hinzu
  3. config.ts — Videokonfiguration

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

Übergangseffekte

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

  • Fade: Sanftes Überblenden zwischen Bildschirmen

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

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

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

Textüberlagerungen

Füge Kontextinformationen mit der Textdarstellung von Remotion hinzu:

  1. Bildschirmtitel: Oben oder unten an jedem Frame anzeigen
  2. Feature-Hervorhebungen: Hebe bestimmte UI-Elemente mit animierten Zeigern hervor
  3. Beschreibungen: Blende beschreibenden Text für jeden Bildschirm ein
  4. Fortschrittsanzeige: Zeige aktuelle Bildschirmposition im Walkthrough

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. Manifest-Datei (screens.json) erstellen:
{
  "projectName": "Taschenrechner App",
  "screens": [
    {
      "id": "1",
      "title": "Startbildschirm",
      "description": "Hauptrechner-Oberfläche mit Nummerntastatur",
      "imagePath": "assets/screens/home.png",
      "width": 1200,
      "height": 800,
      "duration": 4
    },
    {
      "id": "2",
      "title": "Verlauf anzeigen",
      "description": "Anzeige 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. ScreenSlide.tsx erstellen:

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

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

    • Setze 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 Verzeichnis examples/walkthrough/

Schritt 3: Vorschau und Verfeinerung

  1. Remotion Studio starten:

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

    • Stelle sicher, dass jeder Bildschirm angemessene Anzeigedauer hat
    • Überprüfe, ob Übergänge flüssig sind
    • Kontrolliere das Timing von Textüberlagerungen
  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 der Remotion CLI rendern:

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

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

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

Erweiterte Funktionen

Interaktive Hotspots

Markiere klickbare Elemente oder wichtige Funktionen:

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 Erzählung zum Walkthrough hinzu:

  1. Generiere Sprachausgaben-Skript aus Bildschirmbeschreibungen
  2. Verwende Text-to-Speech oder nimm Audio auf
  3. Importiere Audio mit der <Audio>-Komponente in Remotion
  4. Synchronisiere Bildschirm-Timing mit dem Sprechtempo

Dynamische Textextraktion

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

  1. Lade htmlCode.downloadUrl für jeden Bildschirm 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 der Komposition als getimte Textüberlagerungen 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                # Bildschirm-Manifest
└── output.mp4                  # Gerendertes Video

Integration mit Remotion Skills

Remotion pflegt eigene Agent-Skills, die Best Practices definieren. Sieh dir für fortgeschrittene Techniken diese an:

Wichtige Remotion-Skills, die genutzt werden sollten:

  • Animationstiming und Easing
  • Kompositionsarchitektur-Muster
  • Leistungsoptimierung
  • Audiosynchronisation

Häufige Muster

Muster 1: Einfache Diashow

Basis-Walkthrough mit Einblendübergängen:

  • 3–5 Sekunden pro Bildschirm
  • Überblendübergänge
  • Textüberlagerung am unteren Rand mit Bildschirmtitel
  • Fortschrittsbalken oben

Muster 2: Feature-Hervorhebung

Fokus auf bestimmte UI-Elemente:

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

Muster 3: Benutzerfluss

Zeige den schrittweisen Benutzerweg:

  • Aufeinanderfolgender Bildschirmablauf mit Richtungsfolien
  • Nummerierte Schritte als Überlagerung
  • Hebe Benutzeraktionen hervor (Klicks, Taps)
  • Verbinde Bildschirme mit animierten Pfaden

Fehlerbehebung

ProblemLösung
Unscharfe ScreenshotsStelle sicher, dass heruntergeladene Bilder in voller Auflösung vorliegen; überprüfe die Qualitätseinstellungen von screenshot.downloadUrl
Verschobener TextÜberprüfe, ob Bildschirmabmessungen mit Kompositionsgröße übereinstimmen; passe Textposition basierend auf tatsächlicher Bildschirmgröße an
Ruckelige AnimationenErhöhe Bildrate auf 60 fps; verwende korrekte Spring-Konfigurationen mit geeigneter Dämpfung
Remotion-Build fehlschlagÜberprüfe Node-Versionskompatibilität; stelle sicher, dass alle Abhängigkeiten installiert sind; siehe in der Remotion-Dokumentation nach
Timing wirkt falschPasse Dauer pro Bildschirm im Manifest an; Vorschau im Remotion Studio; teste mit echten Benutzern

Best Practices

  1. Seitenverhältnis beibehalten: Verwende tatsächliche Stitch-Bildschirmabmessungen oder skaliere proportional
  2. Konsistentes Timing: Halte die Anzeigedauer der Bildschirme konsistent, es sei denn, bestimmte Bildschirme sollen betont werden
  3. Lesbarer Text: Stelle ausreichenden Kontrast sicher; verwende angemessene Schriftgrößen; vermeide überladene Überlagerungen
  4. Flüssige Übergänge: Verwende Spring-Animationen für natürliche Bewegungen; vermeide ruckartige 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:

Schau dir die Bildschirme in meinem Stitch-Projekt "Taschenrechner App" an und erstelle
 ein Remotion-Video, das einen Walkthrough der Bildschirme zeigt.

Agent-Workflow:

  1. Stitch-Projekte auflisten → "Taschenrechner 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 Bildschirm-Metadaten erstellen
  5. Remotion-Komponenten generieren (ScreenSlide.tsx, WalkthroughComposition.tsx)
  6. Vorschau im Remotion Studio → Timing und Übergänge verfeinern
  7. Endgültiges Video rendern → taschenrechner-walkthrough.mp4
  8. Abschluss mit Videovorschau-Link melden

Tipps für den Erfolg

  • Fang einfach an: Beginne mit einfachen Einblendübergängen, bevor du komplexe Animationen hinzufügst
  • Befolge Remotion-Muster: Nutze die offiziellen Skills und Dokumentation von Remotion
  • Verwende Manifest-Dateien: Halte Bildschirmdaten in JSON organisiert, um einfache Aktualisierungen zu ermöglichen
  • Vorschau häufig: Verwende Remotion Studio, um Probleme frühzeitig zu erkennen
  • Barrierefreiheit bedenken: Füge Untertitel hinzu; stelle sicher, dass Text lesbar ist; verwende klare Grafiken
  • Für Plattform optimieren: Passe Videoabmessungen an die Zielplattform an (YouTube, soziale Medien, etc.)

Referenzen

Wann diese Skill verwendet werden sollte

Verwende diese Skill bei Aufgaben, die in ihre primäre Domäne oder Funktionalität fallen, wie oben beschrieben.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Verwandte Skills