Communitygithub.com

triptu/erklärvideos-erstellen

Erstelle ein vertontes, untertitteltes Erklärvideo aus fast allem – einem Blogbeitrag oder Artikel-Link, einem Paper, einem oder mehreren Pull Requests, einem Branch oder Diff, einem Repository oder groben Notizen – oder überarbeite ein vorhandenes. Wird ausgelöst durch „Mach ein Video von…", "/video <Link|PRs|Repo>", „Erkläre das als Video", „Video-Walkthrough dieser PRs" oder Änderungen an einem bestehenden Video (Szene korrigieren, kürzen, Stimme ändern, neu rendern).

Was ist erklärvideos-erstellen?

Dieser Skill für KI-Agenten (z. B. Claude Code) verwandelt beliebige Quellen – Artikel, Papers, Pull Requests, Repositories, Diffs oder Notizen – in ein professionelles, vertontes und untertitteltes Erklärvideo. Er ist ideal für Entwickler und technische Autoren, die schnell eine visuelle Zusammenfassung von Codeänderungen, Dokumentation oder Konzepten erstellen möchten, sei es für Code-Reviews, interne Präsentationen oder öffentliche Erklärungen. Der Skill arbeitet direkt im aktuellen Repository – alle Videos landen im `videos/`-Ordner. Er nutzt eine vierstufige Pipeline: (1) gründliches Verstehen des Primärmaterials inklusive Recherche und Code-Analyse, (2) Entwicklung eines klaren Story-Arcs mit präzisem Voiceover, (3) Erstellung animierter Visualisierungen mit echten Screenshots und Code-Snippets, (4) iterative Qualitätsprüfung anhand von Standbildern und Preview-Renderings. Standardmäßig wird die Kokoro-Sprachsynthese verwendet, optional auch Gemini TTS. Die Stärke des Skills liegt in seiner Eigenständigkeit: Er trifft vernünftige Annahmen, recherchiert selbstständig (Websuche, `gh`, Klonen von Repos) und optimiert nicht nur das Minimum, sondern ein vollwertiges, ansprechendes Video. Er unterstützt Link-Eingaben, Repository-Pfade, PRs und sogar die Bearbeitung bereits erstellter Videos. Für Code-bezogene Videos ist die Zielgruppe standardmäßig intern (das Team, das den Code reviewt), für Artikel und Papers öffentlich.

Funktioniert mit✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/triptu/create-explainer-videos/tree/HEAD/.claude/skills/video

In Ihrer bevorzugten KI fragen

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

Dokumentation

Video

Verwandle alles, was der Benutzer dir gibt, in ein Video, das jemand tatsächlich ansehen würde, anstatt die Quelle zu lesen: klare Geschichte, echte Bilder, jede Szene in Bewegung und genaue Behauptungen.

Alle Videos leben in diesem Studio (dem videos/-Ordner dieses Repos). Lies zuerst CLAUDE.md: dort stehen die Befehle, der Arbeitsablauf, die Szenenkonventionen und die Fallstricke. Dieser Skill betrifft das Urteilsvermögen; CLAUDE.md handelt von der Mechanik. Erstelle niemals ein neues Projekt von Grund auf. Verwende npm run new oder bearbeite ein vorhandenes Video im videos/-Ordner direkt.

So arbeitest du

Führe es vollständig durch. Triff vernünftige Annahmen, baue das Video und berichte, was du angenommen hast. Halte nur inne und frage nach, wenn der Benutzer dich ausdrücklich gebeten hat, nachzuhaken, oder wenn du wirklich nicht weiterkommst (die Quelle ist nicht zugänglich, oder es ist wirklich unklar, welche PRs oder welchen Umfang er meint).

Sei einfallsreich. Ziel ist das bestmögliche Video, nicht das Minimum, das mit dem, was du bekommen hast, funktioniert. Nutze jedes hilfreiche Werkzeug: Websuche, die Referenzen der Quelle und verlinkte Seiten, verwandte Beiträge oder Dokumente, frühere Arbeiten des Autors, gh, Klonen und Ausführen von Code, das Live-Produkt und andere Skills. Ergänze fehlenden Kontext, überprüfe Behauptungen, finde bessere Bilder und finde heraus, was ein Begriff oder System bedeutet, anstatt zu raten. Eine enge Quelle beschränkt dich nicht auf das, was darin steht. Wenn ein Ansatz scheitert, versuche einen anderen, bevor du dich mit weniger zufrieden gibst.

Standard-Zielgruppe:

  • Artikel, Beiträge und Papers: Ein kluger Zuschauer, der die Quelle nicht gelesen hat.
  • PRs, Branches, Repos und Code: intern. Der Zuschauer ist der Benutzer, der verstehen möchte, was gemacht wurde, oft weil er es gleich reviewen wird. Optimiere auf „Ich könnte das jetzt sicher reviewen oder diskutieren." Mach ein öffentliches oder Launch-Video nur, wenn der Benutzer es sagt.

Die Länge folgt dem Inhalt. Ein einzelner kleiner PR kann 1–2 Minuten dauern; ein dichter Beitrag 5–8 Minuten. Nicht aufblähen und nicht stopfen. Eine Idee pro Szene.

1. Verstehe es besser als nur überflogen

Gehe zum Primärmaterial und lies alles, bevor du ein Wort schreibst.

  • Links und Papers: Rufe die Seite selbst ab. Zuerst das rohe HTML, dann Playwright, wenn es clientseitig gerendert wird, wenn du Bilder sehen oder aufzeichnen musst oder wenn es blockiert ist (siehe CLAUDE.md). Arbeite niemals mit einer Zusammenfassung. Hol dir den vollständigen Text und jede Abbildung, jedes Video und jede Interaktion. Wenn es hinter einem Login steckt, sag es.
  • PRs und Diffs: Beschreibung, vollständiger Diff, Commits, Review-Threads, verknüpfte Issues, CI-Ergebnisse. Lies auch den umgebenden Code, nicht nur die geänderten Zeilen: Aufrufer, Datenfluss, Tests. Finde heraus, warum es gemacht wurde, was die Alternativen waren und wo das Risiko liegt. Wenn es hilft, das Verhalten zu sehen, führe es aus und halte Vorher/Nachher fest.
  • Repos: Einstiegspunkte, Architektur, der Hauptdaten- oder Kontrollfluss und was ungewöhnlich ist.
  • Notizen oder ein Thema: Recherchiere genug, um korrekt zu sein, und zitiere, woher die Behauptungen stammen.

2. Finde die Geschichte

Entscheide zuerst den Ein-Satz-Kern, dann den Bogen, der ihn untermauert. Normalerweise sind das das Problem, die entscheidende Erkenntnis, wie es funktioniert, die Beweise und was es bedeutet. Für review-orientierte PR-Videos behandle auch: die Form der Änderung, die wichtigen Entscheidungen, was riskant oder subtil ist, wie es getestet wird und wo ein Reviewer hinschauen sollte.

Schreibe das Voiceover fürs Hören, in deinen eigenen Worten. Behalte genaue Zahlen, Namen und Zitate aus der Quelle bei und erfinde niemals Metriken. Wenn du vereinfachst, bleibe wahrheitsgemäß.

Stimme: Standardmäßig Kokoro. Wenn der Benutzer eine natürlichere Stimme möchte oder .env OPENROUTER_API_KEY enthält, verwende Gemini TTS (CLAUDE.md, „Stimmen").

3. Mach es visuell

  • Echte Artefakte zuerst: Die eigenen Abbildungen und Aufnahmen der Quelle, die tatsächliche Benutzeroberfläche (Screenshots oder Aufnahmen der laufenden App) und echter Code als fokussierte Ausschnitte mit hervorgehobenen Zeilen, niemals Code-Wände.
  • Benutzerdefinierte animierte Diagramme für alles andere: Abläufe, Vorher/Nachher, Architektur, hochzählende Zahlen, Vergleiche. Jede Szene sollte etwas Bewegendes haben, das die Idee erklärt, synchron mit den Worten.
  • Design: An die Marke der Quelle anpassen. Bei Code ohne Marke das Aussehen des Produkts oder ein sauberes, codefreundliches Design verwenden.

4. Überprüfen, dann ausliefern

Folge dem Prüfen → Standbilder → Vorschau → Vollrender-Zyklus in CLAUDE.md. Sieh dir die Standbilder an und behebe, was du siehst, einschließlich Überlappungen, leeren Stellen, unlesbarem Text und Timing, das nicht zu den Worten passt. Dann berichte: den Ausgabepfad, die Länge, was das Video abdeckt, was du überprüft hast und alle Annahmen oder Lücken. Sage klar, dass du es nicht vollständig angesehen hast.

Hinterlasse das Studio besser

Wenn du auf einen wiederverwendbaren Fallstrick stößt, füge ihn zu CLAUDE.md hinzu. Wenn du etwas gebaut hast, das andere Videos brauchen werden (eine Code-Diff-Szene, eine PR-Zeitleiste, ein Diagramm-Primitiv), verschiebe es in lib/ oder templates/default. Generierte Assets in videos/*/public/ werden von git ignoriert, also sollte alles, was ein frischer Klon nicht neu generieren kann (heruntergeladene Medien, handgemachte Bilder), von einem Skript geholt werden, nicht nur abgelegt werden.

Verwandte Skills