Communitygithub.com

Hownameee/videos-cortos

Estructura el marcado de Remotion para que sea interactivo

¿Qué es videos-cortos?

Esta skill proporciona pautas detalladas para escribir marcado de Remotion de manera que el Remotion Studio pueda reconocer la estructura del código y hacerlo interactivo. Esto permite a los usuarios seleccionar elementos haciendo clic, arrastrar y soltar, redimensionar, rotar, editar estilos CSS, y modificar keyframes y valores de easing. La habilidad es útil para desarrolladores que crean componentes visuales reutilizables como tarjetas, títulos o escenas personalizadas, y es compatible con plataformas que utilizan Remotion, como Remotion Studio y sus derivados. Funciona mediante el uso de componentes `Interactive` y esquemas de interactividad (`InteractivitySchema`), donde se definen props editables (como texto, color, número, booleano, etc.) y se aplican reglas como mantener estilos en línea, usar `interpolate()` para animaciones, y registrar componentes reutilizables como composiciones conectadas. También recomienda evitar bucles programáticos (`.map()`) cuando se necesite edición independiente de instancias, y prefiere nombres descriptivos en elementos interactivos.

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

Preguntar en tu IA favorita

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

Vista previa

Del README del skill

videos-cortos preview

Documentación

Al escribir el marcado de Remotion de una manera específica, el Remotion Studio puede reconocer la estructura del código y hacerlo interactivo:

  • Permitiendo seleccionar elementos haciendo clic en ellos
  • Permitiendo arrastrar y soltar, redimensionar y rotar
  • Editando los estilos CSS
  • Haciendo editables los keyframes y valores de easing

Si el marcado es demasiado complejo para que el Studio lo haga interactivo, los valores se vuelven grises.

Prefiere componentes interactivos con sus propias líneas de tiempo

Usa Interactive.withSchema({wrapInSequence: true}) para escenas personalizadas, tarjetas, títulos y otros componentes visuales cuyos props deberían ser editables por instancia. Expón controles significativos de contenido y apariencia en un InteractivitySchema. Mantén los detalles de implementación decorativos dentro del componente.

El componente debe aceptar style y pasarlo a una raíz visual. Mantén una raíz compartida cuando las transformaciones, recortes u opacidad deban afectar a todas sus capas. Aplana envolturas internas redundantes cuando sus estilos puedan moverse a un elemento existente sin cambiar el diseño o la animación.

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,
});

Es necesario pasar el style inyectado dentro del componente; mantén los estilos editables en línea en el lugar de uso del componente.

Elegir campos del esquema

Cada clave en el esquema es un prop que el Studio puede leer y editar en el lugar de uso. Los props que no están en el esquema aún funcionan, pero no son editables en Studio. Las claves pueden usar notación de punto, como style.color.

TipoUsar paraKeyframeable
text-contentTexto, como un títuloNo
numberNúmeros, con opcional min, max, step, integerSí
booleanInterruptores On/offSí (hold)
colorCadenas de color CSSSí
enumUna elección entre variants, cada una con su propio esquema anidadoOpt-in (hold)
arrayListas de números, colores, enums y másNo
assetFuentes de medios, con opcional assetTypeNo
font-familyFamilia de fuente CSSNo
font-weightPeso de fuenteSí
translate, scale, rotation-css, rotation-degrees, transform-originTransformacionesSí
uv-coordinateUn punto normalizado [x, y] en el elementoSí
svg-pathDatos de ruta SVGSí
remotion-captionsDatos Caption[]No
hiddenUn valor mantenido fuera de los controles—

Cada campo necesita un default y debe tener un description, que el Studio muestra como la etiqueta. Establece keyframable: false para mostrar un control estático.

Expón contenido y apariencia por instancia, como el texto y un color de acento. No agregues campos para style.translate, style.scale, style.rotate, style.transformOrigin y style.opacity: wrapInSequence: true ya los agrega.

Para hacer editables las propiedades CSS de la raíz por instancia, extiende los fragmentos de esquema integrados:

const cardSchema = {
  ...Interactive.textSchema, // style.color, style.fontSize, style.fontWeight, ...
  ...Interactive.backgroundSchema, // style.backgroundColor
  ...Interactive.borderRadiusSchema, // style.borderRadius, ...
} as const satisfies InteractivitySchema;

También disponibles: Interactive.borderSchema, e Interactive.captionsSchema para componentes que aceptan subtítulos. Consulta InteractivitySchema para todas las opciones.

Registrar componentes reutilizables como composiciones conectadas

Registra escenas sustanciales y componentes reutilizables con sus propias capas o animación como composiciones independientes. El Studio llama a estas composiciones conectadas: se pueden abrir en su propia línea de tiempo mientras comparten la misma implementación de componente con el video padre.

Registra la misma referencia de componente exportada que el padre renderiza. Para el ejemplo anterior, usa component={LowerThird}, no LowerThirdInner o un envoltorio en línea. Con wrapInSequence: true, no se necesita un <Sequence> adicional para la conexión.

import {Composition} from 'remotion';
import {LowerThird} from './LowerThird';

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

Elige un ID único, valores predeterminados en línea representativos, y dimensiones, fps y duración adecuados para previsualizar el componente. Los valores predeterminados de registro no copian automáticamente props de una instancia padre. Consulta composiciones conectadas para detalles de registro y extracción.

Colocar el tiempo directamente en el componente

Evita un <Sequence> separado alrededor de un componente que ya acepta props de tiempo. Los componentes interactivos integrados y los componentes personalizados creados con wrapInSequence: true pueden recibir name, from, durationInFrames, trimBefore, playbackRate y premountFor directamente.

<LowerThird
  name="Tercer inferior"
  from={30}
  durationInFrames={90}
  accentColor="#0b84f3"
>
  Jane Doe, Diseñadora de Producto
</LowerThird>

Al eliminar una secuencia redundante, mueve su tiempo y nombre al hijo. Preserva cualquier tiempo existente del hijo; no sobrescribas ni apliques desplazamientos duplicados. Una llamada a useCurrentFrame() dentro del componente lee su fotograma local, mientras que una expresión de estilo en el lugar de uso aún usa el fotograma del llamante. Preserva esa distinción al mover estilos de animación.

Mantén un <Sequence> cuando proporcione tiempo compartido para múltiples hermanos, anule dimensiones para useVideoConfig(), o envuelva un componente que no maneje tiempo. Mantén <Series.Sequence> para diseño consecutivo y <TransitionSeries.Sequence> para transiciones; los props from directos no reemplazan esos comportamientos.

Dar a cada elemento editable independiente su propio nodo JSX

El Studio edita el nodo fuente JSX que creó un elemento. Si múltiples elementos en tiempo de ejecución provienen del mismo nodo JSX, comparten un objetivo de edición de fuente.

Para cada registro de composición, clip, escena, capa o secuencia que deba ser editable por sí mismo, escribe un nodo JSX separado y mantén sus props editables en ese nodo. Esto aplica a <Composition>, <Still>, componentes multimedia integrados, <Sequence>, <Series.Sequence>, <TransitionSeries.Sequence> y componentes personalizados.

Por ejemplo, crea una línea de tiempo editable así:

<Series>
  <Series.Sequence name="Introducción" durationInFrames={90}>
    <Introduction />
  </Series.Sequence>
  <Series.Sequence name="Demostración" durationInFrames={150}>
    <Demo />
  </Series.Sequence>
</Series>

Un .map() u otro bucle programático crearía múltiples elementos en tiempo de ejecución desde un nodo JSX fuente. Eso es apropiado para salida repetida que se controla intencionalmente como una plantilla, como barras de visualización o partículas. No es apropiado cuando las instancias necesitan IDs o nombres independientes, props, metadatos, tiempo, ordenamiento, eliminación o duplicación en el Studio.

Hacer un elemento HTML interactivo usando Interactive

Cada elemento HTML y SVG (excepto <Img>, que ya es interactivo) como <div> se puede hacer interactivo usando Interactive:

<Interactive.Div
  name="Tarjeta de saludo"
  style={{fontSize: 80, padding: 24}}
>
  Hola
</Interactive.Div>

Esto permite establecer estilos y keyframes en el Studio. Sé sensato, si un componente tiene muchos elementos, la línea de tiempo podría volverse desordenada.

Prefiere texto en línea

Si el texto es fijo y solo se usa una vez, escríbelo directamente dentro del elemento interactivo en lugar de extraerlo a una constante.

// 👍 El texto fijo permanece editable
<Interactive.Div name="Título">
  Mejores prácticas de Remotion
</Interactive.Div>

Usa un prop o variable solo cuando el texto sea dinámico o reutilizado.

Dar a los elementos interactivos un nombre descriptivo

Agrega un prop name a los elementos para que sean fácilmente identificables. Evita nombres calculados, codifícalos.

<>
  <Interactive.Div name="Título principal" style={{fontSize: 80}}>
    Día de lanzamiento
  </Interactive.Div>
  <Img name="Avatar" src="https://remotion.media/image.jpeg" />
  <Video name="Fondo" src="https://remotion.media/video.mp4" />
  <Interactive.Div name="Título">
    Día de lanzamiento
  </Interactive.Div>
</>

Mantener todos los estilos CSS en línea

La mejor manera es simplemente pasar un objeto simple a style - sin referirse a constantes, sin propagación de objetos, sin matemáticas.

<Interactive.Div
  style={{
    fontSize: 80,
    color: 'red',
  }}
>
  ¡Hola Mundo!
</Interactive.Div>
const baseStyle = useMemo(() => {
  return {
    fontSize: 12 // ❌ Los estilos no en línea no son compatibles
  }
}, []);

<Interactive.Div
  style={{
    ...baseStyle, // ❌ La propagación no es compatible
    color: RED, // ❌ Referirse a constantes no es compatible
    scale: frame * 10 // ❌ Las matemáticas no son compatibles
  }}
>
  ¡Hola Mundo!
</Interactive.Div>

Animar usando interpolate()

Escribe animaciones como llamadas interpolate() en línea sobre la propiedad que cambia. El rango de salida, el easing, la extrapolación y la propiedad output deben usar valores codificados.

El rango de entrada puede usar adicionalmente durationInFrames, fps, width y height desestructurados directamente de useVideoConfig(). Identificadores simples como durationInFrames, multiplicación con un número como 2 * fps o fps * 2, y resta de un número como durationInFrames - 1 son compatibles.

const {fps, durationInFrames} = useVideoConfig();

// 👍 Los valores en línea pueden ser estandarizados y keyframeados
<Interactive.Div
  name="Tarjeta de producto"
  style={{
    color: 'white',
    fontSize: 80,
    scale: interpolate(frame, [0, fps], [0, 1], {
      easing: Easing.spring({damping: 200}),
      output: 'perceptual-scale',
      extrapolateLeft: 'clamp',
      extrapolateRight: 'clamp'
    }),
    rotate: interpolate(frame, [0, 1 * fps], ['0deg', '20deg'], {
      easing: Easing.spring({damping: 200}),
      extrapolateLeft: 'clamp',
      extrapolateRight: 'clamp'
    }),
    translate: interpolate(
      frame,
      [durationInFrames - 30, durationInFrames],
      ['0px 0px', '0px 120px'],
      {
        easing: Easing.spring({damping: 200}),
        output: 'perceptual-scale',
        extrapolateLeft: 'clamp',
        extrapolateRight: 'clamp'
      }
    ),
  }}
/>
const translateY = interpolate(frame, [0, 30], [0, 120]); // ❌ Las matemáticas deberían estar directamente en el marcado

<Interactive.Div
  name="Tarjeta de producto"
  style={{
    translate: translateY, // ❌ Solo las llamadas interpolate() en línea son compatibles,
    rotate: interpolate(frame, [start, start + 10], [0, Math.PI]), // ❌ No se puede usar matemáticas con variables arbitrarias, no se pueden usar constantes
    scale: interpolate(anyVariable, [0, 30], [0, 1]) // ❌ Solo puede interpretar la variable `frame`.
  }}
/>

Mantener SVG pa

…[truncado para traducción]

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

Remotion Map animation knowledge

Hownameee/short-videos

Content, animation and effects best practices

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