Communitygithub.com

reel

Zeigt einem Agenten, wie man ein „Reel“ plant, erstellt oder schneidet, sodass das konkrete Ergebnis ein fertiger Video-Clip ist. Der Ablauf folgt /reel: Videoproduktion für Claude Code, Arbeitsreihenfolge: zuerst Regie, dann Schnitt, Auslieferungs-Gate (obligatorisch). Verwenden Sie diese Fähigkeit, wenn eine neue Aufgabe diese Disziplin erfordert.

Was ist reel?

Reel ist eine leistungsstarke, ffmpeg-basierte Videoproduktionsfähigkeit für Claude Code, die es KI-Agenten ermöglicht, Videoclips professionell zu planen, zu erstellen und auszuliefern. Die Fähigkeit stellt sicher, dass der Agent zuerst die kreative Richtung festlegt (Regie-Arbeit mit Briefing und Storyboard), bevor technische Bearbeitung und Rendering durchgeführt werden. Sie umfasst ein obligatorisches Qualitätsgate für die Auslieferung, das aus fünf Stufen besteht: Briefing-Registrierung, Sprachüberprüfung, Render-Prüfung, Review des gesamten Clips und finale Auslieferung mit versionsspezifischen Belegen. Reel unterstützt verschiedene Plattformen (macOS, Linux) und kann optional eine Remote-GPU für rechenintensive Aufgaben nutzen. Es bietet Funktionen wie Subjektverfolgung, Bild-in-Bild-Zoom, Übergänge, Untertitel, Hintergrundmusik, OWLv2-Objekterkennung und technische Prüfungen, aber keine eingebauten Eased-Übergänge, Frame-Interpolation oder Sprachklonung.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/shuaige121/reel/tree/HEAD/skills/reel

In Ihrer bevorzugten KI fragen

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

Dokumentation

/reel: Videoproduktion für Claude Code

Ein mehrschichtiges Tool, das auf ffmpeg aufbaut. Sie (Claude) sehen sich das Material an, entscheiden, was gezeigt werden soll, und schreiben einen Plan; der Code erledigt die Bildgeometrie, das Rendern und die Prüfungen. Die Ausgabegröße ist konfigurierbar (Standard Hochformat 1080x1920).

Befehle und Dateiformate sind in docs/ENGINE.md des reel-Repositorys dokumentiert. Lesen Sie es vor dem ersten Befehl: cat "$(reel --root)/docs/ENGINE.md". reel <command> --help listet alle Optionen auf. Jeder Befehl gibt ein JSON-Objekt aus ({"ok": true, "result": ...} oder {"ok": false, "error": {"code": ..., ...}}) und beendet sich bei Fehler mit Exit-Code 1.

Arbeitsreihenfolge: zuerst Regie, dann Schnitt

Für jedes Video, das jemand anderes als der Benutzer sehen wird, folgen Sie SOP.md: S0 Aufnahme, S1 Quellpaket, S2 Asset-Inventar, S3-S4: Ein director-Agent schreibt direction/BRIEF.md und ein Storyboard, dann sofort Schnitt (der Genehmigungsschritt G1 blockiert standardmäßig nicht), dann das Auslieferungsgate unten. Bei S7 überprüft ein separater director-Agent den Schnitt anhand des BRIEFs. Als Plugin installiert heißt der Agent reel:director.

  • Geben Sie dem Regisseur die Pfade des Originalmaterials, nicht Ihre eigenen Schlussfolgerungen darüber.
  • Wenn ein genehmigtes BRIEF existiert und sich Zweck, Zielgruppe und Materialumfang nicht geändert haben, folgen Sie ihm.
  • Wenn der Benutzer sagt, das Video sei langweilig oder sinnlos, gehen Sie zurück zu S3 und überdenken Sie das Stück; führen Sie nicht nur einen Neuschnitt durch.

Auslieferungs-Gate (obligatorisch)

Jeder Schritt wird durch Code erzwungen: Überspringen Sie einen, können Sie keinen endgültigen Schnitt ausliefern.

  1. Schreiben Sie zuerst das Briefing ($P/brief.json, Vorlage unten) und registrieren Sie es: reel register brief.json. Auslieferungssprache, endgültig oder Muster, Auslieferungsordner und was sich nicht ändern darf: Wenn Sie diese Angaben nicht ausfüllen können, fragen Sie den Benutzer. Nach der Registrierung verweigert der Bash-Guard-Hook cp/mv/ffmpeg-Schreibvorgänge in den Auslieferungsordner.
  2. Hören Sie die Stimme an. Es gibt keine Standardstimme. Wählen Sie eine, die zum Briefing passt, rendern Sie eine 10–20 s lange Probe und führen Sie reel voice check sample.mp3 --script sample.txt --brief brief.json aus. Lokales Whisper transkribiert die Probe und vergleicht sie mit dem Text (--lang standardmäßig en; für eine chinesische Sprachausgabe übergeben Sie --lang zh, was nach tonlosem Pinyin vergleicht, sodass homophone Schreibweise nicht als Fehler zählt); nur eine Fehlerrate von 10 % oder weniger schreibt die Genehmigung in brief.voice.approved (by: claude, mit dem Transkript als Nachweis). Wenn der Benutzer zugehört hat, notieren Sie stattdessen seine genauen Worte.
    • STT beweist, dass die Wörter korrekt und deutlich gelesen werden. Es beweist nicht, dass die Stimme zum Stück passt: Sagen Sie in Ihrer Antwort, dass Sie die Stimme ausgewählt haben, und wechseln Sie die Stimme in der nächsten Version, wenn der Benutzer sie nicht mag.
    • Eine neue Stimme benötigt eine neue Überprüfung. Die macOS say-Stimme ist nur für interne Entwürfe, niemals für ein ausgeliefertes Video.
  3. Überprüfen Sie den Render: reel check final.mp4 --plan plan.json --brief brief.json [--profile vertical-strict|project-profile.json] [--text caption.txt].
    • Exit-Code 1 bedeutet, dass es nicht ausgeliefert werden kann. Lesen Sie result.gate.blockers (technische Fehler: selbst eine Probe kann nicht ausgeliefert werden) und result.gate.pending_review (Punkte, die ein Prüfer ansehen muss).
    • Verlassen Sie sich nicht allein auf ok. result.gate.not_covered listet auf, was nicht geprüft wurde (z. B. Bildschirmtext, für den es kein OCR gibt); sagen Sie niemals, dass diese Punkte geprüft wurden.
  4. Überprüfung. Sehen Sie sich jedes needs_review-Element an (reel scrub, Frame-Abzüge) und schreiben Sie einen Überprüfungsdatensatz pro Element mit zeitcodierten Beobachtungen. Sehen Sie sich den gesamten Schnitt selbst an und unterschreiben Sie final_watch (mindestens ein Frame pro Einstellung); hören Sie von Anfang bis Ende zu und unterschreiben Sie final_listen (eine Agentenunterschrift benötigt zeitcodierte Beobachtungen; wenn der Benutzer zugehört hat, notieren Sie seine genauen Worte als quote). Wenn Sie beide unterschrieben haben, liefern Sie es als endgültig aus: Die Quittung sagt approved_by: agent, und Ihre Antwort sagt „Endschnitt, von Claude überprüft, noch nicht von Ihnen gesehen“. Das Feedback des Benutzers wird zur nächsten Version. Das Format von reviews.json finden Sie in docs/ENGINE.md.
  5. Ausliefern: reel deliver final.mp4 --brief brief.json --version v3 --plan plan.json --reviews reviews.json.
    • Wenn die endgültigen Bedingungen nicht erfüllt sind, schlägt es mit DELIVERY_NOT_FINAL fehl und listet die Gründe auf. Dann ist nur --sample möglich: Der Dateiname trägt sample-pending-review, und Sie müssen es als Muster bezeichnen, wenn Sie es dem Benutzer mitteilen.
    • Eine Versionsnummer kann nur einmal ausgeliefert werden; alte Versionen werden niemals gelöscht oder überschrieben. Nur wenn der Benutzer ausdrücklich darum bittet, alte Versionen zu entfernen: reel register brief.json --remove, löschen, dann erneut registrieren.
  6. „Fertig“ sagen erfordert eine Quittung mit status: final (reel receipt <receipt.json> überprüft sie erneut). Andernfalls geben Sie den wahren Status an: „nicht fertig“, „Muster ausstehend“, „Stimme nicht geprüft“. Der Stop-Hook blockiert eine Behauptung der Fertigstellung ohne passende Quittung.
  7. Videos, die durch das eigene Render-Skript eines Projekts (build_*.py und ähnliche) oder in einem anderen Tool erstellt und exportiert wurden, durchlaufen ebenfalls die Schritte 3–6.
{"version": "reel.brief.v1", "name": "spring-promo", "language": "en", "deliverable": "final",
 "delivery_root": "~/Videos/deliveries/spring-promo", "must_not_change": ["end card credit"],
 "voice": {"mode": "recorded"}, "profile": "default"}
  • voice.mode: none (keine Stimme), recorded (eine echte Aufnahme), tts oder clone (diese beiden benötigen auch voice_id und einen von reel voice check geschriebenen approved-Block oder eine menschliche Genehmigung mit quote, sample und sample_sha256).
  • delivery_root muss ein vorhandener absoluter Pfad sein (oder mit ~ beginnen). Es darf nicht das Home-Verzeichnis, Desktop, Dokumente, Downloads, das iCloud Drive-Root, der Projektordner oder ein darüber liegender Ordner sein.
  • Eine stumme Version verwendet ein Projektprofil: {"extends": "default", "audio": "silent"}.
  • Profile: default (allgemeine Starts chwellwerte) und vertical-strict (1080x1920 30 fps, -16 LUFS, streng). Projektunterschiede in ein Projektprofil mit extends aufnehmen; beabsichtigte lange Halte in allow mit Grund eintragen; verbotene Wörter (alte Produktnamen, Fülltext) zu text.extra_banned hinzufügen.

Zu Beginn jedes Bash-Aufrufs

Jeder Bash-Aufruf startet eine neue Shell, daher beginnen Sie jeden Aufruf mit:

REEL_PROJECT=spring-promo                      # Name dieses Projekts
command -v reel >/dev/null || { echo "reel ist nicht im PATH (Plugin aktivieren, oder ./install.sh --link ausführen)" >&2; return 1 2>/dev/null || exit 1; }
command -v ffmpeg >/dev/null || { echo "ffmpeg nicht gefunden" >&2; return 1 2>/dev/null || exit 1; }
P="${REEL_PROJECTS_DIR:-$HOME/reel-projects}/$REEL_PROJECT"; mkdir -p "$P/preview" && cd "$P"

Alle Ausgaben befinden sich in $P, niemals in einem temporären Ordner; relative Pfade unten sind relativ zu $P.

Schnitt erstellen

Sie treffen die Entscheidungen (welche Aufnahmen, welches Motiv, Kamerabewegungen, Tempo); Wahrnehmung, Geometrie, Rendering und Prüfungen werden vom Code erledigt. Die vollständige Befehlssyntax finden Sie in docs/ENGINE.md.

  1. Material in $P (Assets, observations.json, plan.json, Vorschauen, Renderings und Prüfberichte befinden sich dort; ein Plan pro Ordner).
  2. Skript und Stimme. Schreiben Sie das Voice-Over-Skript, wählen Sie eine Stimme, die zum Briefing passt, und bestehen Sie das Vorsprechen (Gate Schritt 2). Produzieren Sie voice.mp3 (oder .wav) und, falls Sie Untertitel wünschen, voice.vtt. Verwenden Sie für veröffentlichte Arbeiten bevorzugt eine echte Aufnahme oder eine Stimme, deren Lizenz die Verwendung abdeckt; für ein musikalisches Stück zeigen Sie mit audio.voice auf die Musikspur (sie ist der Timeline-Anker).
  3. Anschauen und Ziele auswählen: reel inspect (jede Datei auflisten) → reel frame (Bild mit dem 0-1-Raster lesen und die Box des Motivs ablesen) → reel observe zum Registrieren, oder reel locate --query ... --check-png ... (OWLv2; schauen Sie sich das Prüfbild an, bevor Sie eine Erkennung verwenden).
  4. plan.json schreiben (EditPlan v1): camera: [] hält das Bild still; zoom_to mit einer observation_id zoomt auf ein registriertes Motiv; verwenden Sie track, wenn sich das Motiv in einem Video bewegt; transition_out für Übergänge. Lassen Sie keine Videoaufnahme einen von inspect gemeldeten Szenenwechsel kreuzen. audio.voice ist erforderlich und wird relativ zu src_dir aufgelöst.
  5. Validieren und Vorschau: reel validate → reel compile → reel preview plan.json s2 --out preview/s2.mp4 --sheet preview/s2.png, dann lesen Sie das Kontaktblatt, um die Kamerabewegung zu beurteilen.
  6. Rendern: reel render plan.json --out "$P/final.mp4" --sheet "$P/preview/final.png" --where local (verwenden Sie --where remote nur, wenn der Benutzer eine Remote-GPU konfiguriert hat und darum bittet). Das Bestehen der Render-Prüfungen bedeutet nur, dass die Datei nicht defekt ist; fahren Sie mit den Gate-Schritten 3–6 fort.

Andere Einstiegspunkte, jeder mit einem Abschnitt in docs/ENGINE.md:

  • Timeline inspizieren und ändern: reel timeline (--format text oder ein --png-Mehrspurbild), reel scrub (Frames um jeden Schnitt), reel edit / undo / history, reel preview --range (Vorschau mit niedriger Auflösung und Ton).
  • Zum Beat schneiden: reel beats music.mp3 --out beats.json → reel snap plan.json --beats beats.json --mode downbeat; dann jeden Schnitt mit reel timeline --png --beats überprüfen. Erfordert ./install.sh --beats.
  • Webseite mit Highlights erzählen: eine Aufnahme mit kind: "web"; Textpositionen stammen aus dem DOM (kein OCR), daher muss ein hervorgehobener Satz exakt dem Seitentext entsprechen; reel words voice.mp3 liefert die Wort-Zeitsteuerung. Erfordert ./install.sh --web.
  • Shotcut-Projekte: reel mlt project.mlt --video-only; --dupes findet doppelt verwendetes Quellmaterial.

Verfügbar: Plan-Assemblierung, Sub-Pixel-Hineinzoomen auf ein Motivfeld, Verfolgung eines sich bewegenden Motivs, Xfade-Übergänge, eingebrannte Untertitel, Hintergrundmusik, Grading und LUTs, Web-Aufnahmen, OWLv2-Motivsuche, technische Prüfungen, gated-Auslieferung. Nicht eingebaut: Eased-Übergänge, Frame-Interpolation, Sprachklonung.

Remote-GPU (optional)

Die Teile mit --where remote werden durch Code erzwungen.

  • Verwenden Sie es nur, wenn der Benutzer REEL_REMOTE (ein SSH-Ziel) konfiguriert hat und darum bittet; andernfalls rendern Sie mit --where local.
  • Der VRAM-Verbrauch ist standardmäßig auf 80 % begrenzt. Wenn ein Job mehr benötigt, gibt das Tool NEED_USER_APPROVAL zurück: Informieren Sie zuerst den Benutzer und fügen Sie --allow-over-80 nur mit seiner Zustimmung hinzu. Eine GPU-Auslastung von 50 % oder mehr bedeutet, dass jemand anderes sie verwendet; nehmen Sie sie nicht in Betrieb.
  • Ein reel-GPU-Job gleichzeitig (Remote-Dateisperre). Ändern Sie keine Energiegrenzwerte. Starten Sie den Host niemals neu oder fahren Sie ihn herunter.
  • reel remote probe meldet den Host; reel remote setup-vision installiert eine separate venv mit torch und den OWLv2-Gewichten auf dem Remote-Host.

Begleitdateien

  • SOP.md: Regie-erster-Workflow, Rollen, Schritte und Ausstiegsbedingungen.
  • Der director-Agent (agents/director.md im Repository): Briefing, Storyboard und Review.
  • docs/ENGINE.md im Repository: Befehle, EditPlan, Briefings, Reviews, Quittungen und Profile.

Verwandte Skills