Communitygithub.com

tatacardona/Reels-FR-Doc-Juanes

Edita videos crudos de Futuros Residentes / Doc Juanes y los convierte en Reels verticales 9:16 dinámicos con Remotion: corta claquetas, tomas falsas, silencios, limpia el audio, añade subtítulos palabra por palabra con énfasis de color, cambia de plano en cada corte y, opcionalmente, agrega fotos superpuestas, emojis/stickers con efectos de sonido, destellos de luz y música libre de derechos. Funciona en Mac y Windows.

¿Qué es Reels-FR-Doc-Juanes?

This skill transforms raw footage from Futuros Residentes/Doc Juanes talking-head videos into dynamic 9:16 vertical Reels using Remotion. It automatically removes clapperboards, false takes, repetitions, and silences; cleans audio with DeepFilterNet; generates word-by-word captions with color emphasis that never obscure the speaker's face; changes camera angles with each cut; and optionally adds overlaid photos (even with a tearing effect), emojis or stickers with sound effects, light flashes on transitions, and royalty-free music. The workflow includes pre-processing (cropping, orientation, lighting curve), transcription and editorial mapping (with tools to re-transcribe problematic sections), and extensive editorial configuration via `edit-config.json`—allowing fine-grained control over emphasis words, idea-start capitalization, text fixes, brand word protection, photo/sticker placement, and transitions. It also calculates projected token consumption for each step and tracks actual usage to manage costs transparently. The skill is maintained exclusively by Janeth Cardona on GitHub, and all instructions emphasize clear Spanish communication with the requestor, who is likely non-technical.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Editar Reel de Futuros Residentes / Doc Juanes

Antes de decidir nada editorial, lee references/estilo.md: es el estilo aprobado y el porqué de cada regla. Si algo falla, revisa references/problemas.md: casi todo lo que puede salir mal ya pasó una vez. Para música, references/musica.md.

Cómo trabajar con quien pide el video

  • Escríbele en español, claro y sin jerga técnica. Puede que no programe: explícale qué ves y qué harás.
  • Antes de ejecutar, resume el plan de acción y espera su aprobación, siempre, en cada etapa (plan inicial, cada ronda de cambios, portadas, música). El resumen lleva dos criterios: el audiovisual (qué se hará, paso a paso) y el financiero: la proyección de consumo de tokens (ver "Consumo de tokens"). Puedes preparar y transcribir el crudo antes, para que el plan sea concreto.
  • Tú no puedes escuchar audio. Verifica con mediciones y re-transcripciones, y pídele que escuche lo subjetivo: efectos de sonido, volumen de la música y cortes muy apretados.
  • Muéstrale fotogramas y el MP4 en cada versión. Cuando pida un cambio, ubícalo en el segundo del video EDITADO que menciona (mapea con src/Reel/edit.json) y confirma qué frase es.
  • Marca: en el plan confirma si el video es de Doc Juanes o de Futuros Residentes (FR). Define la carpeta del proyecto y el espacio de Google Chat donde se avisa (Paso 9).
  • Nombres: en el plan propón (o pídele) un NOMBRE_CORTO en mayúsculas con guiones bajos (p. ej. JUANCHO_PASASTE); es también el nombre de la carpeta del proyecto.
    • Mientras se revisa: cada versión con número para que no vea una vieja ("no percibo cambios"): NOMBRE_CORTO_REEL_v2.mp4, NOMBRE_CORTO_PORTADA_1.jpg… En Descargas, solo la última versión.
    • Cuando apruebe la versión definitiva, renómbralos quitando todo lo demás, incluido el número: NOMBRE_CORTO_REEL.mp4 y NOMBRE_CORTO_PORTADA.jpg, y quita de Descargas las versiones y portadas descartadas.
    • Portada: en cuanto elija una, renómbrala de inmediato a NOMBRE_CORTO_PORTADA.jpg (sin número), en Descargas y en out/portadas/, aunque el video siga en revisión, y quita las demás opciones. Si después pide ajustes a la elegida, sobrescribe ese mismo archivo sin número.
    • Imágenes de prueba que le envías (fuentes, colores, luz, efectos, fotogramas de revisión): NOMBRE_CORTO_PRUEBA_<TEMA>_N.jpg (p. ej. NOMBRE_CORTO_PRUEBA_FUENTES_1.jpg). Al aprobar la versión definitiva, quítalas igual que las versiones descartadas: solo quedan el REEL y la PORTADA.
    • Nunca borres con rm archivos de la persona: usa ./scripts/papelera.sh <archivos> (Papelera del Mac o Papelera de reciclaje de Windows; se pueden recuperar).
  • Música: no todos los videos llevan; solo si la piden. Nunca repitas una canción ya usada (lista en references/musica.md), salvo que Janeth autorice reciclarla.
  • Los programas interactivos (como npx create-video) corren en una pestaña del panel Terminal: dile que haga clic en la pestaña y responda ahí, explicándole cada pregunta.

Quién puede cambiar este skill

El skill vive en GitHub (github.com/tatacardona/Reels-FR-Doc-Juanes) y solo Janeth Cardona lo modifica. Para saber en qué computador estás: git -C ~/.claude/skills/editar-reel-fr config user.email.

  • Si responde [email protected] (computador de Janeth): antes de cambiar el skill, pregúntale siempre y espera su sí; dile en una línea qué cambiarías y por qué sirve para todos los videos (si ella misma pide el cambio, ya está aprobado). Lo puntual de un video (canción, tiempos, posiciones, volúmenes) va solo en su proyecto, nunca en el skill. Después de cambiarlo: git -C ~/.claude/skills/editar-reel-fr add -A && git commit -m "<qué cambió>" && git push.
  • En cualquier otro computador: nunca modifiques los archivos del skill. Si descubres una mejora o un problema que sirve para todos, dile a la persona que se lo cuente a Janeth y escríbele el texto para enviárselo (qué pasó, en qué video y qué propones).
  • Las canciones usadas se anotan en references/musica.md; en otros computadores, pásale a Janeth el título, artista y enlace para que lo agregue.

Consumo de tokens (las cuentas son compartidas por todo el equipo)

Cada paso de Claude relee toda la conversación: eso es casi todo el costo y crece con su largo. Por eso:

  • Una conversación nueva por video. Al aprobar un video, sugiere abrir una conversación nueva para el siguiente. Seguir en la misma puede costar 2-3 veces más.
  • Cambios en lote: pide que junte todas sus correcciones en un solo mensaje numerado, y aplícalas en una sola exportación.
  • Lee poco y pequeño: tiras de fotogramas reducidas (SCALE=0.25-0.35), solo la parte necesaria de archivos y salidas (tail, grep), re-transcribe solo el tramo en duda. Las imágenes grandes cuestan.
  • Esperas sin preguntar: las exportaciones largas van en segundo plano; no revises cada minuto.
  • Sin pasos que no se pidieron: stickers, música, fondo con IA o búsquedas extra solo si los piden.

Proyección en cada plan (cifras medidas en videos reales de 30-45 s; costo a tarifa pública de la API con Claude Opus 5.5, en una conversación nueva). Muestra una tabla corta con los pasos del plan, su rango y el total, y aclara que es aproximado:

EtapaPasos de ClaudeCosto aprox.
Preparar, transcribir y presentar el plan15-25US$ 1-2
Propuestas visuales (fuentes, color, luz) con muestras8-15US$ 1-1,5
Armar la edición, texto para aprobar y exportar la v120-35US$ 2-3
Cada ronda de cambios + nueva exportación10-25US$ 1-2,5
Buscar y ajustar música10-20US$ 1-2
3 portadas8-15US$ 1-1,5
Video completo típico (plan, v1, 2 rondas, portadas)80-130US$ 7-12

Con plan Team/Enterprise la factura puede ser distinta; la cifra sirve para comparar opciones. Si la persona quiere ahorrar, ofrécele alternativas concretas (menos rondas, sin música, sin portadas nuevas, o usar un modelo más económico para un video sencillo); la decisión es suya. Al cerrar cada video, mide el consumo real con python3 scripts/consumo.py --desde "<texto del primer mensaje del video>" y compártelo junto a la proyección. Si la diferencia es grande y estás en el computador de Janeth, propón ajustar esta tabla.

Paso 0: Herramientas (una vez por máquina) y actualizar el skill

git -C ~/.claude/skills/editar-reel-fr pull -q        # trae la última versión del skill (cada video)
source ~/.claude/skills/editar-reel-fr/scripts/setup-tools.sh   # exporta $PY, $FF, $PROYECTOS, $DESCARGAS

Instala ffmpeg completo, faster-whisper, DeepFilterNet (quita eco) y OpenCV en un entorno propio. La primera transcripción descarga el modelo large-v3-turbo (~1,6 GB): pide permiso antes.

  • Mac: necesita Node.js y Python 3 (vienen con las herramientas de Xcode o se instalan una vez).
  • Windows: Claude Code usa Git Bash, y estos programas corren ahí. Antes, una sola vez, instala Python 3.11 y Node.js LTS (winget install Python.Python.3.11 y winget install OpenJS.NodeJS.LTS, con permiso de la persona; Python 3.12 o más nuevo no sirve). Si algo falla en Windows, mira references/problemas.md y cuéntaselo a Janeth.

Paso 1: Proyecto Remotion

  • Proyectos en $PROYECTOS/<MARCA>/NOMBRE_CORTO, con <MARCA> = Doc Juanes o FR (Mac: Películas → Reels Doc Juanes; Windows: Videos → Reels Doc Juanes), uno por video. Proyectos anteriores para copiar: en esas dos subcarpetas.
  • Lo más rápido: copia package.json, package-lock.json, tsconfig.json, remotion.config.ts, src/index.ts, src/index.css y src/Root.tsx de un proyecto anterior, y node_modules (Mac: cp -c -R, clon instantáneo; Windows: npm ci). Sin proyecto previo: npx create-video@latest (Blank, Tailwind Yes), npm i y npm i @remotion/google-fonts@<versión de remotion>.
  • Plantilla y scripts: cp -R ~/.claude/skills/editar-reel-fr/assets/template/src/Reel src/Reel y mkdir -p scripts && cp ~/.claude/skills/editar-reel-fr/scripts/* scripts/.
  • Registra la composición (ver assets/template/Root.snippet.tsx) y "resolveJsonModule": true.

Paso 2: Preparar el crudo

  1. Extrae un fotograma ("$FF" -ss 20 -i crudo -frames:v 1 x.jpg) y míralo: orientación (si la persona sale de lado usa ccw/cw), color de la pared (decide el color de las palabras clave) y posición de la cara (FACE_ORIGIN).
  2. FF="$FF" ./scripts/prep.sh "<crudo>" <none|ccw|cw> → public/video-vertical.mp4 (con la curva de iluminación que aclara sombras; LIGHT=0 la quita) + audios en work/.
  3. Si pide mejorar el fondo o la luz (fondo cargado, cara oscura por luz de arriba): scripts/fondo-luz.py separa a la persona con IA y crea public/video-fondo.mp4 con fondo difuminado, luz de relleno que sigue la cara y, si se quiere, luces de colores tipo vitral en la pared. Ajustes en edit-config.json → "fondo" (ver el encabezado del script); se corre después de build-edit.py (solo procesa los tramos usados; vuelve a correrlo si cambian los tramos, o esos cuadros saldrán sin procesar) y se activa con VIDEO_SRC = "video-fondo.mp4". Muéstrale antes un fotograma de prueba. El estilo lo prefiere sutil: desenfoque leve (5), borde muy suave (14) y vitral/bokeh muy tenues.

Paso 3: Transcribir y mapear

"$PY" scripts/transcribe.py          # frases con tiempos → work/transcript.json
"$PY" scripts/energy.py words        # volumen de cada palabra vs. su frase (+dB = énfasis)

Arma el mapa editorial y cuéntaselo en una lista corta:

  • Fuera: claqueta ("Listo, guion N…"), tomas falsas ("otra vez", groserías, risas), frases repetidas (quédate con la toma más limpia; suele ser la última), arranques en falso, cierre ("listo").
  • Gancho: la primera frase fuerte; va primero.
  • Palabras estiradas (p. ej. "no" de 3 s), palabras raras o voz sin transcribir = tomas repetidas o arranques en falso: re-transcribe esos tramos aislados (WhisperModel sobre el pedazo de audio) y afina con energy.py zoom <inicio> <fin>.
  • Si el guion tiene un dato equivocado (una cifra mal dicha), propón cortarlo; nunca imites la voz con IA.

Paso 4: Audio

FF="$FF" PY="$PY" ./scripts/audio.sh   # voz con menos eco y natural (DeepFilterNet + expansor suave, −14 LUFS)
"$PY" scripts/energy.py                # mide sobre la voz limpia → cortes más apretados
"$PY" scripts/sfx-stickers.py          # solo si habrá stickers con sonido
"$PY" scripts/sfx-tear.py              # solo si habrá foto rasgándose

Paso 5: edit-config.json: las decisiones editoriales

Base: assets/edit-config.example.json. Todos los tiempos en segundos del video CRUDO:

  • clips: un tramo por frase o idea, en orden, con margen amplio. El script recorta los silencios dentro y fuera, sin cortar nunca una palabra. fx: punch (continuación), whoosh (cambio de tema), leak (destello de luz de sol con colores; para videos inspiradores, ver estilo.md), flash (destello blanco). zoom fija el plano de un tramo; steps: [[seg, zoom], …] es una escalera de planos sin cortar el audio. hold_zoom: true = un solo plano. tail: 0.1 = margen extra al final del tramo si el corte se come una consonante final suave.
  • emphasis: [palabra, segundo] de las palabras dichas con fuerza o clave (~1 cada 1,5-2 s).
  • word_fixes: tiempos reales de una palabra. Después confirma que quedó DENTRO del tramo (si cae en el silencio previo, desaparece del subtítulo).
  • idea_start: mayúscula de inicio de idea (afecta a toda palabra a < 0,1 s: si la siguiente está muy cerca, como "Y no", usa un tiempo justo antes de la primera).
  • text_fixes: [{"at": seg, "text": "pregunta:"}] texto exacto de una palabra (p. ej. conservar ":").
  • brand_words (protege "Futuros Residentes", "Doc Juanes"; agrega otras como "UdeA"), small_extra (palabras cortas que nunca van solas: "fue", "esa", "mi", "tan"…).
  • photos: {src, show_at, tear_at} (se rasga) o {src, show_at, hide_at}.
  • stickers (solo si los pide; ejemplo en assets/edit-config.stickers.example.json): {kind, show_at, hide_at, x, y, size, sfx: [[archivo, seg, volumen]]}. Tipos: broken-heart (break_at) y dibujos de ART en src/Reel/Stickers.tsx. Para uno nuevo, dibújalo como SVG propio (nunca emojis de Apple ni imágenes con derechos). Ponlos donde la persona mueve las manos (mira fotogramas), nunca sobre la cara ni los subtítulos. Si un efecto debe seguir la cabeza, "$PY" scripts/head-track.py <inicio> <fin> + follow_head: true dan su posición cuadro a cuadro (track).
  • sounds: [[archivo, seg, volumen, desfase_seg]]; shakes: segundos con sacudida (impactos).
  • end_push: {at, to}: cierre por defecto, acercamiento suave a la cara (~1,6) sin fundido a negro. end_hold: segundos extra al final.
  • speed: si pide acelerar (ver Paso 7).
  • Fuente base (palabras normales): Montserrat Black 900, blanca con borde negro, salvo que la marca del video pida otra (p. ej. videos de Futuros Residentes con la fuente de su página web).
  • Palabras resaltadas: propónselas en el plan según el mood del video, con 2-3 opciones sobre un fotograma real: una sola fuente o dos fuentes (p. ej. una elegante/serif para lo emotivo y una gordita para lo de impacto), con el mismo color o colores distintos. Fuentes y colores acordes al mood (inspirador, nostálgico, enérgico, cómico…). EMPH_* (primera) y EMPH2_* (segunda, palabras marcadas "alt" en emphasis) en constants.ts. El color debe contrastar con la pared.
  • echo: [[inicio, fin]] eco suave en una frase de trascendencia (después: "$PY" scripts/eco.py). Proponlo si detectas una frase así, o aplícalo si lo piden.

…

[truncado para la traducción]

Skills relacionados