Communitygithub.com

Remotion Controls Skill

Controle profissional de animação vetorial por código com React/TypeScript, renderização nativa de fundo transparente (canal Alpha) e suporte a saída de vídeo WebM/MOV com canal alfa.

O que é Remotion Controls Skill?

Esta skill capacita agentes de IA a criarem animações 2D vetoriais precisas e controladas por código usando o framework Remotion, baseado em React/TypeScript. Ela se diferencia de ferramentas como ComfyUI (geração de imagem/vídeo por IA) e Blender (animação 3D) ao oferecer controle total sobre cada frame, renderização nativa de fundo transparente (canal Alpha) e saída em formatos como WebM (VP9) e MOV (ProRes 4444). A skill fornece componentes de animação reutilizáveis para personagens, textos, transições e efeitos, além de uma API HTTP para orquestração de renderização, controle de qualidade automatizado e sistema de auto-aprendizagem que otimiza parâmetros com base em feedback. É ideal para a produção de ativos de animação para templates de aplicativos como CapCut, animações de UI, tipografia animada e animações 2D de personagens, integrando-se perfeitamente com pipelines de edição de vídeo automatizadas.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add beimeibeile/Remotion-controls-skill

Perguntar na sua IA favorita

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

Documentação

O que Remotion Controls Skill faz?

Habilidade profissional para criar animações vetoriais com código. Remotion é um framework de criação de vídeo baseado em React que permite controle preciso sobre cada frame, com suporte nativo a renderização com fundo transparente.

Capacidades Principais

CapacidadeDescrição
Renderização com fundo transparenteSuporte nativo ao canal Alpha, saída para WebM (VP9) / MOV (ProRes 4444) com transparência
Controle preciso por códigoControle exato de posição, escala, rotação, opacidade e curvas de easing com React/TypeScript
Serviço via APIAPI HTTP que recebe instruções de animação e produz arquivos de vídeo
Biblioteca de templatesModelos de animação pré-definidos (animação de personagens, UI, texto, transições)
Controle de qualidadeDetecção automática de taxa de quadros, resolução, bitrate e integridade do canal Alpha
Auto-aprendizagemRegistro de parâmetros de renderização e pontuação de efeito, otimização de parâmetros pré-definidos

Diferenciação em relação ao ComfyUI / Blender

SkillPrincipal vantagemCenários de uso
ComfyUI-controlsGeração por IA (imagem/vídeo/áudio), criatividade imprevisívelGeração de imagens de personagens/cenas, efeitos especiais de vídeo
Blender-controlsAnimação 3D, simulação física, renderização de alta qualidadeAnimação 3D de personagens, exibição de produtos, efeitos físicos
Remotion-controlsAnimação 2D por código, precisão, fundo transparenteAtivos de animação para templates, animações de UI, tipografia, animação 2D de personagens

Início Rápido

1. Instalar dependências

cd remotion-project
npm install

2. Renderizar vídeo com fundo transparente

# Via CLI
npx remotion render src/index.ts MyComp out/video.webm --transparent

# Via API
python remotion_controls.py render --composition MyComp --output out/video.webm --transparent

3. Iniciar servidor da API

python remotion_controls.py serve --port 8765

Renderização com fundo transparente (fluxo verificado)

Remotion tem suporte nativo a fundo transparente, mas a flag --transparent da CLI perde o canal Alpha (verificado para WebM VP8/VP9 e MOV ProRes).

Fluxo correto verificado (PIT-024):

  1. Renderizar sequência PNG: npx remotion render src/index.ts Composition out/frames --sequence (gera PNGs com canal Alpha)
  2. Sintetizar com ffmpeg para ProRes 4444:
    ffmpeg -y -framerate 30 -i out/frames/%04d.png \
      -c:v prores_ks -profile:v 4 -pix_fmt yuva444p12le \
      out/animation.mov
    
  3. Verificar canal Alpha: python verify_animation.py out/animation.mov

Observações para integração com CapCut (PIT-024):

  • add_media_safe ao importar ProRes 4444 mov transcodifica para H.264 mp4, perdendo o canal Alpha (66MB → 0.07MB)
  • Deve-se importar manualmente: copiar o mov diretamente para o diretório materials do rascunho → criar VideoMaterial → registrar em materials.videos → VideoSegment(material=anim_material) → add_segment

Padrão de qualidade para ativos de animação

Padrão completo em QUALITY_STANDARD.md.

Critérios obrigatórios para ativos de animação aprovados:

  • Canal Alpha preservado (yuva444p12le)
  • Codificação ProRes 4444 (profile=4)
  • Resolução/taxa de quadros/duração consistentes com a configuração
  • Cobertura de conteúdo ≥ 50% (amostragem de 10 pontos)
  • Tamanho de arquivo razoável (≤15MB/segundo)

Verificação automatizada:

python verify_animation.py <arquivo de animação> --duration 20 --width 1080 --height 1920

Biblioteca de componentes de animação base

Localizada em remotion-project/src/components/, todos os componentes suportam fundo transparente.

Componentes de personagens e movimento

ComponenteDescrição
CharacterSpriteSprite de personagem: múltiplas posturas, animação com keyframes de posição/escala/rotação/opacidade
MotionPathCaminho de movimento: movimento linear/bezier/elástico/quique
FlashEffectEfeito de flash branco: fade in rápido e fade out lento
ShakeEffectEfeito de vibração: vibração aleatória com amplitude decrescente
FadeEffectFade in/out: duração controlável de fade in/fade out
PopEffectEfeito de pop: escala elástica com pop
SlideEffectEfeito de deslizamento: deslizamento suave em quatro direções

Componentes de animação de texto (TextAnimations.tsx)

ComponenteDescriçãoCenários de uso
TextRevealRevelação caractere por caractere: máquina de escrever/fade in/deslizar para cima/esquerdaNarração, falas, entrada de títulos
TextPopTexto com pop: escala/rotação/quiqueDestaque de palavras-chave, marcação de ritmo
TextWaveTexto ondulado: flutuação senoidal caractere por caractereEstilo divertido, ritmo de música de fundo
TextGlitchEstilo glitch: separação RGB + tremorEstilo tecnológico, arte glitch, transições
TextGradientGradiente fluido: fluxo de cores + luz varridaTítulos, nomes de marca, elegância
KineticTextTipografia cinética: animação combinada de múltiplas linhasTítulos de abertura, créditos finais

Componentes de transição (TransitionEffects.tsx)

ComponenteDescriçãoCenários de uso
FadeTransitionTransição fade in/out (in/out/inOut)Transição geral, mudança de emoção
SlideTransitionTransição com deslizamento (cima/baixo/esquerda/direita)Troca de cena, substituição de conteúdo
ZoomTransitionTransição com zoom (aproximar/afastar)Ênfase em detalhes, aproximação de câmera
WipeTransitionTransição com wipe (cima/baixo/esquerda/direita/diagonal)Transição criativa, estilizada
BlurTransitionTransição com desfoque (primeiro desfocado, depois nítido)Transição onírica, flashback
GlitchTransitionTransição glitch (separação RGB + linhas de varredura)Estilo tecnológico, arte glitch

Componentes de efeitos de impacto (ImpactEffects.tsx)

ComponenteDescriçãoCenários de uso
PunchImpactImpacto de soco (onda de choque + estrelas + flash branco)Luta, golpe, colisão
ImpactFlashFlash de impacto (flash branco rápido)Golpe forte, explosão, marcação de ritmo
ParticleBurstExplosão de partículas (estrelas/faíscas/fragmentos)Comemoração, explosão, impacto
ShockwaveOnda de choque (anéis múltiplos em expansão)Liberação de energia, explosão, vibração
SpeedLinesLinhas de velocidade (radiais)Impacto de alta velocidade, corrida, combo

Exemplo de uso:

import { PunchImpact, ParticleBurst, FadeTransition } from "./components";

// Cena de luta
<PunchImpact startFrame={90} x={540} y={800} scale={1.2} />
<ParticleBurst startFrame={90} x={540} y={800} count={16} particleType="star" />
<FadeTransition direction="in" duration={15} startFrame={0} color="#1a1a2e" />

Exemplo de uso:

import { CharacterSprite, FlashEffect, TextReveal, TextPop } from "./components";

<CharacterSprite
  poses={[
    { name: "idle", image: "/doubao_normal.png", frameRange: [0, 90],
      position: [{frame: 0, x: 0, y: 0}, {frame: 90, x: 100, y: 0}] },
    { name: "falling", image: "/doubao_falling.png", frameRange: [90, 150] },
  ]}
  width={250} height={250}
/>
<FlashEffect startFrame={90} duration={10} />
<TextReveal text="Fui atingido!" fontSize={56} startFrame={95} revealType="typewriter" />
<TextPop text="Dor!" fontSize={72} color="#ff6b6b" startFrame={110} popType="bounce" />

Estrutura do projeto

remotion-controls-skill/
├── SKILL.md                    # Este arquivo
├── QUALITY_STANDARD.md         # Padrão de qualidade para ativos de animação
├── verify_animation.py         # Ferramenta de verificação automatizada
├── remotion_controls.py        # Script de controle principal (CLI/API)
├── .env.example                # Exemplo de variáveis de ambiente
├── .gitignore
├── capabilities/
│   ├── cap_api_wrapper/        # Encapsulamento da API Remotion
│   ├── cap_animation_renderer/ # Renderizador de animações
│   ├── cap_template_library/   # Biblioteca de templates de animação
│   ├── cap_quality_control/    # Controle de qualidade
│   └── cap_self_evolution/     # Auto-aprendizagem
├── remotion-project/           # Projeto Remotion
│   ├── src/
│   │   ├── components/         # Biblioteca de componentes de animação base
│   │   │   ├── CharacterSprite.tsx
│   │   │   ├── MotionPath.tsx
│   │   │   ├── Effects.tsx
│   │   │   └── index.ts
│   │   ├── AnimationTemplate.tsx  # Template de animação orientado por JSON
│   │   ├── Root.tsx
│   │   └── index.ts
│   ├── public/                 # Ativos estáticos (imagens de personagens/props)
│   └── package.json
└── out/                        # Saída de renderização

Módulos de Capacidade

cap_api_wrapper — Encapsulamento da API Remotion

  • render_media(): Renderizar vídeo (com suporte a fundo transparente)
  • render_still(): Renderizar imagem de um frame
  • select_composition(): Obter lista de Compositions disponíveis
  • get_props_schema(): Obter definição de Props de uma Composition

cap_animation_renderer — Renderizador de animações

  • Entrada: JSON de instruções de animação → Saída: Vídeo com fundo transparente
  • Suporte a animação com keyframes (posição/escala/rotação/opacidade)
  • Suporte a curvas de easing (ease-in/ease-out/ease-in-out/linear/spring)
  • Suporte a composição de múltiplas camadas

cap_template_library — Biblioteca de templates de animação

  • Template de animação de personagens (Doubao sendo atingido, troca de expressão, etc.)
  • Template de animação de UI (clique de botão, troca de página, etc.)
  • Template de animação de texto (máquina de escrever, fade in/out, quique, etc.)
  • Template de transição (fade in/out, deslizamento, zoom, etc.)

cap_quality_control — Controle de qualidade

  • Detecção de taxa de quadros (24/30/60fps)
  • Detecção de resolução (1080p/4K)
  • Detecção de integridade do canal Alpha
  • Comparação da duração do vídeo com o esperado
  • Verificação de tamanho de arquivo razoável

cap_self_evolution — Auto-aprendizagem

  • Registro de parâmetros de renderização e pontuação de efeito
  • Otimização de parâmetros pré-definidos
  • Geração de documentos de melhores práticas
  • Ranking de efeitos de templates

Variáveis de Ambiente

REMOTION_PROJECT_PATH=./remotion-project
REMOTION_OUTPUT_DIR=./output
REMOTION_DEFAULT_FPS=30
REMOTION_DEFAULT_WIDTH=1080
REMOTION_DEFAULT_HEIGHT=1920
REMOTION_API_PORT=8765

Integração com ai-video-editor

Remotion-controls-skill atua como ferramenta de criação de ativos de animação para o ai-video-editor:

  1. O mecanismo de direção do ai-video-editor gera instruções de animação
  2. Remotion-controls-skill recebe as instruções e renderiza vídeos com fundo transparente
  3. O vídeo com fundo transparente é usado como camada de ativo de animação de template no CapCut
  4. Após o usuário substituir o fundo, a animação é perfeitamente sobreposta

Observações

  • Remotion requer Node.js 18+
  • Para vídeos com fundo transparente, recomenda-se o formato WebM (boa compatibilidade com CapCut)
  • Renderização de vídeos longos é demorada; recomenda-se renderizar em segmentos e depois compor
  • Evitar o uso de filtros CSS em animações (alguns filtros não suportam fundo transparente)

Habilidades Relacionadas