Communitygithub.com

ahnchiyoon87/claude-skills

Nimmt den tatsächlichen Nutzungsprozess eines Dienstes mit Playwright auf, untertitelt ihn aus Verbrauchersicht und erstellt Demovideos unter 5 Minuten. Wird für Anfragen wie „Nimm ein Video auf“, „Demo-Video“, „Vorführvideo“ oder „Halte den Prozess als Video fest“ verwendet. Präsentationsfolien oder Übungsleitfäden werden nicht behandelt.

Was ist claude-skills?

Dieser Skill („데모 영상“ / Demovideo) automatisiert die Erstellung kurzer Demovideos (≤5 Minuten) für Software-Dienste. Er nutzt Playwright zur Aufzeichnung realer Benutzerinteraktionen in 1280×720 Auflösung, generiert automatisch Untertitel (SRT + eingebrannt) aus Verbrauchersicht und komponiert alles mit ffmpeg zu einem MP4-Video. Der Prozess gliedert sich in sechs Phasen: Szenenplanung (3–6 Szenen), Live-Aufnahme mit Playwright (inklusive slowMo und Wartezeiten), Untertitel-Erstellung in einfacher Sprache, Zeitoptimierung auf unter 5 Minuten, ffmpeg-Synthese mit SRT-Einbrennung und finale Qualitätskontrolle mittels ffprobe und Frame-Extraktion. Der Skill arbeitet projektbasiert, beachtet CLAUDE.md-Konfigurationen und vermeidet riskante Aktionen in Produktionsumgebungen. Er ist primär für Claude Code, Cursor und ähnliche KI-Agenten konzipiert, die Entwicklern bei der Erstellung von Produktdemos helfen.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Demovideo

Ein Demovideo zeigt den tatsächlichen Nutzungsprozess eines Dienstes aus Verbrauchersicht. Maximal 5 Minuten. Ein einziger Satz wie „Nimm diesen Prozess als Video auf und füge eine einfache Erklärung hinzu“ reicht aus, um mit den untenstehenden Standardwerten alles zu erstellen.

Standardwerte: Playwright-Aufnahme (1280×720) · Erzählung als Untertitel (SRT + eingebrannt), Sprachausgabe nur auf Anfrage · Ergebnis als MP4 + SRT. Die Art, den Dienst zu starten, Testkonten und der Videostil richten sich nach der Projektdatei CLAUDE.md.

Ablauf

  1. Szenen unterteilen — Die Anfrage in einen Benutzerablauf mit 3–6 Szenen aufschlüsseln. Pro Szene: „Was zu sehen ist“ und „Erklärung in ein bis zwei Sätzen“.

  2. Tatsächlich durchspielen und aufnehmen — Den Dienst starten und mit Playwright recordVideo (gleiche Größe wie Viewport) von Anfang bis Ende real bedienen. In menschlichem Tempo (slowMo um die 300 ms), nach jedem Klick warten, bis das Ergebnis auf dem Bildschirm sichtbar ist. Die Videodatei wird erst beim Schließen des Kontexts fertiggestellt. Nur fehlgeschlagene Szenen neu aufnehmen. Für jede Szene die Referenzzeit der Aufnahme (Start, Ergebnis sichtbar, Ende) notieren.

  3. Untertitel schreiben — Keine internen Fachbegriffe oder Codenamen verwenden. Stattdessen erklären, „was dadurch besser wird“. Ein bis zwei Sätze pro Szene, nachdem das Ergebnis sichtbar ist.

    • Schlecht: „Erstelle einen PR, der die Hit-Policy der DMN-Regel 3 auf FIRST ändert.“
    • Gut: „Die sich überschneidenden Regeln werden bereinigt, sodass bei derselben Bestellung kein Rabatt doppelt gewährt wird.“
  4. Auf unter 5 Minuten kürzen — Lade- und Wartezeiten herausschneiden oder beschleunigen. Die 2–3 Sekunden für den Bedienmoment und das Lesen des Ergebnisses bleiben erhalten. Falls die Zeit trotzdem überschritten wird, Szenen zusammenlegen. Die in der Anfrage genannten Kernschritte dürfen nicht entfernt werden.

  5. Synthese — Mit ffmpeg die Abschnitte aneinanderhängen und auf Basis der Zeitstempel des finalen Schnitts die SRT neu berechnen und einbrennen. Unter Windows ins Arbeitsverzeichnis wechseln und mit relativen Pfaden arbeiten (Problem des Escape von : im Pfad). Schriftart: Windows Malgun Gothic, Linux: installierte koreanische Schriftart (z. B. Noto Sans CJK KR).

    ffmpeg -i edited.mp4 -vf "subtitles=demo.srt:force_style='FontName=Malgun Gothic,FontSize=22'" -c:a copy demo.mp4
    
  6. Prüfung — Mit ffprobe -v error -show_entries format=duration -of csv=p=0 demo.mp4 prüfen, ob das Video ≤300 Sekunden ist. Aus einigen Untertiteln Frames extrahieren (ffmpeg -ss <Sekunde> -i demo.mp4 -frames:v 1 f_<Sekunde>.png), die Bilder direkt öffnen und überprüfen, ob der Untertitel das auf dem Bildschirm Sichtbare beschreibt und koreanische Schriftzeichen nicht verzerrt sind.

Was zu beachten ist

  • Keine simulierten Bildschirme, Mock-Antworten, DOM-Wert-Injektionen oder per Force-Klick erzeugte Szenen verwenden. Falls ein vollständiger Durchlauf nicht möglich ist, wird dies gemeldet.
  • Schwierig rückgängig zu machende Aktionen (wie echte PR-Merges, Änderungen an Produktionsdaten, Versand oder Zahlungen) nur in der vom Projekt festgelegten Testumgebung durchführen. Falls eine solche Umgebung nicht existiert, den Benutzer unmittelbar vor dieser Szene fragen. Passwörter und Tokens dürfen weder auf dem Bildschirm noch in Untertiteln sichtbar sein.
  • Meldung: Pfade zur MP4 und SRT, tatsächliche Länge, Beschreibung pro Szene, visuell geprüfte Frames, nicht geprüfte Aspekte. Veröffentlichung und Versand erfolgen nur auf gesonderte Anfrage.

Verwandte Skills