Communitygithub.com

reel-from-raw

Convierte un video raw de persona hablando (Hinglish o Inglés, vertical 9:16) en un reel editado para Instagram con Remotion: cortes de silencios, zooms de impacto, títulos 3D, paneles de terminal, filtros de luz, efectos de sonido y tarjeta de seguimiento.

¿Qué es reel-from-raw?

Este skill convierte un video raw vertical (9:16) de una persona hablando en Hinglish o Inglés en un reel de Instagram completamente editado usando Remotion. Está diseñado para desarrolladores que usan asistentes de IA como Claude Code, Cursor o Codex, y que necesitan editar reels de alta calidad de manera automática. El skill gestiona todo el flujo: desde la creación del proyecto, transcripción, corte de silencios, generación de una hoja de ritmos ('beat sheet'), hasta la edición final que incluye zooms de impacto, títulos 3D, paneles de terminal, filtros de luz y efectos de sonido sincronizados. Funciona en macOS, Linux y Windows WSL, y sigue reglas estrictas para mantener la cara del hablante visible en zonas seguras, no añadir sonidos sin permiso, y no renderizar el video completo a menos que el usuario lo solicite. El skill también maneja peticiones comunes como cambiar volúmenes, eliminar sonidos, o ajustar tiempos, y proporciona instrucciones detalladas para cada paso del workflow.

Compatible con✓Claude Code~Codex CLI~Cursor✓OpenCode
npx skills add https://github.com/pawantekchandani/reel-from-raw/tree/HEAD/skills/reel-from-raw

Preguntar en tu IA favorita

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

Documentación

Reel a partir de video raw

Probado en dos reels: Linux Day 2 y Linux Day 1 (con efectos de sonido). library/Reel.tsx es el reel del Day 1. Copia sus patrones. No inventes un nuevo estilo.

Funciona en macOS y en Linux / Windows WSL. Configuración: consulta README.md en el repositorio.

Reglas estrictas

  1. Cada superposición está sincronizada desde work/words.txt en segundos. Nunca adivines un tiempo.
  2. Usa solo componentes en src/ (la librería). Añade un nuevo componente solo cuando ningún componente de la librería se ajuste a un ritmo (beat).
  3. Mantén la cara visible. Zonas seguras (1080x1920):
    • Etiquetas y títulos superiores: y 90 a 400.
    • Cara y cuello: y aproximadamente 450 a 1350. Nada aquí excepto tarjetas de título de pantalla completa (máximo 3 s).
    • Todo lo demás va debajo del cuello (el primer botón de la camisa): y 1360 a 1880. Panel comienza en BELOW_NECK (1360). Usa fit para escalar un panel alto de modo que termine en 1880.
    • Encuentra la línea del cuello para cada nuevo video: captura un fotograma con una cuadrícula y mira. Actualiza BELOW_NECK en ui.tsx.
  4. No renderices el video completo a menos que el usuario lo pida en el chat. Usa scripts/stills.sh para comprobar. Un hook bloquea remotion render sin RENDER_OK=1.
  5. No descargues nada (modelos, fuentes, música, paquetes de sonido) sin preguntar al usuario.
  6. Lee reference/known-problems.md antes de depurar cualquier cosa.
  7. En OpenCode, el plugin ~/.config/opencode/plugins/reel-from-raw hace el mismo trabajo que los hooks de Claude (bloqueo de render, verificación de tipos, recordatorio de stills). Abre las imágenes de las hojas con la herramienta de lectura. Si tu modelo no puede ver imágenes, pide al usuario que revise las hojas.

Reglas de alcance (síguelas exactamente)

  1. Haz solo lo que el usuario pidió. Cambia solo los archivos y valores que la solicitud necesita.
  2. Una verificación (verificación de tipos, verificación de stills, recordatorio de un hook o plugin) es solo una verificación. Arregla solo lo que rompa una regla de este archivo o de reference/style-spec.md. Nunca reestiles, añadas un componente, añadas una escena, o cambies texto, sincronización o volumen a causa de una verificación.
  3. Si crees que algo más debería cambiar, díselo al usuario en una línea. No lo cambies.
  4. Nunca edites ~/.claude/skills/reel-from-raw/ (este skill) mientras trabajes en un video. Edita solo el proyecto de video.
  5. Cualquier archivo de prueba que crees (por ejemplo, src/__probe.ts) debe ser eliminado antes de que termines.

Flujo de trabajo (nuevo video)

Ejecuta cada paso. Cada script imprime OK: en caso de éxito. Detente y arregla cualquier ERROR.

#PasoComando / acción
1Crear proyectobash ~/.claude/skills/reel-from-raw/scripts/new-project.sh <dir> <raw.mp4> (por ejemplo, ~/Coding/motion-videos/<name>). Copia la librería, los archivos de sonido y los hooks, e instala paquetes npm (o los clona desde $REEL_SEED).
2Transcribirbash ~/.claude/skills/reel-from-raw/scripts/transcribe.sh <dir> hi (usa en solo para inglés). Luego corrige errores de transcripción con reference/glossary.md.
3Cortar silenciospython3 ~/.claude/skills/reel-from-raw/scripts/cuts.py <dir>. Usa --start/--end para eliminar un falso inicio o final.
4Hoja de ritmosSigue reference/beat-sheet-prompt.md. Escribe work/beats.md. Muéstralo al usuario si quiere aprobar el plan.
5Construirsrc/Reel.tsx es el reel del Day 1. Reescríbelo a partir de la hoja de ritmos. En Root.tsx, establece id (por ejemplo, LinuxDay3) y el handle real. Elimina componentes de escenas que el reel no use. Mantén los ayudantes At y r().
6Verificación de tiposAutomática: un hook ejecuta tsc --noEmit después de cada edición. Corrige cualquier error que reporte.
7Verificación visualbash ~/.claude/skills/reel-from-raw/scripts/stills.sh <dir> auto, luego lee cada out/stills/sheet*.jpg. También verifica fotogramas de ritmos: stills.sh <dir> 120,450,.... Verifica contra reference/style-spec.md. Corrige y repite.
8Verificación de sonidoLos efectos de sonido vienen con los componentes (consulta "Efectos de sonido"). Verifica que public/sfx/typing.wav y public/sfx/pop.wav existan. No añadas sonidos fuera de la tabla a menos que el usuario lo pida.
9Vista previaAñade una entrada launch.json que ejecute npx remotion studio --no-open --port <libre> en el proyecto. Dale al usuario la URL http://localhost:<puerto>. El usuario escucha los sonidos allí.
10Renderizar (solo a petición)RENDER_OK=1 npx remotion render <Id> out/<nombre>.mp4 --gl=angle (ejecutar en segundo plano, unos 3-5 min para 90 s).

Efectos de sonido

src/sfx.tsx contiene todos los sonidos. SFX lista los sonidos. <Sfx src at volume frames name> reproduce un sonido at fotogramas dentro de la secuencia actual.

Clave en SFXFuente¿Necesita Internet?
whoosh, ding, click, switch, whip@remotion/sfx (archivos en remotion.media)Sí, para Studio y render
poppublic/sfx/pop.wav (generado por código)No
typingpublic/sfx/typing.wav (generado por scripts/make-typing-sound.py)No

Los componentes de la librería ya reproducen estos sonidos. No los añades manualmente.

MomentoArchivo (en el proyecto)SonidoVolumen
Título / chip secundario del ganchoscenes/Intro.tsx (Hook)whoosh / whip0.54 / 0.48
Tarjeta de título del díascenes/Intro.tsx (DayTitle)whoosh / ding0.6 / 0.36
Chips de lista de comandosscenes/Intro.tsx (CommandList)pop por chip0.36
Etiqueta de comando / nombre de comandoscenes/Commands.tsx (CommandTag)whoosh / switch0.54 / 0.48
Líneas de bloc de notasscenes/Commands.tsx (NoteCard)typing por línea0.6
Panel inferior apareceui.tsx (Panel)pop0.48
Comando de terminal escritoui.tsx (Terminal)typing por cada línea de comando0.6
Filtro de luzReel.tsxwhoosh0.48
Insignia de finalizado / clic de seguimientoscenes/Outro.tsx (DayDone, FollowCard)ding / click0.48 / 0.72
Cualquier <Sfx> sin volumesfx.tsx (predeterminado)-0.42

El volumen va de 0 (silencio) a 1 (completo). Mantén todos los sonidos por debajo de la voz.

Solicitudes comunes (receta exacta)

El usuario pideHaz exactamente esto
"Aumentar / disminuir todos los efectos de sonido en un N%"Multiplica cada volume={x} en una línea <Sfx, y el valor predeterminado en sfx.tsx, por (1 ± N/100). Redondea a 2 decimales. No toques CutVideo.tsx (esa es la voz). Ejecuta grep -rn "<Sfx" src antes y después, y muestra los valores cambiados.
"Cambiar solo el volumen del teclado / escritura"Cambia solo las líneas con src={SFX.typing} (ui.tsx Terminal y scenes/Commands.tsx NoteCard).
"Cambiar solo el sonido X"Encuentra su fila en la tabla anterior. Cambia solo ese volume.
"El sonido del teclado es débil / haz uno nuevo"python3 ~/.claude/skills/reel-from-raw/scripts/make-typing-sound.py <proyecto>/public/sfx/typing.wav. Guarda una copia del archivo anterior primero. Edita los números en el script solo si el usuario pide una sensación diferente.
"Eliminar un sonido"Elimina esa línea <Sfx .../>.
"¿Dónde puedo escucharlo antes de renderizar?"Studio (paso 9). Presiona Reproducir o Espacio. Studio se recarga solo después de cada edición guardada.
"¿Cómo renderizo yo mismo?"Terminal: cd <proyecto> && npx remotion render <Id> out/<nombre>.mp4 --gl=angle. UI de Studio: botón Render (extremo derecho de la barra sobre la línea de tiempo) → pestaña Video → establece Nombre de salida → Render video. El progreso se muestra en la pestaña Trabajos. La configuración de OpenGL ya es angle.
"Renderízalo"Paso 10, con RENDER_OK=1. Luego da la ruta completa del archivo de salida.
"Cambiar el handle"Root.tsx defaultProps.handle.

Cómo funciona la sincronización

  • src/timeline.ts: CUTS (segundos raw eliminados), out(sec) mapea un segundo raw a un fotograma de salida.
  • <At from={rawSec} to={rawSec} name="..."> muestra un bloque para ese intervalo hablado.
  • r(t0, t) da un retardo de fotograma dentro de un bloque, para "mostrar esto cuando se dice la palabra en t".
  • CutVideo alterna zoom 1.0 / 1.14 por segmento (zoom de impacto en cada corte). No añadas más zoom.

Mapa de la librería

ArchivoExportacionesUsar para
theme.tsDISPLAY (Anton), SANS (Inter), MONO, colores C, extrude()Todo el texto y color. Sin nuevas fuentes o colores.
sfx.tsxSFX, SfxEfectos de sonido (ver arriba)
ui.tsxPop, useIn, useOut, BELOW_NECK, Panel, TermFrame, TerminalAparición con resorte, panel inferior, terminal escrito
scenes/Intro.tsxHook({title, sub, subAt}), DailyStep({children}), DayTitle({day}), CommandList({commands, line, lineAt}), LightLeakApertura, transiciones de sección
scenes/Commands.tsxCommandTag({n, total, name, nameAt, meaning, meaningAt, color}), FolderPath, FileGrid, MoveSwap, NoteCardUn tema por sección: etiqueta arriba, visual en Panel
scenes/Commands.tsx (Día 2, texto codificado)IdCard, OwnerSwap, PhoneApps, Snapshot, TopView, PdfSearchAñade props para el texto antes de reutilizar uno
scenes/Outro.tsxDayDone({day}), NextDay({day, commands, at}), FollowCard({handle})Final (NextDay es opcional)
Reel.tsxReelReel completo del Día 1. Úsalo como ejemplo para la estructura.

Mantén tamaños, colores y animaciones cuando cambies texto.

Skills relacionados