Communitygithub.com

tatacardona/Reels-FR-Doc-Juanes

Bearbeitet Rohvideos von Futuros Residentes / Doc Juanes (Person spricht in die Kamera, aufgenommene Skripte) und wandelt sie in dynamische 9:16-Reels mit Remotion um. Entfernt Klappen, Fehlaufnahmen, Wiederholungen und Stille, reinigt das Audio, fügt wortweise Untertitel mit farblicher Hervorhebung hinzu (die nie das Gesicht verdecken), wechselt die Einstellung bei jedem Schnitt und fügt auf Wunsch überlagerte Fotos (auch mit Zerreißeffekt), Emojis/Sticker mit Soundeffekten, Lichtblitze an den Übergängen und lizenzfreie Musik hinzu. Funktioniert auf Mac und Windows.

Was ist Reels-FR-Doc-Juanes?

Diese Fähigkeit (Skill) ist ein spezialisierter Remotion-basierter Videobearbeitungs-Workflow für die YouTube-Kanäle 'Futuros Residentes' und 'Doc Juanes'. Sie automatisiert die Umwandlung von unbearbeiteten Talking-Head-Aufnahmen und geskripteten Aufzeichnungen in vertikale 9:16-Kurzfilme (Reels, Shorts, TikTok). Die Kernfunktionen umfassen: automatische Entfernung von Klappen, Fehlaufnahmen, Wiederholungen und Stille; wortgenaue Transkription; automatische Hervorhebung betonter Wörter mit einer an die Wandfarbe angepassten Farbe; intelligente Kameraschnitte auf Basis jedes Clips; und optionale Effekte wie überlagerte Fotos (mit Zerreißeffekt), Emoji-Sticker mit Soundeffekten und lizenzfreie Musik. Der Skill arbeitet auf Mac und Windows, ist perfekt auf den spezifischen Stil der YouTube-Kanäle abgestimmt und kann jederzeit verwendet werden, wenn jemand ein Rohvideo, ein 'Skript N', oder eine Aufnahme von Doc Juanes oder Futuros Residentes erwähnt oder darum bittet, ein Video für Instagram/TikTok/Reels/Shorts zu bearbeiten, zu schneiden, zu untertiteln oder vorzubereiten. Der Skill enthält detaillierte Projektmanagement-Anweisungen, wie z. B. dass vor jeder Ausführung ein Aktionsplan zur Genehmigung vorgelegt werden muss, sowie Richtlinien zur Kostenschätzung auf Basis des Tokenverbrauchs, um Benutzer über die API-Kosten aufzuklären.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add tatacardona/Reels-FR-Doc-Juanes

In Ihrer bevorzugten KI fragen

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

Dokumentation

Reel von Futuros Residentes / Doc Juanes bearbeiten

Bevor du redaktionelle Entscheidungen triffst, lies references/estilo.md: es enthält den genehmigten Stil und die Begründung für jede Regel. Wenn etwas schiefgeht, lies references/problemas.md: fast alles, was schiefgehen kann, ist bereits einmal passiert. Für Musik, siehe references/musica.md.

So arbeitest du mit der Person, die das Video anfordert

  • Schreibe ihr auf Spanisch, klar und ohne Fachjargon. Sie programmiert möglicherweise nicht: erkläre ihr, was du siehst und was du tun wirst.
  • Fasse vor der Ausführung den Aktionsplan zusammen und warte auf ihre Genehmigung, immer, in jeder Phase (erster Plan, jede Änderungsrunde, Cover, Musik). Die Zusammenfassung enthält zwei Kriterien: das audiovisuelle (was Schritt für Schritt gemacht wird) und das finanzielle: die Prognose des Tokenverbrauchs (siehe "Tokenverbrauch"). Du kannst das Rohmaterial vorher vorbereiten und transkribieren, damit der Plan konkret ist.
  • Du kannst kein Audio hören. Überprüfe mit Messungen und Neutranskriptionen, und bitte sie, subjektive Aspekte zu hören: Soundeffekte, Lautstärke der Musik und sehr enge Schnitte.
  • Zeige ihr Einzelbilder und die MP4-Datei in jeder Version. Wenn sie eine Änderung wünscht, lokalisiere sie anhand der Sekunde des BEARBEITETEN Videos, die sie nennt (kartiere mit src/Reel/edit.json) und bestätige, um welchen Satz es sich handelt.
  • Marke: Bestätige im Plan, ob das Video von Doc Juanes oder von Futuros Residentes (FR) ist. Definiere den Projektordner und den Google Chat-Raum, in dem Bescheid gegeben wird (Schritt 9).
  • Namen: Schlage im Plan einen KURZNAMEN in Großbuchstaben mit Unterstrichen vor (z. B. JUANCHO_PASASTE); dies ist auch der Name des Projektordners.
    • Während der Überprüfung: jede Version mit einer Nummer, damit sie keine alte sieht ("ich nehme keine Änderungen wahr"): KURZNAME_REEL_v2.mp4, KURZNAME_PORTADA_1.jpg…. Im Download-Ordner nur die neueste Version.
    • Wenn sie die endgültige Version genehmigt hat, benenne sie um, indem du alles andere, einschließlich der Nummer, entfernst: KURZNAME_REEL.mp4 und KURZNAME_PORTADA.jpg, und entferne die verworfenen Versionen und Cover aus dem Download-Ordner.
    • Cover: Sobald sie eines ausgewählt hat, benenne es sofort in KURZNAME_PORTADA.jpg um (ohne Nummer), im Download-Ordner und in out/portadas/, auch wenn das Video noch in Überprüfung ist, und entferne die anderen Optionen. Wenn sie später Anpassungen am ausgewählten Cover wünscht, überschreibe dieselbe Datei ohne Nummer.
    • Testbilder, die du ihr sendest (Schriftarten, Farben, Licht, Effekte, Überprüfungs-Einzelbilder): KURZNAME_PRUEBA_<THEMA>_N.jpg (z. B. KURZNAME_PRUEBA_FUENTES_1.jpg). Nach Genehmigung der endgültigen Version entferne sie genauso wie die verworfenen Versionen: es bleiben nur das REEL und das COVER übrig.
    • Lösche niemals mit rm Dateien der Person: verwende ./scripts/papelera.sh <dateien> (Papierkorb des Mac oder Windows Papierkorb; sie können wiederhergestellt werden).
  • Musik: Nicht alle Videos haben welche; nur wenn sie darum bitten. Verwende niemals einen bereits verwendeten Song (Liste in references/musica.md), es sei denn, Janeth genehmigt das Recycling.
  • Interaktive Programme (wie npx create-video) laufen in einem Tab des Terminal-Bereichs: sage ihr, sie solle auf den Tab klicken und dort antworten, und erkläre ihr jede Frage.

Wer diesen Skill ändern darf

Der Skill lebt auf GitHub (github.com/tatacardona/Reels-FR-Doc-Juanes) und nur Janeth Cardona ändert ihn. Um herauszufinden, auf welchem Computer du dich befindest: git -C ~/.claude/skills/editar-reel-fr config user.email.

  • Wenn [email protected] (Janeths Computer) antwortet: frage sie immer, bevor du den Skill änderst und warte auf ihr Ja; teile ihr in einer Zeile mit, was du ändern würdest und warum es für alle Videos nützlich ist (wenn sie selbst die Änderung anfordert, ist sie bereits genehmigt). Videospezifisches (Song, Zeiten, Positionen, Lautstärken) gehört nur in das jeweilige Projekt, niemals in den Skill. Nach der Änderung: git -C ~/.claude/skills/editar-reel-fr add -A && git commit -m "<was geändert wurde>" && git push.
  • Auf jedem anderen Computer: Ändere niemals die Dateien des Skills. Wenn du eine Verbesserung oder ein Problem entdeckst, das für alle nützlich ist, sage der Person, sie solle es Janeth mitteilen, und schreibe ihr den Text, den sie senden soll (was passiert ist, in welchem Video und was du vorschlägst).
  • Die verwendeten Songs werden in references/musica.md notiert; auf anderen Computern leite Janeth den Titel, Interpreten und Link weiter, damit sie ihn hinzufügen kann.

Tokenverbrauch (die Konten werden vom gesamten Team gemeinsam genutzt)

Jeder Schritt von Claude liest das gesamte Gespräch erneut: das ist fast der gesamte Kostenpunkt und wächst mit der Länge des Gesprächs. Daher:

  • Ein neues Gespräch pro Video. Nach Genehmigung eines Videos schlage vor, ein neues Gespräch für das nächste zu beginnen. Im selben Gespräch weiterzumachen, kann 2-3 Mal mehr kosten.
  • Stapelweise Änderungen: Bitte darum, alle Korrekturen in einer einzigen nummerierten Nachricht zu sammeln, und wende sie in einem einzigen Export an.
  • Lies wenig und klein: reduzierte Bildstreifen (SCALE=0.25-0.35), nur den notwendigen Teil von Dateien und Ausgaben (tail, grep), transkribiere nur den fraglichen Abschnitt neu. Große Bilder kosten.
  • Wartezeiten ohne Nachfragen: Lange Exporte laufen im Hintergrund; überprüfe nicht jede Minute.
  • Keine Schritte, die nicht angefordert wurden: Sticker, Musik, KI-Hintergrund oder zusätzliche Suchanfragen nur, wenn sie angefordert werden.

Prognose in jedem Plan (Zahlen gemessen an echten Videos von 30-45 s; Kosten zum öffentlichen API-Tarif mit Claude Opus 5.5, in einem neuen Gespräch). Zeige eine kurze Tabelle mit den Schritten des Plans, ihrer Spanne und der Gesamtsumme, und stelle klar, dass es sich um eine Näherung handelt:

PhaseClaude-SchritteUngefähre Kosten
Vorbereiten, transkribieren und Plan vorlegen15-25US$ 1-2
Visuelle Vorschläge (Schriftarten, Farbe, Licht) mit Mustern8-15US$ 1-1,5
Bearbeitung zusammenstellen, Text zur Genehmigung und v1 exportieren20-35US$ 2-3
Jede Änderungsrunde + neuer Export10-25US$ 1-2,5
Musik suchen und anpassen10-20US$ 1-2
3 Cover8-15US$ 1-1,5
Typisches komplettes Video (Plan, v1, 2 Runden, Cover)80-130US$ 7-12

Mit einem Team/Enterprise-Plan kann die Rechnung anders ausfallen; die Zahl dient zum Vergleich der Optionen. Wenn die Person sparen möchte, biete konkrete Alternativen an (weniger Runden, ohne Musik, ohne neue Cover, oder Verwendung eines günstigeren Modells für ein einfaches Video); die Entscheidung liegt bei ihr. Beim Abschluss jedes Videos, messe den tatsächlichen Verbrauch mit python3 scripts/consumo.py --desde "<text der ersten nachricht des videos>" und teile ihn zusammen mit der Prognose. Wenn die Abweichung groß ist und du dich auf Janeths Computer befindest, schlage vor, diese Tabelle anzupassen.

Schritt 0: Werkzeuge (einmal pro Maschine) und Skill aktualisieren

git -C ~/.claude/skills/editar-reel-fr pull -q        # zieht die neueste Skill-Version (jedes Video)
source ~/.claude/skills/editar-reel-fr/scripts/setup-tools.sh   # exportiert $PY, $FF, $PROYECTOS, $DESCARGAS

Installiere vollständiges ffmpeg, faster-whisper, DeepFilterNet (entfernt Echo) und OpenCV in einer eigenen Umgebung. Die erste Transkription lädt das Modell large-v3-turbo herunter (~1,6 GB): frage vorher um Erlaubnis.

  • Mac: Benötigt Node.js und Python 3 (sind in den Xcode-Tools enthalten oder werden einmal installiert).
  • Windows: Claude Code verwendet Git Bash, und diese Programme laufen dort. Vorher, einmalig, installiere Python 3.11 und Node.js LTS (winget install Python.Python.3.11 und winget install OpenJS.NodeJS.LTS, mit Erlaubnis der Person; Python 3.12 oder neuer funktioniert nicht). Wenn unter Windows etwas fehlschlägt, siehe references/problemas.md und berichte Janeth.

Schritt 1: Remotion-Projekt

  • Projekte in $PROYECTOS/<MARKE>/KURZNAME, mit <MARKE> = Doc Juanes oder FR (Mac: Filme → Reels Doc Juanes; Windows: Videos → Reels Doc Juanes), eines pro Video. Vorherige Projekte zum Kopieren: in diesen zwei Unterordnern.
  • Am schnellsten: kopiere package.json, package-lock.json, tsconfig.json, remotion.config.ts, src/index.ts, src/index.css und src/Root.tsx aus einem vorherigen Projekt, und node_modules (Mac: cp -c -R, sofortiger Klon; Windows: npm ci). Ohne vorheriges Projekt: npx create-video@latest (Blank, Tailwind Yes), npm i und npm i @remotion/google-fonts@<remotion-version>.
  • Vorlage und Skripte: cp -R ~/.claude/skills/editar-reel-fr/assets/template/src/Reel src/Reel und mkdir -p scripts && cp ~/.claude/skills/editar-reel-fr/scripts/* scripts/.
  • Registriere die Komposition (siehe assets/template/Root.snippet.tsx) und "resolveJsonModule": true.

Schritt 2: Rohmaterial vorbereiten

  1. Extrahiere ein Einzelbild ("$FF" -ss 20 -i rohmaterial -frames:v 1 x.jpg) und betrachte es: Ausrichtung (wenn die Person seitlich ist, verwende ccw/cw), Wandfarbe (entscheidet die Farbe der Schlüsselwörter) und Position des Gesichts (FACE_ORIGIN).
  2. FF="$FF" ./scripts/prep.sh "<rohmaterial>" <none|ccw|cw> → public/video-vertical.mp4 (mit der Beleuchtungskurve, die Schatten aufhellt; LIGHT=0 entfernt sie) + Audios in work/.
  3. Wenn eine Verbesserung des Hintergrunds oder des Lichts gewünscht wird (unruhiger Hintergrund, dunkles Gesicht durch Licht von oben): scripts/fondo-luz.py trennt die Person mit KI und erstellt public/video-fondo.mp4 mit unscharfem Hintergrund, Fülllicht, das dem Gesicht folgt, und, wenn gewünscht, farbigen Lichteffekten wie Buntglas an der Wand. Anpassungen in edit-config.json → "fondo" (siehe Kopf des Skripts); wird nach build-edit.py ausgeführt (verarbeitet nur die verwendeten Abschnitte; führe es erneut aus, wenn sich die Abschnitte ändern, da diese Bilder sonst unverarbeitet bleiben) und mit VIDEO_SRC = "video-fondo.mp4" aktiviert. Zeige vorher ein Testbild. Der Stil wird bevorzugt dezent: leichte Unschärfe (5), sehr weicher Rand (14) und sehr zartes Buntglas/Bokeh.

Schritt 3: Transkribieren und zuordnen

"$PY" scripts/transcribe.py          # Sätze mit Zeiten → work/transcript.json
"$PY" scripts/energy.py words        # Lautstärke jedes Wortes im Vergleich zu seinem Satz (+dB = Betonung)

Erstelle die redaktionelle Karte und teile sie in einer kurzen Liste mit:

  • Entfernt: Klappe ("Bereit, Skript N…"), Fehlaufnahmen ("nochmal", Schimpfwörter, Lachen), wiederholte Sätze (behalte die sauberste Aufnahme; normalerweise die letzte), Fehlstarts, Schluss ("fertig").
  • Hook: der erste starke Satz; kommt zuerst.
  • Gedehnte Wörter (z. B. "nein" von 3 s), seltsame Wörter oder nicht transkribierte Stimme = wiederholte Aufnahmen oder Fehlstarts: transkribiere diese isolierten Abschnitte neu (WhisperModel über das Audio-Stück) und verfeinere mit energy.py zoom <start> <ende>.
  • Wenn das Skript einen falschen Datenpunkt enthält (eine falsch ausgesprochene Zahl), schlage vor, ihn zu schneiden; imitiere niemals die Stimme mit KI.

Schritt 4: Audio

FF="$FF" PY="$PY" ./scripts/audio.sh   # Stimme mit weniger Echo und natürlicher (DeepFilterNet + sanfter Expander, −14 LUFS)
"$PY" scripts/energy.py                # misst an der sauberen Stimme → engere Schnitte
"$PY" scripts/sfx-stickers.py          # nur, wenn es Sticker mit Sound geben wird
"$PY" scripts/sfx-tear.py              # nur, wenn es ein zerreißendes Foto geben wird

Schritt 5: edit-config.json: die redaktionellen Entscheidungen

Basis: assets/edit-config.example.json. Alle Zeiten in Sekunden des ROHVIDEOS:

  • clips: ein Abschnitt pro Satz oder Idee, in Reihenfolge, mit großzügigem Rand. Das Skript schneidet die Stille innen und außen ab, ohne jemals ein Wort zu beschneiden. fx: punch (Fortsetzung), whoosh (Themenwechsel), leak (Sonnenlichtblitz mit Farben; für inspirierende Videos, siehe estilo.md), flash (weißer Blitz). zoom legt die Einstellung eines Abschnitts fest; steps: [[sek, zoom], …] ist eine Leiter von Einstellungen ohne Audio-Schnitt. hold_zoom: true = eine einzige Einstellung. tail: 0.1 = zusätzlicher Rand am Ende des Abschnitts, wenn der Schnitt einen weichen Endkonsonanten verschluckt.
  • emphasis: [wort, sekunde] der stark oder wichtig ausgesprochenen Wörter (~1 pro 1,5-2 s).
  • word_fixes: tatsächliche Zeiten eines Wortes. Bestätige danach, dass es INNERHALB des Abschnitts liegt (wenn es in die vorherige Stille fällt, verschwindet es aus dem Untertitel).
  • idea_start: Großbuchstabe zu Beginn einer Idee (betrifft jedes Wort < 0,1 s: wenn das nächste sehr nah ist, wie "Y no", verwende eine Zeit direkt vor dem ersten).
  • text_fixes: [{"at": sek, "text": "frage:"}] genauer Text eines Wortes (z. B. ":" beibehalten).
  • brand_words (schützt "Futuros Residentes", "Doc Juanes"; füge andere wie "UdeA" hinzu), small_extra (kurze Wörter, die nie allein stehen: "fue", "esa", "mi", "tan"…).
  • photos: {src, show_at, tear_at} (zerreißt) oder {src, show_at, hide_at}.
  • stickers (nur wenn gewünscht; Beispiel in assets/edit-config.stickers.example.json): {kind, show_at, hide_at, x, y, size, sfx: [[datei, sek, lautstärke]]}. Typen: broken-heart (break_at) und Zeichnungen von ART in src/Reel/Stickers.tsx. Für einen neuen, zeichne ihn als eigenes SVG (niemals Apple-Emojis oder urheberrechtlich geschützte Bilder). Platziere sie dort, wo die Person ihre Hände bewegt (betrachte Einzelbilder), niemals über dem Gesicht oder den Untertiteln. Wenn ein Effekt dem Kopf folgen soll, "$PY" scripts/head-track.py <start> <ende> + follow_head: true geben seine Position bildweise (track).
  • sounds: [[datei, sek, lautstärke, versatz_sek]]; shakes: Sekunden mit Erschütterung (Einschläge).
  • end_push: {at, to}: Standard-Schluss, sanfte Annäherung an das Gesicht (~1,6) ohne Schwarzblende. end_hold: zusätzliche Sekunden am Ende.
  • speed: wenn eine Beschleunigung gewünscht wird (siehe Schritt 7).
  • Basisschriftart (normale Wörter): Montserrat Black 900, weiß mit schwarzem Rand, es sei denn, die Marke des Videos verlangt eine andere (z. B. Videos von Futuros Residentes mit der Schriftart ihrer Website).
  • Hervorgehobene Wörter: schlage sie im Plan basierend auf der Stimmung des Videos vor, mit 2-3 Optionen auf einem echten Einzelbild: eine Schriftart oder zwei Schriftarten (z. B. eine elegante/Serif für Emotionen und eine fette für Impact), mit derselben Farbe oder unterschiedlichen Farben. Schriftarten und Farben passend zur Stimmung (inspirierend, nostalgisch, energisch, komisch…). EMPH_* (erste) und EMPH2_* (zweite, Wörter markiert mit "alt" in emphasis) in constants.ts. Die Farbe muss mit der Wand kontrastieren.
  • echo: [[start, ende]] weiches Echo in einem bedeutungsvollen Satz (danach: "$PY" scripts/eco.py). Schlage es vor, wenn du einen solchen Satz erkennst, oder wende es an, wenn es gewünscht wird.

…

[gekürzt für die Übersetzung]

Verwandte Skills