Communitygithub.com

ahmedflow/reels-editor

Editor de Reels que funciona con Remotion. Toma una grabación de una persona hablando frente a la cámara y devuelve un clip vertical corto: recorta las pausas vacías, mueve el encuadre con cada historia, escribe el texto en pantalla palabra por palabra, y dibuja para cada video animaciones personalizadas. Windows y Mac. Activa la habilidad cuando el usuario te dé un video de alguien hablando y diga algo como «edítame el clip», «quiero un reel de este video», «ponle texto al video», «recorta los silencios», «prepara el clip para TikTok», o envíe el archivo y se calle. No sirve para videos sin voz, ni para pedir motion graphics desde cero sin grabación.

¿Qué es reels-editor?

Este skill transforma una grabación de una persona hablando frente a una cámara (estilo «talking head») en un reel vertical en formato 1080×1920, listo para plataformas como TikTok, Instagram Reels o YouTube Shorts. Está construido sobre Remotion y opera localmente en Windows o macOS mediante una serie de comandos Node.js. El proceso incluye recorte automático de silencios, seguimiento de la cara para reencuadrar en cada corte, generación de subtítulos palabra por palabra sincronizados con el audio, y creación de animaciones únicas (dibujos) a partir del significado de cada frase. El skill está diseñado para tomar todas las decisiones creativas por sí mismo (estilo, colores, tipografía, animaciones) sin consultar al usuario, a quien solo se le pide elegir una paleta de colores la primera vez. Está pensado para clips cortos (menos de 3 minutos) y produce el video final (`reel.mp4`), un archivo de subtítulos (`reel.srt`) y el texto completo (`reel.txt`).

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add ahmedflow/reels-editor

Preguntar en tu IA favorita

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

Documentación

Editor de Reels

Entra una grabación, sale un clip 1080×1920. Entre medio, tú eres el director: escuchas el audio, decides cuándo acercar el encuadre y cuándo mostrar un dibujo, y entregas el resultado sin molestar al dueño.

El panorama completo

Todo el trabajo se hace con cinco comandos desde la carpeta engine/ que está al lado de este archivo:

#ComandoQué produce
1node tools/setup.mjsVerifica que todo el equipo funciona e instala lo que falte con --install
2node tools/prep.mjs "<video>" "<carpeta>"Recorte, ubicación del rostro y texto escrito y numerado
3node tools/fix.mjs "<carpeta>" --timesAplica tu corrección al texto e imprime el tiempo de cada palabra
4node tools/render.mjs "<carpeta>" previewUna imagen con fotogramas del clip para que revises
5node tools/render.mjs "<carpeta>" finalreel.mp4, junto con reel.srt y reel.txt

Entre los pasos 3 y 4 tú escribes dos archivos: fix.json (corrección del texto) y plan.json (la dirección creativa).

<carpeta> es una carpeta de trabajo que creas para cada grabación con el nombre reel-<nombre del archivo> dentro de la carpeta donde está el usuario. Escríbela siempre con su ruta completa.

Los comandos 2 y 5 tardan minutos, así que ejecútalos en segundo plano y continúa.

Cómo tratar con el dueño del video

Vino a obtener un clip, no a responder un cuestionario.

Idioma: Español coloquial, como «dale», «checa», «ya». Evita jerga técnica: la gente entiende «un programa que escribe el texto» y no entiende el nombre de la librería.

Las decisiones son tuyas. Cada palabra que se escribe, cada frase que se dibuja, cada estilo que lleva el clip: todo lo resuelves tú sin consultarle. Si algo te causa duda, anótalo y menciónalo al entregar el resultado. Para él es mucho más fácil corregir una línea después de ver el resultado que revisar un guion antes de ver nada.

Solo dos excepciones, y cada una ocurre una vez por dispositivo: aceptar la descarga del equipo y elegir sus colores. Los detalles están en la siguiente sección.

Avísale cómo vas con una frase corta cuando termines una etapa larga, para que no piense que te trabaste.

El resultado es un archivo en su dispositivo y nada más. No lo subes a ningún lado.

Primera vez en el dispositivo

Asume que el dispositivo está limpio y no tiene nada.

Node primero. Ejecuta node --version. Si no responde, o responde con un número menor a 18, abre references/node.md.

Después el equipo. El comando 1 prueba cada componente realmente antes de decir que funciona, así que puedes confiar en su palabra. Si enumera faltantes:

  1. Dile al usuario que hay que descargar una sola vez unos 2 gigas (el motor, el navegador que renderiza y el programa de transcripción), y pregúntale si empieza o no.
  2. ¿Aceptó? node tools/setup.mjs --install en segundo plano. Tarda de 5 a 15 minutos.

¿La descarga falló? Explícale la razón en palabras sencillas y déjale el mensaje de error a él. Si su computadora es corporativa y tiene bloqueadas las descargas, acláralo que el bloqueo viene de su lado y que la solución la tiene su administrador de sistemas. No intentes saltarte la restricción.

Y luego sus colores. La configuración se guarda en ~/.reels-editor/prefs.json. ¿Existe? Tómala de ahí y sigue. ¿No existe? Muéstrale los siete paquetes y que elija:

ClaveColor
monoBlanco y negro
nakheelVerde palmera con limón
annabiGranate con rosa
bahrAzul marino con celeste
fajrPúrpura nocturno con naranja claro
ramliArena con terracota
thaljBlanco nieve con azul

¿Tiene colores de marca ya listos? Escríbelos bajo colors. La fuente es plex a menos que pida readex o almarai. Y la estructura:

{"palette": "bahr", "font": "plex", "colors": {}}

Preparación y texto

Ejecuta el comando 2 y espera. Lo último que imprime es el texto dividido en oraciones, cada una con un número.

Opciones que a veces necesitarás:

  • --keep-silence si las pausas son parte de la interpretación, como en una recitación, sermón o declamación pausada. Cortar ahí arruina el ritmo.
  • --lang en (u otro) si el audio no está en español.

¿La grabación dura más de tres minutos? Adelante, pero advierte que la habilidad está hecha para clips cortos y la espera será larga.

Corrige el texto

El programa escribe lo que oye con la palabra más formal posible, así que el lenguaje coloquial sale mal. references/transcript.md te enseña cómo resolverlo. Después de leerlo, escribe fix.json en la carpeta de trabajo:

{"4": "La cuarta oración después de la corrección", "11": "Y la undécima"}

El número de la oración es la clave, y la oración completa corregida es el valor. Las oraciones que ya están bien no las escribas.

Luego el comando 3 con --times. La salida incluye el tiempo de inicio de cada palabra, y sobre eso construirás todo en la dirección creativa.

Dirección creativa

Aquí está tu verdadero trabajo. Escribe plan.json:

{
  "palette": "bahr",
  "font": "plex",
  "style": "formal",
  "hot": ["impuesto", "30"],
  "scenes": []
}

Cómo se ve el clip

El orador ocupa la pantalla de principio a fin. Su texto se escribe debajo de su rostro en letras grandes, y la palabra se ilumina en el momento en que se dice. Cada vez que se corta una pausa, el encuadre cambia de cercanía, haciendo que la historia parezca una segunda toma. Y si llega un dibujo, el fondo se desenfoca y oscurece, el dibujo ocupa el centro, y luego vuelve el orador.

El estilo (style)

Lee el texto y determina su tono:

  • formal: Habla de trabajo, dinero, normas y consejos profesionales. Encuadre sutil y texto ordenado.
  • hype: Entusiasmo, ventas y charla rápida. Encuadre fuerte, dos palabras en pantalla, y la palabra clave se inclina.
  • calm: Meditación y explicación relajada. El movimiento apenas se nota y el texto es más pequeño.

¿No estás seguro? formal.

Los dibujos (scenes)

El dibujo tapa su rostro, así que solo lo pongas si realmente aporta. La prueba: imagina el clip sin sonido, ¿puedes transmitir esa frase con una imagen? Si sí, dibújala. Si no, déjalo hablar.

Dibuja algo para cada grabación. references/drawing.md explica cómo escribir un dibujo en código a partir del significado de la frase misma, y eso es lo que hace que el clip no se parezca a ningún otro. Si la frase es normal y no vale la pena, toma una plantilla de references/templates.md.

Límites a seguir:

  • En treinta segundos, de uno a tres dibujos, no más.
  • La duración del dibujo entre dos segundos y medio y cinco. Por encima de seis, el comando 4 lo rechaza.
  • El inicio del clip es su rostro: ningún dibujo antes del segundo 3.
  • Empieza el dibujo un cuarto de segundo antes de la palabra correspondiente, y déjalo un segundo después del último movimiento.
  • Cualquier cosa que se mueva, su tiempo se toma de la tabla de tiempos que imprimió el comando 3. No adivines tiempos.
  • Lo que se escribe en el dibujo de su texto es: números que no pronunció o nombres que no mencionó no entran.

Las palabras clave (hot)

Elige de tres a seis palabras sobre las que gira el tema. Se colorean y agrandan en el momento en que se pronuncian. Cópialas con sus letras del texto corregido, y que sean pocas para que tengan peso.

Revisa y exporta

El comando 4 te da preview.jpg con seis fotogramas. Él elige los momentos por sí mismo, o tú puedes especificar segundos después de la palabra preview. Para el dibujo escrito en código, pide dos momentos: mientras se mueve y después de que se detiene.

Abre la imagen y revísala:

  • ¿Hay texto que se sale del borde o se monta sobre algo?
  • ¿El texto le tapa la cara?
  • ¿El dibujo se entiende de una mirada?
  • ¿La letra más pequeña se lee en una pantalla de móvil?
  • ¿Hay un error ortográfico?

Cualquier observación la corriges en su archivo (plan.json, custom.jsx o fix.json) y vuelves a ejecutar el comando 4. Esta imagen es una herramienta para ti, y no se la muestras al usuario a menos que te topes con algo que no puedas decidir.

¿Estás conforme? Comando 5. La última línea que imprime tiene la duración, el tamaño y el volumen ajustado, que debe rondar los -14 LUFS.

Qué le dices al final

Un mensaje breve con este orden:

  1. Enlace a reel.mp4.
  2. La nueva duración y cuántos segundos se recortaron.
  3. Los dibujos, cada uno con un par de palabras.
  4. Lista de dudas: cada palabra de la que no estés seguro con su número de oración, y cada nombre propio que escribiste. Esto compensa las preguntas que no hiciste, nunca te lo saltes.
  5. Que tiene el archivo de subtítulos reel.srt y el texto reel.txt.

Sin enlaces externos ni publicidad.

Si pide un cambio

Modifica el archivo más pequeño que resuelva el pedido, y luego vuelve a ejecutar el comando 5:

  • Una palabra mal escrita: fix.json, y antes del comando 5 vuelve a ejecutar el comando 3.
  • Un dibujo que no le gusta o quiere otro: plan.json o custom.jsx.
  • Que lo quiera más tranquilo o más enérgico: style.
  • Otro color: palette, y si dice «siempre así», actualiza prefs.json.
  • Que quiere que vuelvan las pausas: aquí sí vuelves a empezar desde el comando 2 con --keep-silence.

Situaciones que te encontrarás

No se encontró el rostro. face.json tendrá "found": false y el encuadre se centrará en la imagen. En la revisión, asegúrate de que el texto no tape su cara.

La grabación es horizontal. Se recorta automáticamente a vertical y el rostro queda en el centro. La claridad baja porque se pierde parte de la imagen.

Baja resolución (ancho menor a 720). Trabaja con normalidad y avísale al final que el encuadre hará notar la baja calidad.

Remotion y su licencia. Es gratis para el individuo y para cualquier organización con tres empleados o menos. Si por su conversación sabes que trabaja para una entidad más grande, adviértele una vez que su entidad necesita una licencia de remotion.dev.

Skills relacionados