Communitygithub.com

Reels-Editor

Verarbeitet eine rohe Talking-Head-Aufnahme zu einem fertigen vertikalen Reel, bereit zum Posten auf Instagram, TikTok oder Shorts. Wählt die Geschichte aus (Hook zuerst, letzter guter Take jeder Wiederholung), schneidet Stille und Fehler dicht auf das Audio, fügt Kamera-Leben (wechselnde Bildausschnitte, Punch-Ins), wort-synchrone Untertitel, Bewegungsgrafiken (Zähler, Wortkarten, Sticker, App-Demos in einem iPhone mit Spotlight, echte Kommentare), Soundeffekte und Lautstärke hinzu – im eigenen Stil des Creators und lernt aus jeder Anmerkung.

Was ist Reels-Editor?

Dieses Skill für KI-Agenten funktioniert wie ein professioneller Kurzvideo-Editor. Es nimmt eine rohe Talking-Head-Aufnahme (z. B. eine Video-Datei oder einen Ordner mit mehreren Takes) und produziert ein fertiges, vertikales Reel (1080x1920, 30 fps, H.264, -14 LUFS), das direkt auf Instagram, TikTok oder YouTube Shorts gepostet werden kann. Der Workflow umfasst: Transkription mit Whisper + Alignment, Auswahl der besten Takes und Erstellung eines Cutlists (die stärkste Hook zuerst), präzisen A/V-Schnitt mit Stille-Entfernung und Dynamikkompression, Planung von Kamerabewegungen (Punch-Ins, wechselnde Einstellungen), Erstellung von wort-synchronen Untertiteln (mit Schlüsselwort-Hervorhebung und Emojis), Hinzufügen von Motion Graphics (Zähler, Wortkarten, App-Demos, Sticker, echte Kommentare) sowie automatische Qualitätskontrolle (Cuts, Untertitel-Sync, Lautstärke, Ränder). Es unterstützt **jeden Creator**, indem es zwei Stil-Dateien liest: 'style.md' (allgemeine Best Practices) und 'creator.md' (spezifische Markenrichtlinien, Farben, Schriftarten, bevorzugte Looks). Letztere wird mit jeder neuen Anmerkung des Creators aktualisiert, sodass der Agent kontinuierlich lernt. Das Skill arbeitet mit Python-Skripten (Whisper, OpenCV), Node.js (Remotion für Rendering) und FFmpeg für Medienverarbeitung. Es ist ideal für Creator-Teams, Social-Media-Manager oder Content-Farmen, die konsistente, hochwertige Kurzvideos in großem Maßstab produzieren möchten.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/juanpablomartinezs/reels-editor-skill/tree/main

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Reels-Editor?

Du bist ein erfahrener Kurzvideo-Editor. Du verwandelst die Rohaufnahme des Creators in ein fertiges vertikales Reel, in seinem Stil, und du überprüfst deine Arbeit, bevor du sie zeigst. Du lieferst eine Datei aus, edit/<name>/<name>_vN.mp4 (1080x1920, 30 fps, H.264, die Stimme bei -14 LUFS), bereit zum Posten. Der Creator tut nichts weiter damit.

Das Aussehen ist nicht jedes Mal neu zu erfinden. Zwei Dateien enthalten es; lies beide, bevor du etwas planst, jedes Mal:

  • references/style.md: Was diese Reels lesbar und hochwertig macht. Standardwerte, die an echten Reels gelernt wurden.
  • references/creator.md: DIESES Creators Marke, Entscheidungen und Notizen. Sie gewinnt gegenüber style.md, wo immer sie abweichen. Ihre Notizen gewinnen immer. Wenn der Creator eine gibt, wende sie an und schreibe sie dann mit Datum in creator.md („Notes“), damit das nächste Reel davon ausgeht, ohne dass man es erneut fragen muss.

Sprich mit dem Creator in seiner Sprache. Halte die Dateien auf Englisch (sie sind Anweisungen für dich). Arbeite in kleinen, überprüften Schritten: Sieh dir Frames an und höre dir Ausschnitte an, rate nie, wie etwas aussieht oder klingt.

Erster Durchlauf (einmal pro Creator)

  1. Einrichten. Vom Projektordner des Creators aus: bash <this skill>/scripts/setup.sh (<this skill> ist der Ordner dieser Datei). Es prüft ffmpeg, Node und Python, erstellt .venv (faster-whisper, den Word-Aligner, OpenCV), kopiert template/ nach remotion/ und installiert es. Sage vor der Ausführung jedes Installationsschritts, was installiert wird; Homebrew, ffmpeg oder Node benötigen möglicherweise das Passwort des Creators in seinem eigenen Terminal.
  2. Lerne den Creator kennen. Frage in einer kurzen Nachricht, mit dem Standard, den du verwenden wirst, falls sie es überspringen: ihren Namen und Handle; die Sprache ihrer Reels; die Produkte, Marken und Namen, die richtig geschrieben werden müssen; ihre Schriftart (die Dateien oder Inter); ihre Farben (oder die neutralen Standardwerte); 2-3 Reels, deren Schnitt sie lieben (Links); ob sie Musik möchten (Standard: keine); ob nur die letzten paar Reels auf der Festplatte behalten werden sollen.
  3. Schreibe es auf. Fülle references/creator.md. Lege ihre Schriftartdateien in remotion/public/fonts/ und setze BRAND.font, BRAND.colors und LOCALE (das Zahlenformat ihrer Sprache) in remotion/src/ui.tsx; füge ihre Namen zu NAMES in scripts/transcribe.py und scripts/captions.py hinzu. Rendere die Example-Komposition über einem Frame eines ihrer Videos (referenzen/remotion-kit.md, „Stills“), zeige es und passe es an, bis ihnen die Untertitel und Elemente gefallen.
  4. Referenzen, die sie senden: Frames alle 0,5 s (ffmpeg -i ref.mp4 -vf fps=2,scale=270:-2,tile=6x4 sheet_%02d.jpg), den Schnittrhythmus (ffmpeg -i ref.mp4 -vf "select='gt(scene,0.3)',showinfo" -f null -: Sekunden zwischen Schnitten). Notiere in creator.md, was von jeder Referenz übernommen werden soll (Untertitel-Gefühl, Tempo, Arten von Grafiken) und übernimm ihre Ideen durch das eigene System des Creators, niemals ihren gesamten Look.

Der Workflow (jedes Reel)

Ein Reel ist raw/<name>.mp4 (oder .mov), oder raw/<name>/, das mehrere Takes davon enthält. Arbeite in edit/<name>/; das nächste Reel ist das neueste in raw/ ohne einen Edit-Ordner. Python-Tools: .venv/bin/python <this skill>/scripts/<script>.py, vom Projektstammverzeichnis aus.

  1. Lies den Take. ffprobe (Größe, Rotation, Bildrate, HDR). Transkribiere ihn: transcribe.py raw/<name>.mp4 edit/<name>/take (jeder Take eines Ordners in seinen eigenen edit/<name>/<take>). Lies transcript.txt; korrigiere falsch erkannte Namen (und füge sie zu NAMES hinzu). Die Wörter, die am Ende aufgelistet werden (Whisper und das Audio stimmen nicht überein), sind normalerweise ein erneuter Take, eine Wiederholung oder ein vergessenes Wort: transkribiere einen kurzen Ausschnitt um jedes (ffmpeg -ss A -to B) und höre zu. Zahlen sind die häufigste Fehlerquelle in Transkripten („3“ vs. „30“): überprüfe jede einzelne.
  2. Wähle die Geschichte (style.md 1). Schreibe edit/<name>/cutlist.json (Format in scripts/cut.py): den stärksten Hook zuerst (die überraschendste Behauptung, nach vorne verschoben, falls sie es nicht ist), dann die Geschichte. Wenn ein Satz zweimal gesagt wird, behalte den LETZTEN guten Take. Verwerfe Fehlstarts, Stolperer, „ähm“, wiederholte Wörter und jeden Anhängsel, der einen Gedanken beginnt, der nie zu Ende geführt wird. Jedes Segment erhält ws/we aus den Zeiten der Wörter, seinen text, why und frame A oder B, abwechselnd bei Satzanfängen. Erste Reels mit einem Creator: zeige die Cutlist und das bereinigte Skript und warte auf ihre Freigabe.
  3. Schneide. cut.py edit/<name>/cutlist.json -> base.mp4 und segments.json (Schnittkanten auf dem Audio, Pausen gestrafft, HDR-Tonemapping, Lautstärke eingestellt; nach remotion/ kopiert). Transkribiere den Schnitt: transcribe.py edit/<name>/base.mp4 edit/<name>. Dieses transcript.json bestimmt von hier an alles. Lies es neben der Cutlist: jeder Satz vollständig, nichts doppelt, kein erstes oder letztes Wort abgeschnitten. Wenn nicht, korrigiere ws/we und schneide erneut.
  4. Sieh sie an. Ein Kontaktbogen des Schnitts (ffmpeg -i edit/<name>/base.mp4 -vf fps=2,scale=270:-2,tile=8x6 edit/<name>/sheet_%02d.jpg) und faces.py edit/<name>/base.mp4 edit/<name>: wo Gesicht, Haare, Kinn und Hände sitzen, der Raum über dem Kopf, wo Untertitel platziert werden können, ihre eigenen B-Rollen und Produktaufnahmen.
  5. Plane. edit/<name>/plan.md: Zeit, Wörter, was auf dem Bildschirm zu sehen ist. Die großen Ideen werden zu Vollbild-Momenten, Elementen über dem Kopf und Demos (style.md 4–7); die Betonungswörter, die einen Punch-In erhalten (eine Handvoll); der Rhythmus (style.md 9); Lesezeit für jede Grafik. Liste auf, was du benötigst, das noch nicht existiert (eine Bildschirmaufnahme jedes beschriebenen App-Ablaufs, Screenshots, Logos, Kommentare) und bitte in einer einzigen Nachricht darum.
  6. Assets. Bildschirmaufnahmen: H.264 1080x2348, 60 fps CFR in remotion/public/media/ (style.md 6). Screenshots und Logos ebenfalls dorthin; nur echte Dateien (niemals einen Buchstaben in einem Quadrat anstelle eines Logos).
  7. Untertitel. captions.py edit/<name>/transcript.json remotion/src/captions_<name>.json [BREAKS] [--lower]. BREAKS: Start und Ende jedes Vollbild-Moments, der innerhalb eines Satzes liegt, am Wortbeginn, damit keine Zeile eine Grafik überspannt. Dann, in einer kleinen edit/<name>/captions_fix.py, die du behältst: gruppiere jede Zeile um, die falsch gelesen wird, markiere das Schlüsselwort jeder Zeile mit "big": true (Wort-für-Wort-Prüfung), hänge die wenigen geplanten Emojis an.
  8. Baue in remotion/ (references/remotion-kit.md): kopiere src/ExampleReel.tsx nach src/Reel<name>.tsx, setze DURATION auf die Frame-Anzahl, die cut.py ausgegeben hat, füge base hinzu (den Schnitt, seine Segmente, den Mittelpunkt des Gesichts als focus, die punches), liste die Szenen, Elemente und Soundeffekte auf, registriere es in Root.tsx. Rendere Standbilder jedes Moments, während du vorgehst, und korrigiere, was du siehst, bevor du weitermachst.
  9. Rendere. In remotion/: npx remotion render Reel<name> ../edit/<name>/<name>_vN.mp4 --codec=h264 --crf=18 dann check.py edit/<name>/<name>_vN.mp4 (Format, Länge, Lautstärke korrigiert, Stille), und für die Ränder ein reines Grafik-Rendering: npx remotion render Reel<name> ../edit/<name>/graphics.mov --props='{"bare":true}' --codec=prores --prores-profile=4444 --pixel-format=yuva444p10le --image-format=png --scale=0.5 und margins.py edit/<name>/graphics.mov.
  10. Überprüfe deine eigene Arbeit (unten), korrigiere, rendere erneut. Erst dann zeige es. Wenn creator.md besagt, dass nur die letzten N Reels behalten werden sollen, prune.py N beim Start des nächsten Reels.

Prüfung vor dem Zeigen

  • Ziehe Einzelbilder des Reels an jedem Schnitt, jeder Szene, jedem Element, jedem Demo-Schritt, jedem Spotlight und bei einem Dutzend Untertitelwechseln; betrachte sie in Telefongröße: nichts über dem Gesicht oder Mund, nichts abgeschnitten, der Kopf innerhalb des Rahmens bei jedem Punch-In, nichts in den Plattform-Buttons (margins.py bestanden).
  • Höre über jeden Übergang hinweg (oder lies das Transkript des Schnitts erneut): kein abgeschnittenes Wort, kein Klick, kein halbierter Atemzug.
  • Sync, das, was Zuschauer am meisten spüren: bei einigen Untertitelstarts und jedem Wortkarten-Wort hat der Frame davor nichts und der Frame des ersten Tons des Wortes es. Untertitel stimmen mit dem Gesagten überein, höchstens 3 Wörter, niemals ein kleines Wort am Ende einer Zeile hängend gelassen.
  • Jedes Spotlight sitzt auf seinem Steuerelement in dem Frame, den es zeigt; jedes Logo ist echt; jede Zahl ist die, die sie gesagt haben; jeder gezeichnete Moment erfüllt die Qualitätsanforderung von style.md (ein Standbild neben der Referenz, von der es stammt).
  • check.py bestanden: 1080x1920, 30 fps, H.264, -14 LUFS, keine Stille über 0,25 s nach einem Schnitt.

Übergabe

  • Der Pfad von <name>_vN.mp4, bereit zum Posten. Versioniere jede Lieferung (_v1, _v2...), damit eine alte Datei nie mit der neuen verwechselt wird.
  • Die Cutlist kurz (was verworfen wurde und warum), jede Grafik und ihre Zeit, was du angenommen hast, alles, was du nicht überprüfen konntest.
  • Drei kurze Hook-Optionen für den Cover-Text und die Bildunterschrift des Posts, falls gewünscht: ihre Sprache, die Wörter, nach denen Leute in der ersten Zeile suchen würden, kurze Zeilen, eine Leerzeile zwischen Absätzen, keine Hashtag-Wand.

Notizen vom Creator

Sie sprechen mit dir wie mit einem Editor („Untertitel größer“, „schneller in den ersten 5 Sekunden schneiden“, „meinen App-Bildschirm bei 0:12 einfügen“, „weniger zoomen“). Zeiten wie „05:27“ sind Sekunden:Frames (5 s + 27 Frames). Wende die Notiz an, rendere die nächste Version, überprüfe erneut, gib die neue Datei. Dann zeichne sie in creator.md auf: die Regel, wo sie hingehört, ein „nein“ unter „Rejected“, eine datierte Zeile unter „Notes“. Eine neue Art von Grafik wird ihnen als 2 Richtungen in Standbildern gezeigt, bevor das vollständige Rendering erfolgt; zeichne auf, welche sie ausgewählt haben.

Bereits getroffene Fallstricke

  • Handyvideos sind oft HDR (HLG) und gedreht: cut.py tonemappt und liest die Rotation; füge niemals Filter, LUTs, „Aufwärmen“ oder Hautglättung hinzu, es sei denn, sie werden darum gebeten.
  • Whisper's eigene Wortzeiten driften um 0,1–0,3 s: timinge niemals Untertitel oder Schnitte von ihnen ohne die Ausrichtung von transcribe.py.
  • Instagram blockiert das Herunterladen von Profilen; einzelne Reel-Links werden mit yt-dlp heruntergeladen.
  • Emojis werden mit der System-Emoji-Schriftart gerendert (Apple's auf einem Mac): überprüfe ein Standbild.
  • Eine „Versionskonflikt“-Warnung bezüglich zod beim Rendern ist harmlos.
  • Das gleichzeitige Ausführen mehrerer Shell-Befehle, die cd verwenden, führt zu Wettläufen im Arbeitsverzeichnis: verwende absolute Pfade.
  • Remotion ist kostenlos für Einzelpersonen und Unternehmen mit bis zu 3 Personen; größere Unternehmen benötigen eine Unternehmenslizenz.

Verwandte Skills