Communitygithub.com

Hownameee/videos-cortos

Prácticas recomendadas para contenido, animación y efectos.

¿Qué es videos-cortos?

Este skill proporciona una guía completa y detallada para desarrollar videos cortos usando la biblioteca React de Remotion. Está diseñado específicamente para desarrolladores y usuarios de agentes de IA como Claude Code, Cursor o Codex, que buscan crear animaciones y efectos visuales de alto rendimiento para plataformas de video. La guía cubre desde reglas generales de animación con `useCurrentFrame()` e `interpolate()`, hasta el uso correcto de componentes multimedia, manejo de activos, y la creación de escenas interactivas. Además, explica cómo estructurar el marcado siguiendo las mejores prácticas de interactividad de Remotion, incluyendo el uso de `Interactive.withSchema()` para componentes visuales editables, el premontaje de elementos con `premountFor`, y la implementación de transiciones, superposiciones y efectos visuales. El skill también hace referencia a documentación adicional para temas avanzados como mapas, resaltado de texto, videos multicámara, voces en off, fuentes, Lottie, y detección de silencios, lo que lo convierte en un recurso central para la producción de contenido dinámico y personalizable.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Hownameee/short-videos/tree/HEAD/.agent/skills/remotion-markup

Preguntar en tu IA favorita

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

Vista previa

Del README del skill

Documentación

Esta es una guía para escribir el marcado React de Remotion. Si esto no es relevante, cargue las Prácticas Recomendadas de Remotion en su lugar.

Preservar cambios del usuario

Los usuarios pueden hacer ediciones en el código fuera de la conversación.

Si detecta un cambio sorprendente realizado mientras tanto, no lo sobrescriba, asuma que fue intencional o pida confirmación.

Reglas generales

Impulse las animaciones usando useCurrentFrame() e interpolate(). transition o animation de CSS no se renderizarán correctamente, deben ser refactorizados. Las clases de animación de Tailwind no se renderizarán correctamente, deben ser refactorizadas.

Use Easing.bezier() y Easing.spring() para personalizar la sincronización.

Estructura tu marcado de acuerdo con las Prácticas Recomendadas de Interactividad de Remotion. Prefiere Interactive.withSchema({wrapInSequence: true}) para componentes visuales personalizados con props editables, y registra escenas reutilizables como composiciones conectadas. Coloca la sincronización directamente en los componentes que la soportan; evita envoltorios redundantes de <Sequence>. Dale a cada componente temporizado que soporte premountFor un segundo de precarga: premountFor={fps}, donde fps proviene de useVideoConfig(). Aplica esto a medios, componentes interactivos, <Sequence>, <Series.Sequence>, <TransitionSeries.Sequence>, y <TransitionSeries.Overlay>, incluyendo componentes temporizados anidados dentro de escenas. Precarga también el elemento de la línea de tiempo padre cuando un elemento anidado necesite montarse antes de que el padre comience. Un componente sin premountFor, como <TransitionSeries.Transition>, no necesita sustituto.

El Studio edita el nodo fuente JSX que creó un elemento. Autoriza cada registro de composición, clip, escena, capa y secuencia que deba ser editable de forma independiente como su propio nodo JSX, con sus props editables en línea. Los bucles programáticos son adecuados cuando las instancias generadas están intencionalmente controladas como una plantilla fuente única, no cuando los usuarios necesitan editar las instancias por separado.

import { useCurrentFrame, useVideoConfig, Easing, interpolate, Interactive } from "remotion";

export const FadeIn = () => {
  const frame = useCurrentFrame();
  const {fps} = useVideoConfig();

  return (
    <Interactive.Div
      name="Título"
      premountFor={fps}
      style={{
        opacity: interpolate(frame, [0, 2 * fps], [0, 1], {
          extrapolateRight: "clamp",
          extrapolateLeft: "clamp",
          easing: Easing.bezier(0.16, 1, 0.3, 1),
        }),
      }}
    >
      ¡Hola Mundo!
    </Interactive.Div>
  );
};

Mantén la llamada a interpolate() en línea dentro de la prop style. Usa las propiedades CSS scale, translate, rotate en lugar de transform.

// 👍 Fotogramas clave editables en línea y abreviaturas de transformación
style={{
  scale: interpolate(frame, [0, 100], [0, 1], {
    extrapolateLeft: 'clamp',
    extrapolateRight: 'clamp',
    easing: Easing.spring({damping: 200}),
    output: 'perceptual-scale' // Para animaciones de `scale`, usa "output: 'perceptual-scale'"
  }),
  translate: interpolate(frame, [0, 100], ["0px 0px", "100px 100px"], {
    extrapolateLeft: 'clamp',
    extrapolateRight: 'clamp',
    easing: Easing.spring({damping: 200}),
  }),
  rotate: interpolate(frame, [0, 100], ["20deg", "90deg"], {
    extrapolateLeft: 'clamp',
    extrapolateRight: 'clamp',
    easing: Easing.spring({damping: 200}),
  }),
}}

// 👎 Los valores no en línea y las cadenas de transformación se vuelven más difíciles de editar en Studio
const scale = interpolate(frame, [0, 100], [0, 1]);

style={{
  transform: `scale(${scale})`,
}}

Activos

Coloca los activos en la carpeta public/ en la raíz de tu proyecto. Usa staticFile() para referenciar archivos desde la carpeta public/.

Componentes multimedia

Agrega video y audio usando <Video> y <Audio> de @remotion/media. Agrega imágenes usando el componente <CanvasImage>. Agrega imágenes animadas GIF, APNG, WebP o AVIF usando <AnimatedImage>, usa @remotion/gif si no usas Chrome. Usa staticFile() para archivos en public/ o pasa una URL remota directamente:

import { Audio, Video } from "@remotion/media";
import { staticFile, CanvasImage, AnimatedImage, useVideoConfig } from "remotion";

export const MyComposition = () => {
  const {fps} = useVideoConfig();

  return (
    <>
      <Video src={staticFile("video.mp4")} premountFor={fps} style={{ opacity: 0.5 }} />
      <Audio src={staticFile("audio.mp3")} premountFor={fps} />
      <CanvasImage
        src={staticFile("logo.png")}
        premountFor={fps}
        style={{ width: 100, height: 100 }}
      />
      <Video src="https://remotion.media/video.mp4" premountFor={fps} />
      <AnimatedImage src={staticFile('nyancat.gif')} premountFor={fps} />
    </>
  );
};

Si la composición es principalmente una línea de tiempo de clips de video o audio, lee video-editing.md antes de elegir su estructura fuente.

Escena de ejemplo

Un video de fondo con un tercio inferior. El tercio inferior es un componente interactivo con su propia línea de tiempo, registrado como una composición conectada. Su texto se pasa como children y accentColor es una prop editable. La aparición gradual se fotograma clave en línea en el sitio de llamada.

// MyScene.tsx
import { Video } from "@remotion/media";
import { Easing, interpolate, useCurrentFrame, useVideoConfig } from "remotion";
import { LowerThird } from "./LowerThird";

export const MyScene = () => {
  const { fps } = useVideoConfig();
  const frame = useCurrentFrame();

  return (
    <>
      <Video
        name="Fondo"
        src="https://remotion.media/video.mp4"
        premountFor={fps}
        objectFit="cover"
        style={{
          position: "absolute",
          width: "100%",
          height: "100%",
        }}
      />
      <LowerThird
        name="Tercio inferior"
        from={1 * fps}
        premountFor={fps}
        accentColor="#0b84f3"
        style={{
          opacity: interpolate(frame, [1 * fps, 2 * fps], [0, 1], {
            extrapolateRight: "clamp",
            extrapolateLeft: "clamp",
            easing: Easing.bezier(0.16, 1, 0.3, 1),
          }),
        }}
      >
        Jane Doe, Diseñadora de Producto
      </LowerThird>
    </>
  );
};
// LowerThird.tsx
import type React from "react";
import { Interactive, type InteractivitySchema } from "remotion";

type LowerThirdProps = {
  readonly children: string;
  readonly accentColor: string;
  readonly style?: React.CSSProperties;
};

const LowerThirdInner: React.FC<LowerThirdProps> = ({
  children,
  accentColor,
  style,
}) => {
  return (
    <Interactive.Div
      style={{
        position: "absolute",
        left: 80,
        bottom: 80,
        display: "flex",
        alignItems: "center",
        gap: 20,
        backgroundColor: "white",
        borderRadius: 16,
        padding: "20px 32px",
        color: "black",
        fontFamily: "Helvetica, Arial, sans-serif",
        fontSize: 48,
        fontWeight: 600,
        ...style,
      }}
    >
      <div
        style={{
          width: 8,
          alignSelf: "stretch",
          borderRadius: 4,
          backgroundColor: accentColor,
        }}
      />
      {children}
    </Interactive.Div>
  );
};

const lowerThirdSchema = {
  children: { type: "text-content", default: "", description: "Texto" },
  accentColor: {
    type: "color",
    default: "#0b84f3",
    description: "Color de acento",
  },
} as const satisfies InteractivitySchema;

export const LowerThird = Interactive.withSchema({
  Component: LowerThirdInner,
  componentName: "<LowerThird>",
  schema: lowerThirdSchema,
  wrapInSequence: true,
});
// Root.tsx
import { Composition } from "remotion";
import { LowerThird } from "./LowerThird";
import { MyScene } from "./MyScene";

export const RemotionRoot: React.FC = () => {
  return (
    <>
      <Composition
        id="MyScene"
        component={MyScene}
        durationInFrames={60}
        fps={30}
        width={1280}
        height={720}
      />
      <Composition
        id="LowerThird"
        component={LowerThird}
        durationInFrames={30}
        fps={30}
        width={1280}
        height={720}
        defaultProps={{
          children: "Jane Doe, Diseñadora de Producto",
          accentColor: "#0b84f3",
        }}
      />
    </>
  );
};

Retrasar, recortar

Coloca la sincronización directamente en los componentes que la soportan. Consulta Props de sincronización para las props compatibles, ejemplos y orden de operaciones.

Mapas

Consulta Mapas de Remotion si deseas incluir mapas en el video.

Resaltados y anotaciones de texto

Consulta text-highlights.md para resaltados de texto (marcadores de resaltado), círculos, subrayados, tachados, texto tachado, recuadros.

Videos de múltiples escenas

Consulta multi-scene-video.md si planeas hacer un video con varias escenas consecutivas.

Composiciones conectadas

Cuando una escena o grupo de capas merezca su propia línea de tiempo editable, sigue connected-compositions.md. Prefiere esta estructura para escenas sustanciales en un video de múltiples escenas.

Acción de precomposición

Para una solicitud de Studio como Pre-compose Resplandor ambiental (src/BarChart.tsx:134), encuentra el marcado de secuencia seleccionado en la ubicación dada. Crea una composición conectada, siguiendo connected-compositions.md: extrae el marcado en un componente con nombre, preferiblemente hazlo interactivo con Interactive.withSchema({wrapInSequence: true}), y registra la misma referencia de componente exportada con un <Composition> único en la raíz. Renderiza el componente interactivo directamente con sus props de sincronización, o como el único hijo de una secuencia cuando ese envoltorio tenga un propósito. Si el nodo seleccionado ya es una secuencia, conserva sus props y extrae sus hijos. El registro necesita dimensiones, fps, duración y defaultProps equivalentes a su uso padre. Una extracción de componente sin una composición registrada no completa una solicitud de precomposición.

Voz en off

Consulta voiceover.md para agregar una voz en off generada por IA a las composiciones de Remotion usando ElevenLabs TTS.

Incrustar videos

Consulta embedding-videos.md para conocimientos avanzados sobre incrustar videos: recorte, volumen, velocidad, bucle, tono.

Incrustar audio

Consulta audio.md para funciones avanzadas de audio como recorte, volumen, velocidad, tono.

Recorte

Consulta cropping.md si necesitas recortar el rectángulo visible de un componente.

Transiciones

Consulta transitions.md para patrones de transición de escenas.

Desenfoque de movimiento

Al agregar desenfoque de movimiento o una estela de movimiento, lee motion-blur.md para conocer el enfoque preferido de HTML en canvas, requisitos de vista previa y alternativas.

Efectos visuales y de píxeles

Al crear un efecto visual, considera si es factible usando CSS y HTML, o si se necesita un sombreador. Orden de preferencia:

  1. HTML + CSS regular u otras técnicas web
  2. Un efecto aplicado al elemento directamente (<Video>, <Img>), o envolviendo el contenido en <HtmlInCanvas>, que también acepta effects:
  • Un efecto listado a través de effects.md
  • Un createEffect() personalizado a través de effects.md cuando no haya un preajuste disponible.

Contenido 3D

Consulta ./3d.md para contenido 3D en Remotion usando Three.js y React Three Fiber.

Efectos de sonido

Cuando necesites usar efectos de sonido, carga el archivo ./sfx.md para obtener más información.

Visualización de audio

Cuando necesites visualizar audio (barras de espectro, formas de onda, efectos reactivos a graves), carga el archivo ./audio-visualization.md para obtener más información.

Mapas

Para mapas estáticos, rutas animadas y marcadores, explicadores geográficos, Mapbox, MapLibre, MapTiler, GeoJSON o sobrevuelos geográficos 3D, carga Mapas de Remotion.

Subtítulos

Al tratar con subtítulos, carga el skill de Subtítulos de Remotion para obtener más información.

Google Fonts

Es la forma recomendada de cargar fuentes en Remotion. Consulta google-fonts.md para saber cómo cargar Google Fonts.

Fuentes locales

Consulta local-fonts.md para saber cómo cargar fuentes locales.

GIFs

Consulta gifs.md para saber cómo mostrar GIFs sincronizados con la línea de tiempo de Remotion.

Imágenes avanzadas

Consulta images.md para dimensionar y posicionar imágenes, rutas de imágenes dinámicas y obtener dimensiones de imágenes.

Animaciones Lottie

Consulta lottie.md para incrustar animaciones Lottie en Remotion.

Sincronización

Consulta timing.md para más técnicas de sincronización para interpolate().

Videos parametrizados

Consulta parameters.md para hacer una composición parametrizable agregando un esquema Zod.

Medición de nodos DOM

Consulta measuring-dom-nodes.md para medir las dimensiones de elementos DOM en Remotion.

Medición de texto

Consulta measuring-text.md para medir dimensiones de texto, ajustar texto a contenedores y verificar desbordamiento.

Uso de FFmpeg

Para algunas operaciones de video, como recortar videos o detectar silencio, se debe usar FFmpeg. Carga el archivo ./ffmpeg.md para obtener más información.

Detección de silencio

Cuando necesites detectar y recortar segmentos silenciosos de archivos de video o audio, carga el archivo ./silence-detection.md.

Duración, dimensiones y datos dinámicos

Consulta calculate-metadata.md para configurar dinámicamente la duración, dimensiones y props de la composición.

Composiciones e imágenes fijas

Antes de registrar elementos <Composition> o <Still>, lee compositions.md para registros editables en fuente, carpetas, props predeterminados y anidamiento. Para la navegación del Studio a la línea de tiempo propia de una escena, usa composiciones conectadas.

Secuenciación avanzada

Consulta sequencing.md para más patrones de secuenciación: retraso, recorte, limitar duración de elementos.

Instalar módulos

Usa npx remotion add para agregar nuevos paquetes con la versión correcta:

npx remotion add @remotion/…

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

Hownameee/short-videos

Generate, revise or troubleshoot local Kokoro narration, pronunciation and scene word timing. Reuse verified unchanged clips; inspect the Python environment before setup changes. Exclude research, visuals, music composition and publishing.

Hownameee/short-videos

Router for all Remotion skills

Hownameee/short-videos

Transcribing, displaying and animating captions

Hownameee/short-videos

Structure Remotion markup for interactivity

Hownameee/short-videos

Remotion Map animation knowledge

Hownameee/short-videos

Upgrade Remotion, and related packages

Hownameee/short-videos

>- Run Phase 1 of the shared short-video workflow: turn a raw topic or prompt into a sourced research pack and 2–4 distinct video directions, each with a defensible tension hook, promise, payoff, beats, visual approach, duration range, and risks. Use whenever the user asks for video ideas, angles, research, facts, hooks, topic analysis, or choices before scriptwriting. Stop for the user's direction choice and do not silently continue into script or production.

Hownameee/short-videos

Produce an approved short video or correct an existing video's background sound, emotion, captions, mix or export. Generate only changed narration, render and review a current preview, run technical and editorial QC, then export. Exclude script-only and general audio-advice requests.

Hownameee/short-videos

>- Run Phase 2 of the shared short-video workflow: convert an explicitly selected direction and its research into a reviewable beat sheet, narration, flexible scene timing, on-screen text, visual plan, captions, music and SFX cues, pronunciation notes, payoff, takeaway, and contextual CTA. Use whenever a user asks to write, revise, preview, or approve a short-video script. Stop for script approval and do not generate TTS or render video yet.

Hownameee/short-videos

>- Design and review a coherent visual system for short-form video before and during Remotion implementation. Use for video art direction, scene UI, typography, layout, color, diagrams, captions, motion, transitions, platform safe areas, or visual-quality review. Use Remotion skills separately for API, timeline, media, Studio, and rendering behavior; do not use this skill for narration-only or research-only work.

Hownameee/short-videos

Coordinate prompt-to-short-video discovery, scripting and production. Resume existing projects and route soundtrack or mix corrections directly to production. Preserve direction choice and script approval; exclude general audio advice.

Skills relacionados