Communitygithub.com

10llo/reelkit

Verwenden, wenn die Aufnahme des Talents für eine Reelkit-Episode eintrifft – lokal mit Whisper transkribieren, Untertitel an das Skript anpassen, Szenen neu timen, die Änderungen mit dem Benutzer überprüfen und anwenden.

Was ist reelkit?

Dieses Skill automatisiert den Workflow zur Synchronisation von Talent-Aufnahmen mit einem Skript für Reelkit-Episoden. Es nutzt Whisper (lokal oder mit WebGPU) zur Transkription, gleicht die gesprochenen Wörter mit dem Skript ab und erstellt korrigierte Untertitel sowie einen detaillierten Bericht (`sync-report.md`). Der Benutzer kann jeden einzelnen Wort-Unterschied prüfen, manuelle Korrekturen in einer JSON-Datei vornehmen und die finale Anwendung freigeben. Das Skill unterstützt die Modelle `large-v3-turbo` (genau, aber 1,6 GB) und `small` (leichter), erkennt Überläufe der Sprechzeit und markiert nicht erkannte Wörter. Nach der Freigabe werden die Untertitel und Szenenschnitte in der Episode gespeichert, und der Workflow ist bereit für den nächsten Schritt (`/reelkit:export`).

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/10llo/reelkit/tree/HEAD/skills/caption-sync

In Ihrer bevorzugten KI fragen

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

Dokumentation

Untertitel-Synchronisation

Der Clip des Talents wird in den unteren rechten Slot eingefügt; seine Stimme steuert die Untertitel und die Szenenschnitte. Nichts an der Episode ändert sich, bis der Benutzer die Überprüfung genehmigt hat.

Alle Befehle werden aus dem Workspace-Root ausgeführt.

1. Whisper bereit?

npm run reelkit -- whisper check --model=<model>   # das zu verwendende Modell; Standard large-v3-turbo

Wenn das Modell nicht heruntergeladen ist, lädt sync prepare es herunter (1,6 GB für large-v3-turbo) – informiere den Benutzer zuerst oder biete --model=small an (586 MB, weniger genau). Wenn WebGPU nicht verfügbar ist, wird der Clip trotzdem angehängt, aber die Untertitel erhalten das Timing aus dem Skript („provisorisch“).

2. Vorbereiten (schreibt nur Vorschläge)

npm run reelkit -- sync prepare episodes/<folder> <path/to/clip> [--model=large-v3-turbo]

Es kopiert den Clip als talent.proposed.<ext> hinein, transkribiert ihn, gleicht die Wörter mit dem Skript ab und schreibt:

  • sync-report.md – die Überprüfung (Spanisch): Clip-Details, Stille am Anfang abgeschnitten, Szenenschnitte vor → nach, jedes abweichende Wort (an die Schreibweise des Skripts angepasst, ⚠ Revisar für stark abweichende Ersetzungen mit dem Gehörten, ⚠ No se escuchó für übersprungene Wörter, Ad-libs wie gehört beibehalten), Warnungen und ob die Stimme über das Ende hinausgeht.
  • captions.proposed.json – die Untertitel, die das Video verwenden wird (editierbar: ändere das "text" eines Wortes, um es zu korrigieren).
  • sync-proposal.json – Trim, Szenenanfänge, Dateien.

Wie das Alignment entscheidet: Die Schreibweise des Skripts mit dem Timing von Whisper für Wörter, die übereinstimmen oder nahezu übereinstimmen (Zahlen werden mit ihrer gesprochenen Form abgeglichen: „12“ ↔ „doce“); eine stark abweichende Ersetzung zeigt das Gehörte und wird markiert; von Whisper nicht gehörte Wörter werden in den Untertiteln ausgelassen; zusätzliche vom Talent gesagte Wörter werden beibehalten.

3. Mit dem Benutzer überprüfen

Lies sync-report.md und zeige dem Benutzer eine kurze Tabelle: Szenenschnitte (vor → nach), jedes markierte Wort (Szene, Skript, Gehört, Status, Zeit) und die Überlaufzeile, falls vorhanden. Bitte um Genehmigung oder darum, zu sagen, welche Wörter geändert werden sollen (bearbeite captions.proposed.json, zeige dann die Änderung).

  • Stimme läuft über das Ende hinaus (⚠ La voz sigue … s): Die letzten Wörter würden abgeschnitten. Empfehle, kürzer neu aufzunehmen. Nur mit ausdrücklicher Zustimmung des Benutzers mit --accept-overrun anwenden.
  • Eine ganze Szene nicht gehört: Die Bilder passen möglicherweise nicht zum Gesagten – frage, ob neu aufgenommen oder fortgefahren werden soll.
  • Geringe Übereinstimmung („¿Es el clip correcto?“): Bestätige, dass es der richtige Clip und die richtige Episode ist.

4. Anwenden (nach Genehmigung)

npm run reelkit -- sync apply episodes/<folder> [--accept-overrun]

Es benennt den bereitgestellten Clip in talent.<ext> um, schreibt captions.json, speichert clip, sceneStarts, captionsSrc und stage: "synced" in episode.json und entfernt den alten Clip, den es ersetzt hat.

5. Überprüfen

npm run check -- episodes/<folder>
npx remotion still Episode out/<folder>-sync.png --public-dir episodes/<folder> --frame=<N>

Betrachte ein Standbild in der Mitte eines Satzes: Der Clip füllt den Slot und der Untertitel zeigt das gerade gesprochene Wort. Biete Studio an: npm run studio -- episodes/<folder>. Als Nächstes: /reelkit:export.

Verwandte Skills