Communitygithub.com

gdoteof/explainers

Führe die Konversations-, Recherche-, Script-, Sprach- und Videopipeline im explainers-Repository (~/claude/explainers) aus. Hilf dem Besitzer, ein Video zu entwickeln: vom Gespräch über die Idee, Recherche, Faktenblatt, Skripterstellung, Sprachaufnahme bis hin zur Videoproduktion mit Skia und Manim.

Was ist explainers?

Dieses Skill ermöglicht die vollständige Erstellung von Erklärvideos mittels der Pipeline im `explainers`-Repository. Es beginnt mit einer strukturierten Konversation mit dem Besitzer, um die Kernidee, These und die stärksten Einwände zu identifizieren, bevor überhaupt recherchiert wird. Darauf folgt eine faktenbasierte Recherche mit Quellenangabe, das Schreiben eines präzise getakteten Skripts (mit Kennzeichnung jedes Satzes als Fakt, Schätzung, Meinung etc.), die lokale Sprachaufnahme mit Aufnahmeprüfung und schließlich die visuelle Umsetzung mit Skia (Zeichnungen) und Manim (Diagramme/Charts) in einer interaktiven Szene. Der Ablauf ist modular mit Kontrollpunkten für den Besitzer: Skriptfreigabe, Sprachaufnahme und Endkontrolle. Das Skill unterstützt die Arbeit im Terminal mit `uv run` und Python-Befehlen wie `explainers.new`, `explainers.check`, `explainers.narrate`, `explainers.render` und `explainers.describe`. Es ist ideal für Entwickler und Kreative, die einen ganzheitlichen, nachvollziehbaren Workflow für Erklärvideos suchen, bei dem jeder Schritt auf Transparenz und Wiederholbarkeit ausgelegt ist.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Erklärvideo

Arbeite vom Repository-Stammverzeichnis aus mit uv run. Die README.md enthält die Befehle und Dateiformate; die EDITORIAL.md ist der Standard. Dies ist die Arbeitsreihenfolge und wo die Kontrollpunkte des Besitzers liegen.

0. Das Gespräch, wo ein Video beginnt

Videos entstehen aus dem, was der Besitzer denkt, geprüft – nicht aus einer Themenliste. Befrage ihn vor jeder Recherche.

  • Ein oder zwei Fragen auf einmal, in einfacher Unterhaltung, und kurz: Der Besitzer antwortet per Diktat, und fünf auf einmal waren zu viele zum Beantworten oder um den Überblick zu behalten. Mische im Laufe der Runden die Arten: offene Fragen ("Was schützt jede Seite?"), Quizfragen, die du beantwortest, bevor du die Antwort nachschlägst ("Welchen Anteil würdest du schätzen?"), Stahlmantests ("Stelle den Fall der anderen Seite so dar, dass sie ihn unterschreiben würden") und Köder: der stärkste Einwand gegen das, was sie gerade gesagt haben, direkt formuliert. Folge der Antwort, die dich überrascht hat, nicht der nächsten Frage auf einer Liste.
  • Die falschen Vermutungen des Besitzers können auf dem Bildschirm erscheinen: Er hat dem zugestimmt. Aber eine Zahl ist nur dann seine Vermutung, wenn er sie als solche angeboten hat. Eine Zahl in einem Beispiel ("Angenommen, sie geben 70 % für Rechnungen aus ...") ist eine Veranschaulichung: Notiere sie als solche, bewerte oder zeige sie niemals als Vermutung, und frage nach, wenn nicht klar ist, um welche es sich handelt.
  • Achte auf die Behauptung unter der Antwort: eine These, die falsch sein könnte, eine Unterscheidung, die sie immer wieder treffen, eine eigene Geschichte. Das sind Videos. Ein Thema ("Abtreibung") ist keine Idee; "die beiden Seiten beantworten unterschiedliche Fragen" ist eine.
  • Behalte ihre Worte. Speichere Antworten wörtlich und datiert in notes/<thema>.md, das git ignoriert: Die Notizen sind roh und privat, und das Skript ist die veröffentlichte Form. Kennzeichne deine eigenen Zusammenfassungen als deine.
  • Sortiere das Gesagte nach dem, was das Skript brauchen wird. Was überprüft werden kann, wird zu Recherche, dann zu fact-, estimate- oder view-Beats. Was ihnen gehört, wird zu opinion oder speculation. Stelle belastete Wörter klar, bevor sie weitergehen ("konstruiert": von wem, und woher würden wir das wissen?), und teile ihnen klar mit, wenn die Quellen etwas, was sie glauben, nicht unterstützen.
  • Höre auf, wenn es eine These gibt, drei oder vier Schritte, die sie tragen, und den stärksten Einwand dagegen. Spiele das in ein paar Zeilen zurück und hole ein Ja ein, bevor du recherchierst.

Der Besitzer möchte wissen, wie die Dinge jetzt funktionieren. Woher etwas kommt, ist ein kurzer Exkurs in einem Video, nicht das Video selbst.

1. Recherche, vor jedem Skript

  • Lege die Frage, die das Video beantwortet, in einem Satz fest, sowie die drei oder vier Dinge, die ein Zuschauer danach sagen können sollte.
  • Erstelle ein Faktenblatt: eine Behauptung pro Zeile, jeweils mit einer Quelle, die in dieser Sitzung abgerufen und gelesen wurde, und der Passage, die sie stützt. Führe die Quellen ab dem ersten Tag in videos/NAME/sources.toml (ein Ordner, der nur diese Datei enthält, ist ein Video, das recherchiert oder pausiert wird) und die Behauptungen in notes/NAME.md. Recherche in einem Unter-Agenten ist in Ordnung, aber weise ihn an, wörtliche Zitate zurückzugeben und zu markieren, was er nicht belegen konnte; akzeptiere niemals eine URL, die er nicht geöffnet hat.
  • Sammle bei einem umstrittenen Thema den Fall jeder Seite von ihren eigenen stärksten Befürwortern und notiere, welche Meinungsverschiedenheiten Tatsachen und welche Werte betreffen.
  • Schreibe auf, was die Quellen NICHT stützen. Beliebte Versionen einer Geschichte sind oft ordentlicher als die Beweise.

2. Skript (Kontrollpunkt: Der Besitzer genehmigt es)

  • python -m explainers.new NAME (es füllt um eine bereits vorhandene sources.toml herum), dann script.md.
  • Ein Video läuft 12 bis 25 Minuten: etwa 2.100 bis 4.400 Wörter im Lesetempo des Besitzers (etwa 175 Wörter pro Minute mit den Pausen). Gib ihm Abschnitte, deren Wechsel der Zuschauer spüren kann, jeder mit einer eigenen Frage.
  • Eine Idee pro Beat, ein Beat pro Atemzug: 15 bis 40 Wörter. Schreib fürs Ohr: kurze Sätze, das wichtige Wort zuletzt, Zahlen gerundet auf das, was ein Zuhörer behalten kann, keine Klammern oder Abkürzungen.
  • Beginne mit der Frage oder der Überraschung, nicht mit einer Begrüßung. Jeder Abschnitt sollte den Zuschauer den nächsten wollen lassen.
  • Beschrifte nach dem, was der Satz verspricht, nicht danach, wie sicher du dich fühlst. Teile einen Beat, der Arten mischt. Ein Skript, das hauptsächlich aus fact und view mit einigen klar gekennzeichneten opinion-Beats besteht, ist das Ziel; check gibt die Aufteilung aus.
  • Schreibe die opinion des Kanals zu einer umstrittenen Frage nicht selbst. Lass eine markierte Lücke oder entwerfe eine und sage deutlich, dass es ein Entwurf ist, den der Benutzer akzeptieren, ändern oder streichen kann.
  • Setze unter jeden Abschnitt eine >-Notiz, die sagt, was auf dem Bildschirm zu sehen ist. Jeder Beat braucht ein Bild, das sich mindestens alle fünf Sekunden oder so ändert.
  • python -m explainers.check videos/NAME --urls muss bestehen. Zeige dem Benutzer das Skript mit der Aufteilung und der Quellenliste.

3. Stimme (Kontrollpunkt: Der Besitzer nimmt sie auf)

  • Entwurf mit der synthetischen Stimme: python -m explainers.narrate videos/NAME. Korrigiere die Wörter, die sie geraten hat, in say.txt. Füge pause zu einem Beat hinzu, wenn sein Bild Zeit zum Wirken braucht. Die Bilder können gebaut und das Skript in diesem Entwurf festgelegt werden.
  • Wenn der Wortlaut festgelegt ist, nimmt der Besitzer es in einem eigenen Terminal auf: python -m explainers.record videos/NAME zeigt jeden Beat, nimmt ihn auf und prüft den Take auf Pegel und auf die Wörter des Skripts. --room nimmt den leeren Raum einmal für die Lücken auf. Dann narrate erneut: Es verwendet einen Take, wo immer ein frischer vorhanden ist. Bilder bleiben bei ihren Wörtern, da Cues nach Wort gesucht werden, aber Beats ändern die Länge: Führe sweep aus und sieh dir vor dem Rendern ein Kontaktblatt an.
  • Der Besitzer muss nicht Wort für Wort lesen. Wo ein Take vom Skript abweicht, zeigt record den Unterschied und, wenn er ihn behält, schreibt es den Beat in script.md auf das um, was er gesagt hat. Committe also das Skript, bevor er aufnimmt, und lies danach git diff davon: Korrigiere die Rechtschreibung und Zeichensetzung der neuen Wörter (das macht keinen Take ungültig), und lies bei jedem geänderten fact, estimate oder view das Quellzitat gegen die neuen Wörter. Wenn es sie nicht mehr stützt, teile dem Benutzer mit: Der Beat wird neu gelesen oder umetikettiert, nicht belassen.
  • Ein selbstständiges Umformulieren eines aufgenommenen Beats kostet den Benutzer eine neue Lesung. Bündele solche Änderungen und frage zuerst.
  • --audition VOICE ... vergleicht synthetische Stimmen für den Entwurf; die voice:-Zeile im Skript wählt eine aus.

4. Bilder

  • Beginne mit der video.py-Vorlage und ersetze sie Szene für Szene. Eine Szene pro Abschnitt ist die übliche Körnung; schneide zwischen ihnen mit theme.scenes.
  • Ein Video spielt auf einem Set (explainers/sets.py): Bisher ein Klassenzimmer mit einer Projektionsleinwand, was der Besitzer so wollte. Zeichne ein Diagramm, eine Karte oder eine Figur als Folie, ein 1920x1080 Bild, und gib es dem Set: Dieselbe Folie ist auf der Leinwand in der Totalen und füllt den Rahmen, wenn die Kamera hineingeht (sets.shots für die Bewegungen). Geh hinein, wenn die Folie gelesen werden muss, komm heraus, wenn der Moderator etwas zu tun hat, und dimme den Projektor (on), wenn der Moderator mit einer Meinung nach vorne tritt. Schreibe den Titel des Abschnitts an die Tafel (chalk) und gib dem Label einen plate, damit es über den Raum hinweg lesbar ist. Die >-Notizen eines Skripts sagen "Total" oder "Projektor". Weitere Sets werden folgen: Halte eine Folie frei vom Raum.
  • Hänge jede Bewegung an einen Cue: N.at(beat, word). Gib niemals eine Zeit in Sekunden ein.
  • Der Moderator ist klein und zur Seite, während etwas erklärt wird, und groß, wenn er für sich selbst spricht (Eröffnung, Meinung, Schluss). Er schaut auf und zeigt auf das, worüber gesprochen wird.
  • Diagramme, Graphen und alles Mathematische kommen in einen Manim-Insert. Alles andere ist Skia.
  • Seiten eines Arguments sind theme.SIDE_A / theme.SIDE_B. Ein Datensatz, den ein Diagramm zeichnet, wird im data/-Verzeichnis des Videos mit Herkunft und Datum gespeichert.
  • Schleife: preview einen Abschnitt, sieh dir das Blatt an, korrigiere, wiederhole; sweep vor jedem Rendern.

5. Rendern und übergeben (Kontrollpunkt: Der Besitzer sieht es an)

  • python -m explainers.render videos/NAME --fresh, dann python -m explainers.describe videos/NAME.
  • Berichte, was faktengeprüft ist und was nicht, jeden Beat, dessen Beschriftung eine Ermessensentscheidung war, und alles, was die Stimme seltsam sagt.

Verwandte Skills