Remotion — Extensiones del Toolkit
El conocimiento básico de Remotion se encuentra en
.claude/skills/remotion-official/(sincronizado desde el repositorio oficial remotion-dev/skills). Este archivo cubre patrones específicos del toolkit únicamente.
Componentes Compartidos
Componentes de video reutilizables en lib/components/. Impórtalos en las plantillas mediante:
import { AnimatedBackground, SlideTransition, Label } from '../../../../lib/components';
| Componente | Propósito |
|---|---|
AnimatedBackground | Fondo de formas flotantes (variantes: sutil, tecnológico, cálido, oscuro) |
SlideTransition | Transiciones de escena (desvanecer, zoom, deslizar hacia arriba, desenfoque) |
Label | Insignia de etiqueta flotante con referencia opcional a JIRA |
Vignette | Superposición de oscurecimiento de bordes cinematográfica |
LogoWatermark | Marca de agua de logotipo en esquina |
SplitScreen | Comparación de video lado a lado |
NarratorPiP | Superposición de presentador en imagen dentro de imagen |
Envelope | Sobre 3D con animación de apertura de solapa |
PointingHand | Emoji de mano animada con deslizamiento y pulso |
MazeDecoration | Decoración de cuadrícula isométrica animada para esquinas |
Transiciones Personalizadas
El toolkit incluye una biblioteca de transiciones en lib/transitions/ para efectos entre escenas más allá del paquete oficial @remotion/transitions.
Uso de TransitionSeries
import { TransitionSeries, linearTiming } from '@remotion/transitions';
// Importa transiciones personalizadas desde lib (ajusta la ruta según la ubicación de tu proyecto)
import { glitch, lightLeak, clockWipe, checkerboard } from '../../../../lib/transitions';
// O importa desde @remotion/transitions para las oficiales
import { slide, fade } from '@remotion/transitions/slide';
<TransitionSeries>
<TransitionSeries.Sequence durationInFrames={90}>
<TitleSlide />
</TransitionSeries.Sequence>
<TransitionSeries.Transition
presentation={glitch({ intensity: 0.8 })}
timing={linearTiming({ durationInFrames: 30 })}
/>
<TransitionSeries.Sequence durationInFrames={120}>
<ContentSlide />
</TransitionSeries.Sequence>
</TransitionSeries>
Transiciones Personalizadas Disponibles
| Transición | Opciones | Mejor Para |
|---|---|---|
glitch() | intensity, slices, rgbShift | Demos tecnológicos, revelaciones atrevidas, ciberpunk |
rgbSplit() | direction, displacement | Tecnología moderna, transiciones enérgicas |
zoomBlur() | direction, blurAmount | Llamadas a la acción, momentos de alta energía, impacto |
lightLeak() | temperature, direction | Celebraciones, estética cinematográfica, momentos cálidos |
clockWipe() | startAngle, direction, segments | Contenido relacionado con el tiempo, revelaciones lúdicas |
pixelate() | maxBlockSize, gridSize, scanlines, glitchArtifacts, randomness | Retro/gaming, transformaciones digitales |
checkerboard() | gridSize, pattern, stagger, squareAnimation | Revelaciones lúdicas, transiciones estructuradas |
Patrones de tablero de ajedrez: sequential, random, diagonal, alternating, spiral, rows, columns, center-out, corners-in
Ejemplos de Transiciones
// Sensación tecnológica/ciberpunk
glitch({ intensity: 0.8, slices: 8, rgbShift: true })
// Celebración cálida
lightLeak({ temperature: 'warm', direction: 'right' })
// Zoom de alta energía
zoomBlur({ direction: 'in', blurAmount: 20 })
// Aberración cromática
rgbSplit({ direction: 'diagonal', displacement: 30 })
// Barrido de reloj
clockWipe({ direction: 'clockwise', startAngle: 0 })
// Pixelado retro
pixelate({ maxBlockSize: 50, glitchArtifacts: true })
// Patrones de tablero de ajedrez
checkerboard({ pattern: 'diagonal', gridSize: 8 })
checkerboard({ pattern: 'spiral', gridSize: 10 })
checkerboard({ pattern: 'center-out', squareAnimation: 'scale' })
Guías de Duración de Transiciones
| Tipo | Fotogramas | Notas |
|---|---|---|
| Corte rápido | 15-20 | Rápido, contundente |
| Estándar | 30-45 | Más común |
| Dramático | 50-60 | Revelaciones lentas |
| Efectos glitch | 20-30 | Deben sentirse repentinos |
| Fuga de luz | 45-60 | Necesita tiempo para barrer |
Vista Previa de Transiciones
Ejecuta la galería de demostración para ver todas las transiciones:
cd showcase/transitions && npm run studio
Mejores Prácticas del Toolkit
- Solo animaciones basadas en fotogramas — Evita transiciones/animaciones CSS; causan parpadeo durante el renderizado
- Usa fps de useVideoConfig() — Haz las animaciones independientes de la frecuencia de fotogramas
- Sujeta las interpolaciones — Usa
extrapolateRight: 'clamp'para evitar valores descontrolados - Usa OffthreadVideo — Mejor rendimiento que
<Video>para composiciones complejas - delayRender para async — Siempre bloquea el renderizado hasta que los datos estén listos
- staticFile para activos — Referencia archivos de la carpeta
public/correctamente - Todos los proyectos usan 30fps — Temporización: fotogramas = segundos × 30
- playbackRate debe ser constante — Para velocidades variables/extremas, procesa previamente con FFmpeg
Convenciones de Temporización del Proyecto
| Tipo de Escena | Duración | Notas |
|---|---|---|
| Título | 3-5s (90-150f) | Logo + titular |
| Resumen | 10-20s | 3-5 viñetas |
| Demo | 10-30s | Ajusta playbackRate para que encaje |
| Estadísticas | 8-12s | 3-4 tarjetas de estadísticas |
| Créditos | 5-10s | Desvanecimiento rápido |
Ritmo: ~150 palabras/minuto para voz en off. La voz en off guía la temporización.
API Avanzada
Para documentación detallada de la API sobre todos los hooks, componentes, renderizador, Lambda y APIs del Player, consulta reference.md.
Nota de Licencia
Remotion tiene una licencia especial. Es posible que las empresas necesiten obtener una licencia para uso comercial. Consulta https://remotion.dev/license
Retroalimentación y Contribuciones
Si esta habilidad carece de información o se puede mejorar:
- ¿Falta un patrón? Describe lo que necesitabas
- ¿Encontraste un error? Dime qué está mal
- ¿Quieres contribuir? Puedo ayudarte a:
- Actualizar esta habilidad con mejoras
- Crear un PR en github.com/digitalsamba/claude-code-video-toolkit
Simplemente di "mejora esta habilidad" y te guiaré en la actualización de .claude/skills/remotion/SKILL.md.