Communitygithub.com

screen-demo

Erstelle ein hochwertiges Demovideo (und ein GIF) von jeder Website oder Web-App per Code. Claude analysiert die Seite, plant einen Rundgang, und ein Skript führt ihn in Chromium aus – mit flüssigem Cursor, echten Klicks, Tippen und sanftem Scrollen – und rendert dann ein Video in 1920×1080 (oder Hochformat oder Quadrat) mit Zooms auf wichtige Elemente, Hervorhebungsringen, Untertiteln und einem Titelbild. Verwende es, wenn der Nutzer sagt: „Mach ein Demovideo von meiner Seite“, „Nimm meine App auf“, „Produktdemo“, „Bildschirmaufnahme dieser Seite“, „Mach ein GIF von meiner Landingpage für die README“, „Zeig in einem Video, wie das funktioniert“, „Walkthrough-Video“ oder eine URL angibt und ein Video davon möchte.

Was ist screen-demo?

Dieses Skill verwandelt eine URL in ein professionelles Demovideo (MP4) und optional ein GIF, ideal für Produktdemonstrationen, READMEs oder Shorts. Claude fungiert als Regisseur: Es untersucht die Seite, erstellt eine JSON-basierte Tour (Schritte wie Titel, Scrollen, Zoomen, Klicken, Tippen), und ein Playwright-Skript spielt diese Tour in Chromium ab. Die Aufnahme erfolgt Frame-für-Frame mit 30 fps, sodass Scrollen, Cursorbewegungen und Tippen auch bei schweren Seiten flüssig wirken. Die Ausgabe wird automatisch geschnitten: Zooms auf wichtige Bereiche, Hervorhebungsringe, Untertitel und ein Titelbild werden eingefügt. Unterstützt werden die Formate Querformat (16:9), Hochformat (9:16) und Quadrat (1:1). Der Workflow umfasst die Inspektion der Seite (erkennbare Elemente mit Nummern), das Schreiben einer kurzen Tour (10–40 Sekunden), die Aufnahme und die Nachbearbeitung. Das Skill ist Open Source unter der MIT-Lizenz und erfordert Python, Playwright, Pillow und ffmpeg. Es wird für Claude Code (oder ähnliche KI-Agenten) empfohlen und eignet sich besonders, wenn Nutzer eine einfache Möglichkeit wünschen, ohne Bildschirmaufnahme-Tools oder Videobearbeitung ein ansprechendes Demo-Video zu erstellen.

Funktioniert mit✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/gabrielebolognese/screen-demo/tree/HEAD/skills/screen-demo

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht screen-demo?

Verwandelt eine URL in ein Demovideo. Du bist der Regisseur: Du schaust dir die Seite an, schreibst die Tour als JSON, und das Skript führt sie aus, erfasst die eigenen Frames der Seite (niemals den Desktop) und bearbeitet das Video. Scrollen, das Gleiten des Cursors und Tippen werden Frame für Frame bei 30 fps aufgezeichnet, also sind sie selbst auf einer schweren Seite flüssig; was die Seite nach einem Klick oder Laden selbst tut, stammt aus dem Live-Screencast.

Einrichtung (einmalig)

  1. Python 3.10+ mit Pillow und einem aktuellen Playwright: python -m pip install -U playwright pillow, dann python -m playwright install chromium.
  2. ffmpeg im PATH (winget install ffmpeg, brew install ffmpeg).

Überprüfung mit python tests/selftest.py (eine lokale Seite, kein Netzwerk, ca. eine Minute).

Arbeitsablauf

  1. Fragen, wofür das Video ist: die URL, die 2 bis 4 Dinge, die gezeigt werden sollen (der Hero, eine Funktion, der Preis, ein Anmeldevorgang), das Format (landscape 16:9 für YouTube und READMEs, vertical 9:16 für Shorts und Reels, square) und ob sie ein GIF möchten. Nur die eigene Seite oder App des Nutzers, oder eine öffentliche Seite, die er zeigen darf.
  2. Die Seite ansehen: python scripts/demo.py inspect URL WORK [--format vertical]. Lies jedes WORK/page-N.jpg (die Seite in viewport-großen Ausschnitten, jedes klickbare Element mit einer roten Nummer versehen) und WORK/elements.txt. Ein Cookie-Banner oder ein Pop-up erscheint hier: Der erste Schritt der Tour schließt es (der „Ablehnen“- oder „Schließen“-Button).
  3. WORK/tour.json schreiben (Format in references/tour-format.md): ein Titelbild, dann kurze Schritte. Eine gute Tour: eine Bildunterschrift, die sagt, was das Produkt tut, ein Scrollen zum ersten sehenswerten Element, ein Zoom darauf, ein Klick oder etwas Tippen, das die Funktionsweise des Produkts zeigt, eine Hervorhebung des Ergebnisses, eine Bildunterschrift pro Idee. 15 bis 40 Sekunden. Ziele sind die Nummern der Inspektion (#12), oder css=... oder text=....
  4. Aufnehmen: python scripts/demo.py record WORK/tour.json OUT [--gif]. Es spielt die Tour ab, gibt jeden fehlgeschlagenen Schritt aus und rendert OUT/demo.mp4 (und OUT/demo.gif).
  5. OUT/keys.jpg ansehen (ein Bild von jedem Schritt), bevor du es als erledigt betrachtest: ein Zoom auf die falsche Sache, eine Bildunterschrift über dem Kernpunkt des Bildes, ein fehlgeschlagener Schritt (das Element wurde verschoben oder war versteckt), ein Banner, das noch im Weg ist. Um nur die Bildunterschriften, Zooms oder das Titelbild zu ändern, bearbeite OUT/tour.json und führe python scripts/demo.py render OUT [--gif] aus (keine neue Aufnahme); bei allem anderen nimm erneut auf.
  6. Ausliefern: den Pfad von demo.mp4 (und des GIFs), seine Länge und eine Zeile pro darin gezeigter Idee.

Regeln

  • Niemals mit einem Passwort anmelden, niemals ein Passwort oder eine Kartennummer eingeben (das Skript lehnt Passwort- und Zahlungsfelder ab), niemals kaufen, senden, posten oder löschen, niemals ein Formular mit persönlichen Daten einer anderen Person absenden. Eine Demo eines angemeldeten Bereichs erfordert, dass der Nutzer selbst eine Seite eines Testkontos bereitstellt.
  • Cookie-Banner ablehnen (die geringsten Daten), es sei denn, der Nutzer sagt etwas anderes.
  • Bildunterschriften kurz halten (3 bis 8 Wörter); eine Idee pro Bildunterschrift; die Bewegung des Videos selbst erledigt den Rest.
  • Die Seite respektieren: keine Tour einer Seite, die der Nutzer möglicherweise nicht zeigen darf.

Beispiel

Nutzer: „Mach ein 20-Sekunden-Demo-Video von meiner Landingpage https://example.com für die README, zeig die Anmeldung.“

Du führst inspect aus, liest die 3 Ausschnitte, siehst ein Cookie-Banner (#2 „Alle ablehnen“), den Hero, ein „Probier es aus“-Feld (#9) und eine Preiskarte (#21); du schreibst eine Tour: ein Titelbild, klick #2, Bildunterschrift „Notizen, die sich selbst schreiben“, tippe in #9, klick #10, hebe das Ergebnis hervor, Bildunterschrift „Für immer kostenlos“, scrolle zu #21, zoom; nimm mit --gif auf, öffne keys.jpg, siehst, dass der Zoom den Preis gut eingerahmt hat, und antworte mit demo.mp4 (21 s), demo.gif (3 MB) und den vier Ideen.

Verwandte Skills