Communitygithub.com

thevibethinker/n5os-ode

Crea vídeos programáticamente con React usando Remotion. Scaffold proyectos, escribe composiciones y renderiza MP4s. Wrapper optimizado para Zo alrededor de las skills oficiales de Remotion.

¿Qué es n5os-ode?

Esta skill te permite crear vídeos programáticos usando React con Remotion, ideal para contenido basado en datos como gráficos, estadísticas, vídeos personalizados y contenido animado para redes sociales. Soporta la creación de proyectos desde cero, la escritura de composiciones como componentes de React, previsualización en estudio y renderizado a MP4. Está diseñada para integrarse con el ecosistema Zo, permitiendo renderizados en lote y gestionando proyectos en el directorio `Sites/`. Sigue principios de animación basados en fotogramas con `useCurrentFrame()`, prohibiendo animaciones CSS, y proporciona referencias detalladas para animaciones, transiciones, incrustación de vídeos y audio, y visualización de datos.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/thevibethinker/n5os-ode/tree/HEAD/Skills/remotion

Preguntar en tu IA favorita

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

Documentación

Cuándo Usarlo

Usa esta skill cuando:

  • Creando vídeos programáticos a partir de código (no vídeo generativo por IA)
  • Construyendo contenido de vídeo basado en datos (gráficos, estadísticas, vídeos personalizados)
  • Produciendo vídeos por lotes a partir de plantillas + datos
  • Creando contenido animado para redes sociales (TikTok, Reels, Shorts)
  • Construyendo vídeos de producto/explicativos con control preciso

Inicio Rápido

1. Crear un Nuevo Proyecto

python3 Skills/remotion/scripts/remotion_cli.py new mi-video --template blank
cd Sites/mi-video

2. Escribe tu Composición

Edita src/Composition.tsx - este es tu vídeo definido como componentes de React.

3. Vista Previa en el Estudio

python3 Skills/remotion/scripts/remotion_cli.py studio mi-video

4. Renderizar a MP4

python3 Skills/remotion/scripts/remotion_cli.py render mi-video --output salida.mp4

Conceptos Clave

Composiciones

Una composición define las dimensiones, duración y fps de tu vídeo:

<Composition
  id="MiVideo"
  component={MiComponente}
  durationInFrames={300}  // 10 segundos a 30fps
  fps={30}
  width={1920}
  height={1080}
/>

Animación Basada en Fotogramas

TODAS las animaciones DEBEN usar useCurrentFrame(). Las animaciones CSS están PROHIBIDAS.

const frame = useCurrentFrame();
const { fps } = useVideoConfig();
const opacity = interpolate(frame, [0, fps], [0, 1], { extrapolateRight: 'clamp' });

Secuencias

Usa <Sequence> para temporizar cuándo aparecen los elementos:

<Sequence from={30} durationInFrames={60}>
  <Titulo />
</Sequence>

Referencias de Reglas

Lee estas para patrones detallados (cargadas desde las skills upstream de Remotion):

ReglaDescripción
references/animations.mdFundamentos de animación basada en fotogramas
references/timing.mdSprings, easing, curvas de interpolación
references/compositions.mdDefinición de composiciones, imágenes fijas, carpetas
references/sequencing.mdTemporización y orden de elementos
references/videos.mdIncrustar vídeos - recortar, volumen, velocidad
references/audio.mdManejo de audio - importar, recortar, volumen
references/assets.mdImágenes, fuentes, archivos estáticos
references/transitions.mdTransiciones de escena
references/text-animations.mdPatrones de animación tipográfica
references/charts.mdPatrones de visualización de datos
references/display-captions.mdSubtítulos estilo TikTok

Comandos CLI

# Gestión de proyectos
python3 Skills/remotion/scripts/remotion_cli.py new <nombre> [--template blank|hello-world]
python3 Skills/remotion/scripts/remotion_cli.py studio <nombre>
python3 Skills/remotion/scripts/remotion_cli.py render <nombre> [--composition ID] [--output ruta]
python3 Skills/remotion/scripts/remotion_cli.py list

# Opciones de renderizado
--composition ID    # Composición específica a renderizar (por defecto: primera)
--output RUTA       # Ruta del archivo de salida (por defecto: out/video.mp4)
--fps N             # Sobrescribir FPS
--width N           # Sobrescribir ancho
--height N          # Sobrescribir alto
--codec CODEC       # h264, h265, vp8, vp9, prores (por defecto: h264)

Patrones Comunes

Fundido de Entrada/Salida

const frame = useCurrentFrame();
const { fps, durationInFrames } = useVideoConfig();

const fadeIn = interpolate(frame, [0, fps], [0, 1], { extrapolateRight: 'clamp' });
const fadeOut = interpolate(frame, [durationInFrames - fps, durationInFrames], [1, 0], { extrapolateLeft: 'clamp' });
const opacity = fadeIn * fadeOut;

Animación con Spring (Movimiento Natural)

const scale = spring({
  frame,
  fps,
  config: { damping: 200 }, // Suave, sin rebote
});

Elementos Escalonados

{items.map((item, i) => (
  <Sequence key={i} from={i * 10}>
    <Item data={item} />
  </Sequence>
))}

Vídeo Basado en Datos

type VideoProps = { titulo: string; estadisticas: number[] };

export const VideoDatos: React.FC<VideoProps> = ({ titulo, estadisticas }) => {
  // Animar basado en props
};

// En Root.tsx:
<Composition
  id="VideoDatos"
  component={VideoDatos}
  defaultProps={{ titulo: "Resultados Q4", estadisticas: [10, 20, 30] }}
  // ...
/>

Integración con Zo

Renderizado por Lotes

Usa /zo/ask para renderizar múltiples vídeos en paralelo:

for fila in datos:
    # Cada llamada renderiza con diferentes props
    await renderizar_video(fila)

Ubicación de Salida

Los proyectos residen en Sites/<nombre>/ para consistencia con el sistema de sitios de Zo. Los vídeos renderizados se generan en Sites/<nombre>/out/.

Restricciones

  • Sin animaciones CSS - No se renderizarán correctamente
  • Sin clases de animación de Tailwind - Mismo problema
  • Solo basado en fotogramas - Todo movimiento desde useCurrentFrame()
  • Intensivo en CPU - El renderizado toma tiempo; vídeos complejos = renderizado más largo
  • Node.js requerido - Remotion necesita entorno Node (ya disponible en Zo)

Skills relacionados