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 únicamente los patrones específicos del toolkit.
Componentes Compartidos
Componentes de video reutilizables en lib/components/. Impórtalos en plantillas mediante:
import { AnimatedBackground, SlideTransition, Label } from '../../../../lib/components';
| Componente | Propósito |
|---|---|
AnimatedBackground | Fondo de formas flotantes (variantes: sutil, tech, cálido, oscuro) |
SlideTransition | Transiciones de escena (fundido, zoom, deslizar arriba, fundido borroso) |
Label | Etiqueta flotante con referencia opcional a JIRA |
Vignette | Superposición de oscurecimiento de bordes cinematográfico |
LogoWatermark | Marca de agua con 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 señalando animado con deslizamiento y pulso |
MazeDecoration | Decoración animada de cuadrícula isométrica 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 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 | Ideal para |
|---|---|---|
glitch() | intensity, slices, rgbShift | Demos tech, revelaciones con borde, ciberpunk |
rgbSplit() | direction, displacement | Tech moderno, transiciones enérgicas |
zoomBlur() | direction, blurAmount | CTAs, momentos de alta energía, impacto |
lightLeak() | temperature, direction | Celebraciones, estética cinematográfica, momentos cálidos |
clockWipe() | startAngle, direction, segments | Contenido relacionado con tiempo, revelaciones juguetonas |
pixelate() | maxBlockSize, gridSize, scanlines, glitchArtifacts, randomness | Retro/gaming, transformaciones digitales |
checkerboard() | gridSize, pattern, stagger, squareAnimation | Revelaciones juguetonas, transiciones estructuradas |
Patrones de checkerboard: sequential, random, diagonal, alternating, spiral, rows, columns, center-out, corners-in
Ejemplos de Transiciones
// Sensación tech/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 })
// Revelación circular
clockWipe({ direction: 'clockwise', startAngle: 0 })
// Pixelación retro
pixelate({ maxBlockSize: 50, glitchArtifacts: true })
// Patrones de checkerboard
checkerboard({ pattern: 'diagonal', gridSize: 8 })
checkerboard({ pattern: 'spiral', gridSize: 10 })
checkerboard({ pattern: 'center-out', squareAnimation: 'scale' })
Directrices 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 |
| Light leak | 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
Buenas Prácticas del Toolkit
- Solo animaciones basadas en fotogramas — Evita transiciones/animaciones CSS; causan parpadeo durante el renderizado
- Usa fps de
useVideoConfig()— Haz que las animaciones sean independientes de la frecuencia de fotogramas - Limita 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 assets — Referencia correctamente archivos desde la carpeta
public/ - Todos los proyectos usan 30fps — Temporización: fotogramas = segundos × 30
- playbackRate debe ser constante — Para velocidades variables/extremas, preprocesa con FFmpeg
Convenciones de Temporización de Proyectos
| Tipo de Escena | Duración | Notas |
|---|---|---|
| Título | 3-5s (90-150f) | Logotipo + titular |
| Descripción general | 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 | Fundido rápido |
Ritmo: ~150 palabras/minuto para narración. La narración determina la temporización.
API Avanzada
Para documentación detallada de la API sobre todos los hooks, componentes, renderizador, Lambda y Player APIs, consulta reference.md.
Nota sobre la Licencia
Remotion tiene una licencia especial. Las empresas pueden necesitar obtener una licencia para uso comercial. Consulta https://remotion.dev/license
Comentarios y Contribuciones
Si esta habilidad carece de información o se puede mejorar:
- ¿Falta un patrón? Describe lo que necesitabas
- ¿Encontraste un error? Cuéntame qué está mal
- ¿Quieres contribuir? Puedo ayudarte a:
- Actualizar esta habilidad con mejoras
- Crear un PR en github.com/digitalsamba/claude-code-video-toolkit
Solo di "mejorar esta habilidad" y te guiaré para actualizar .claude/skills/remotion/SKILL.md.