Communitygithub.com

CambridgeMonorail/WallRun

Crie e edite vídeos de demonstração Remotion para WallRun dentro do diretório de demos do monorepo Nx.

O que é WallRun?

Esta skill é especializada na criação e manutenção de vídeos de demonstração Remotion, localizados no diretório `demos/wallrun-video` de um monorepo Nx. É ideal para desenvolvedores que precisam construir vídeos explicativos voltados para o público de frontend, utilizando React e TypeScript. A skill guia o design com um tom editorial e minimalista, priorizando clareza, hierarquia e animações sutis em detrimento de efeitos chamativos de marketing. Ela oferece regras claras para estruturação de cenas (cada uma com uma única ideia, duração de 4 a 8 segundos), animações determinísticas (como fade in e slide up) e convenções de código React funcional com tipagem explícita. Além disso, integra-se aos comandos Nx para preview, renderização e type-check, garantindo que o código seja limpo e reutilizável. Suportada por plataformas como Claude Code, Cursor e Codex, esta habilidade assegura que cada cena do vídeo seja imediatamente compreensível, com tipografia legível e cronometragem facilmente ajustável.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Habilidade de Vídeo de Demonstração Remotion

Esta habilidade ajuda a construir e manter a demonstração de vídeo Remotion localizada em:

demos/wallrun-video

Ela fornece estrutura para:

  • criação de cenas
  • estrutura de composição
  • componentes de movimento reutilizáveis
  • ritmo do vídeo
  • explicações voltadas para desenvolvedores

Esta habilidade deve ser usada ao trabalhar em:

  • composições Remotion
  • componentes de cena
  • segmentos explicativos animados
  • estrutura ou sequenciamento de vídeo
  • primitivas de movimento usadas pela demonstração

Contexto do projeto

Este repositório é um monorepo Nx.

O vídeo Remotion está localizado em:

demos/wallrun-video

O projeto renderiza um vídeo explicativo voltado para desenvolvedores para WallRun.

O público-alvo são desenvolvedores frontend, não profissionais de marketing.

Presume-se que o espectador entenda:

  • React
  • TypeScript
  • arquitetura de componentes
  • sistemas de layout
  • ferramentas de desenvolvimento

Evite explicar conceitos básicos de JavaScript.


Intenção de design

O vídeo deve parecer mídia para desenvolvedores, não um anúncio de produto.

Tom apropriado:

  • editorial
  • minimalista
  • moderno
  • confiante
  • movimento contido

Tom inadequado:

  • promoção genérica de SaaS
  • efeitos cinematográficos de trailer
  • animações pesadas de partículas
  • texto denso de marketing

Priorize:

  • legibilidade
  • hierarquia
  • ritmo
  • clareza

Estrutura do projeto

Todo o código deve estar dentro de:

demos/wallrun-video/src

Estrutura:

  • components/ — Primitivas de apresentação reutilizáveis
  • scenes/ — Seções temporizadas do vídeo
  • data/ — Roteiro, texto, constantes de tempo
  • Root.tsx — Registra composições
  • index.ts — Arquivo de entrada para o CLI Remotion

Regras de design de cena

Cada cena deve comunicar apenas uma ideia.

Duração típica: 4 a 8 segundos

As cenas devem:

  • ser lidas rapidamente
  • ter tipografia grande
  • evitar poluição visual
  • manter movimento sutil

Tipos de cena preferidos:

  • cartões de título
  • capturas de tela encenadas do repositório
  • closes de componentes
  • sobreposições de destaque
  • diagramas de arquitetura
  • painéis de estatísticas

Evite:

  • UI minúscula
  • parágrafos longos
  • transições excessivamente complexas

Diretrizes de animação

Prefira animação determinística e simples.

Exemplos:

  • fade in
  • deslizar para cima
  • revelação escalonada
  • escala sutil

Evite:

  • efeitos de bounce
  • movimento com física complexa
  • curvas de easing pesadas

O objetivo é clareza, não espetáculo.


Convenções de código

Use:

  • componentes funcionais React
  • TypeScript
  • exports nomeados
  • tipos explícitos
  • wrappers de movimento reutilizáveis

Evite:

  • código de animação duplicado
  • números mágicos
  • tempo de cena codificado

Extraia constantes de tempo quando prático.

Exemplo:

const TITLE_FADE_IN = 20;
const CALLOUT_DELAY = 15;

Fluxo de trabalho padrão para criar uma nova cena

  1. Defina a mensagem da cena
  2. Defina a duração em frames
  3. Bloqueie o layout
  4. Adicione movimento primário
  5. Adicione movimento secundário apenas se melhorar a clareza
  6. Verifique a legibilidade
  7. Garanta que o código seja reutilizável

Alvos Nx

  • preview — nx preview wallrun-video abre o Remotion Studio
  • render — nx render wallrun-video renderiza o vídeo completo em dist/demos/wallrun-video/
  • type-check — nx type-check wallrun-video executa o compilador TypeScript

Definição de concluído

Uma cena está concluída quando:

  • a mensagem é imediatamente clara
  • a tipografia é legível na escala do vídeo
  • a animação é contida
  • os tempos são fáceis de editar
  • o código está estruturado de forma limpa

Habilidades Relacionadas