Communitygithub.com

thevibethinker/n5os-ode

Crie vídeos programaticamente com React usando Remotion. Scaffold projetos, escreva composições e renderize MP4s. Um wrapper otimizado para Zo baseado nas skills oficiais do Remotion.

O que é n5os-ode?

Esta skill permite criar vídeos programaticamente usando React com a biblioteca Remotion, oferecendo controle preciso sobre animações, transições e renderização de vídeos em formato MP4. É útil para desenvolvedores que precisam gerar vídeos baseados em dados, como gráficos animados, vídeos personalizados em lote, conteúdo para redes sociais (TikTok, Reels, Shorts) ou vídeos explicativos de produtos. A skill suporta as plataformas Zo e Claude Code, e foi projetada como um wrapper otimizado para Zo, permitindo renderização em lote via `/zo/ask`. Seu funcionamento é baseado em conceitos de composições (definição de dimensões, duração e FPS), animações baseadas em frames (usando `useCurrentFrame()`) e sequenciamento de elementos com `<Sequence>`. A skill também referencia regras detalhadas de habilidades upstream do Remotion para animações, timing, áudio, vídeos e muito mais, garantindo consistência com a documentação oficial.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/thevibethinker/n5os-ode/tree/HEAD/Skills/remotion

Perguntar na sua IA favorita

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

Documentação

Quando Usar

Use esta skill quando:

  • Criando vídeos programáticos a partir de código (não vídeo generativo de IA)
  • Construindo conteúdo de vídeo baseado em dados (gráficos, estatísticas, vídeos personalizados)
  • Produzindo vídeos em lote a partir de modelos + dados
  • Criando conteúdo animado para redes sociais (TikTok, Reels, Shorts)
  • Construindo vídeos de produto/explicativos com controle preciso

Início Rápido

1. Criar um Novo Projeto

python3 Skills/remotion/scripts/remotion_cli.py new my-video --template blank
cd Sites/my-video

2. Escreva Sua Composição

Edite src/Composition.tsx - este é o seu vídeo definido como componentes React.

3. Pré-visualize no Studio

python3 Skills/remotion/scripts/remotion_cli.py studio my-video

4. Renderize para MP4

python3 Skills/remotion/scripts/remotion_cli.py render my-video --output output.mp4

Conceitos Principais

Composições

Uma composição define as dimensões, duração e FPS do seu vídeo:

<Composition
  id="MyVideo"
  component={MyComponent}
  durationInFrames={300}  // 10 segundos a 30fps
  fps={30}
  width={1920}
  height={1080}
/>

Animação Baseada em Frame

TODAS as animações DEVEM usar useCurrentFrame(). Animações CSS são PROIBIDAS.

const frame = useCurrentFrame();
const { fps } = useVideoConfig();
const opacity = interpolate(frame, [0, fps], [0, 1], { extrapolateRight: 'clamp' });

Sequências

Use <Sequence> para temporizar quando os elementos aparecem:

<Sequence from={30} durationInFrames={60}>
  <Title />
</Sequence>

Referências de Regras

Leia estas para padrões detalhados (carregados das skills upstream do Remotion):

RegraDescrição
references/animations.mdFundamentos de animação baseada em frame
references/timing.mdSprings, easing, curvas de interpolação
references/compositions.mdDefinindo composições, stills, pastas
references/sequencing.mdTemporização e ordenação de elementos
references/videos.mdIncorporando vídeos - cortar, volume, velocidade
references/audio.mdManipulação de áudio - importar, cortar, volume
references/assets.mdImagens, fontes, arquivos estáticos
references/transitions.mdTransições de cena
references/text-animations.mdPadrões de animação tipográfica
references/charts.mdPadrões de visualização de dados
references/display-captions.mdLegendas estilo TikTok

Comandos CLI

# Gerenciamento de projetos
python3 Skills/remotion/scripts/remotion_cli.py new <nome> [--template blank|hello-world]
python3 Skills/remotion/scripts/remotion_cli.py studio <nome>
python3 Skills/remotion/scripts/remotion_cli.py render <nome> [--composition ID] [--output caminho]
python3 Skills/remotion/scripts/remotion_cli.py list

# Opções de renderização
--composition ID    # Composição específica a renderizar (padrão: primeira)
--output CAMINHO    # Caminho do arquivo de saída (padrão: out/video.mp4)
--fps N             # Substituir FPS
--width N           # Substituir largura
--height N          # Substituir altura
--codec CODEC       # h264, h265, vp8, vp9, prores (padrão: h264)

Padrões Comuns

Fade In/Out

const frame = useCurrentFrame();
const { fps, durationInFrames } = useVideoConfig();

const fadeIn = interpolate(frame, [0, fps], [0, 1], { extrapolateRight: 'clamp' });
const fadeOut = interpolate(frame, [durationInFrames - fps, durationInFrames], [1, 0], { extrapolateLeft: 'clamp' });
const opacity = fadeIn * fadeOut;

Animação com Spring (Movimento Natural)

const scale = spring({
  frame,
  fps,
  config: { damping: 200 }, // Suave, sem bounce
});

Elementos Escalonados

{items.map((item, i) => (
  <Sequence key={i} from={i * 10}>
    <Item data={item} />
  </Sequence>
))}

Vídeo Baseado em Dados

type VideoProps = { title: string; stats: number[] };

export const DataVideo: React.FC<VideoProps> = ({ title, stats }) => {
  // Animar com base em props
};

// Em Root.tsx:
<Composition
  id="DataVideo"
  component={DataVideo}
  defaultProps={{ title: "Resultados Q4", stats: [10, 20, 30] }}
  // ...
/>

Integração com Zo

Renderização em Lote

Use /zo/ask para renderizar múltiplos vídeos em paralelo:

for row in data:
    # Cada chamada renderiza com props diferentes
    await render_video(row)

Localização da Saída

Os projetos residem em Sites/<nome>/ para consistência com o sistema de sites do Zo. Os vídeos renderizados são enviados para Sites/<nome>/out/.

Restrições

  • Sem animações CSS - Elas não renderizarão corretamente
  • Sem classes de animação do Tailwind - Mesmo problema
  • Baseado em frame apenas - Todo movimento vindo de useCurrentFrame()
  • Intensivo em CPU - A renderização leva tempo; vídeos complexos = renderização mais longa
  • Node.js necessário - Remotion precisa de ambiente Node (já disponível no Zo)

Habilidades Relacionadas