Communitygithub.com

CambridgeMonorail/WallRun

Crea y edita videos de demostración de Remotion para WallRun dentro del directorio de demos del monorepo Nx.

¿Qué es WallRun?

Esta habilidad está diseñada para construir y mantener el video de demostración de Remotion para WallRun, ubicado en el directorio `demos/wallrun-video` dentro de un monorepo Nx. Su propósito es proporcionar una estructura clara para la creación de escenas, composiciones, componentes de movimiento reutilizables, ritmo de video y explicaciones orientadas a desarrolladores. Está pensada para desarrolladores frontend que usan React y TypeScript, y busca crear un video de estilo editorial y minimalista, evitando animaciones complejas o efectos promocionales. La habilidad define reglas de diseño de escenas, pautas de animación, convenciones de codificación y un flujo de trabajo predeterminado, además de exponer objetivos Nx para previsualizar, renderizar y verificar tipos del proyecto.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/CambridgeMonorail/WallRun/tree/HEAD/skills/remotion-demo-video

Preguntar en tu IA favorita

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

Documentación

Habilidad de Video de Demostración de Remotion

Esta habilidad ayuda a construir y mantener el video de demostración de Remotion ubicado en:

demos/wallrun-video

Proporciona estructura para:

  • creación de escenas
  • estructura de composición
  • componentes de movimiento reutilizables
  • ritmo de video
  • explicaciones orientadas a desarrolladores

Esta habilidad debe usarse al trabajar en:

  • composiciones de Remotion
  • componentes de escena
  • segmentos explicativos animados
  • estructura o secuencia de video
  • primitivas de movimiento utilizadas en la demostración

Contexto del proyecto

Este repositorio es un monorepo Nx.

El video de Remotion se encuentra en:

demos/wallrun-video

El proyecto renderiza un video explicativo orientado a desarrolladores para WallRun.

La audiencia son desarrolladores frontend, no especialistas en marketing.

Se asume que el espectador entiende:

  • React
  • TypeScript
  • arquitectura de componentes
  • sistemas de diseño
  • herramientas para desarrolladores

Evitar explicar conceptos básicos de JavaScript.


Intención de diseño

El video debe sentirse como contenido para desarrolladores, no como un anuncio de producto.

Buen tono:

  • editorial
  • minimalista
  • moderno
  • confiado
  • movimiento moderado

Mal tono:

  • promoción genérica de SaaS
  • efectos cinematográficos de tráiler
  • animaciones pesadas de partículas
  • texto denso de marketing

Priorizar:

  • legibilidad
  • jerarquía
  • ritmo
  • claridad

Estructura del proyecto

Todo el código debe residir dentro de:

demos/wallrun-video/src

Estructura:

  • components/ — Primitivas de presentación reutilizables
  • scenes/ — Secciones temporizadas del video
  • data/ — Guión, texto, constantes de tiempo
  • Root.tsx — Registra composiciones
  • index.ts — Archivo de entrada para la CLI de Remotion

Reglas de diseño de escenas

Cada escena debe comunicar una sola idea.

Duración típica: 4–8 segundos

Las escenas deben:

  • leerse rápidamente
  • tener tipografía grande
  • evitar el desorden
  • mantener el movimiento sutil

Tipos de escena preferidos:

  • tarjetas de título
  • capturas de pantalla del repositorio en escena
  • primeros planos de componentes
  • superposiciones de llamadas
  • diagramas de arquitectura
  • paneles de estadísticas

Evitar:

  • interfaces de usuario pequeñas
  • párrafos largos
  • transiciones demasiado complejas

Pautas de animación

Prefiere animaciones deterministas simples.

Ejemplos:

  • aparición gradual
  • deslizamiento hacia arriba
  • revelación escalonada
  • escala sutil

Evitar:

  • efectos de rebote
  • movimiento físico complejo
  • curvas de aceleración pesadas

El objetivo es la claridad, no el espectáculo.


Convenciones de codificación

Usar:

  • componentes funcionales de React
  • TypeScript
  • exportaciones nombradas
  • tipos explícitos
  • envoltorios de movimiento reutilizables

Evitar:

  • código de animación duplicado
  • números mágicos
  • tiempos de escena codificados

Extraer constantes de tiempo cuando sea práctico.

Ejemplo:

const TITLE_FADE_IN = 20;
const CALLOUT_DELAY = 15;

Flujo de trabajo predeterminado para crear una nueva escena

  1. Definir el mensaje de la escena
  2. Definir la duración en fotogramas
  3. Diseñar el diseño
  4. Agregar movimiento primario
  5. Agregar movimiento secundario solo si mejora la claridad
  6. Verificar la legibilidad
  7. Asegurarse de que el código sea reutilizable

Objetivos Nx

  • preview — nx preview wallrun-video abre Remotion Studio
  • render — nx render wallrun-video renderiza el video completo en dist/demos/wallrun-video/
  • type-check — nx type-check wallrun-video ejecuta el compilador de TypeScript

Definición de completado

Una escena está completa cuando:

  • el mensaje es inmediatamente claro
  • la tipografía se lee a escala de video
  • la animación es moderada
  • los tiempos son fáciles de editar
  • el código está estructurado de forma limpia

Skills relacionados