script-to-remotion
Converta roteiros de vídeo estruturados em projetos Remotion funcionais, incluindo geração de componentes React, integração de áudio TTS, geração de legendas e renderização de vídeo.
Cenários de Uso
Utilize esta skill quando precisar:
- Converter script.json em um projeto de vídeo Remotion
- Gerar componentes React seguindo as melhores práticas do Remotion
- Opcionalmente, gerar áudio TTS (usando a API Google Gemini)
- Gerar legendas segmentadas inteligentemente automaticamente
- Renderizar o vídeo final (formato MP4)
Não utilize quando:
- Gerar scripts diretamente a partir de artigos (use a skill
article-to-script) - Editar vídeos ou clipes existentes
- Criar conteúdo de vídeo interativo
Pré-requisitos
Obrigatórios
- script.json - Saída da skill
article-to-script - Node.js - Versão 18+ e gerenciador de pacotes pnpm
- Skill remotion-best-practices - Deve ser consultada para garantir a qualidade dos componentes
Opcionais
- Chave da API Google Gemini - Para geração de áudio TTS
- Música de fundo - Arquivo BGM (se necessário)
Fluxo de Trabalho
Esta skill segue um fluxo de trabalho de 4 fases:
Fase 1: Geração de Componentes (30-45 minutos)
Gere componentes React para cada cena.
Processo:
- Leia script.json
- Consulte a skill remotion-best-practices
- Gere componentes correspondentes para cada tipo de cena
- Garanta o uso de animações spring (sem animações CSS)
- Use fitText/measureText para lidar com tamanhos de texto
Arquivos de regras: rules/component-generation.md
Guias de tipos de cena: rules/scene-types/*.md (6 arquivos)
Fase 2: Montagem do Projeto (15-20 minutos)
Crie a estrutura completa do projeto Remotion.
Processo:
- Crie a estrutura de diretórios do projeto
- Copie package.json, tsconfig.json, remotion.config.ts
- Crie o componente principal Root.tsx
- Copie componentes compartilhados (NeonBackground, Subtitle, etc.)
- Copie o arquivo de tema (theme.ts)
- Instale as dependências
Arquivos de regras: rules/project-assembly.md
Fase 3: Geração de Áudio TTS (opcional, 10-15 minutos)
Use a API Google Gemini para gerar áudio TTS.
Processo:
- Crie um script independente tts-generator.js
- Gere arquivos de áudio para cada cena
- Aplique velocidade de reprodução de 1.25x
- Gere dados de segmentação de legendas
- Salve no diretório public/audio/
Arquivos de regras: rules/tts-integration.md, rules/subtitle-generation.md
Fase 4: Visualização e Renderização (5-10 minutos)
Inicie a visualização e renderize o vídeo.
Processo:
- Inicie o servidor de visualização Remotion (
pnpm start) - Verifique o resultado no navegador
- Renderize o vídeo final (
pnpm build) - Saída: video.mp4
Arquivos de regras: rules/render-configuration.md
Início Rápido
# 1. Prepare script.json
# Supondo que já foi gerado pelo article-to-script
# 2. Consulte remotion-best-practices
Read .claude/skills/remotion-best-practices/skill.md
# 3. Consulte as regras do script-to-remotion
Read .claude/skills/script-to-remotion/rules/component-generation.md
Read .claude/skills/script-to-remotion/rules/scene-types/*.md
# 4. Gere componentes (para cada cena)
# Selecione o template e as regras de acordo com o tipo de cena
# 5. Monte o projeto
Read .claude/skills/script-to-remotion/rules/project-assembly.md
# Siga as instruções para criar a estrutura completa do projeto
# 6. Opcional: Gere TTS
Read .claude/skills/script-to-remotion/rules/tts-integration.md
# Crie e execute tts-generator.js
# 7. Instale dependências
cd video-output-<timestamp>
pnpm install
# 8. Visualize
pnpm start
# Acesse http://localhost:3000 no navegador
# 9. Renderize
pnpm build
# Saída em out/video.mp4
Principais Características
Suporte a 6 Tipos de Cena
Cada tipo de cena possui templates e animações específicos:
| Tipo de Cena | Duração | Finalidade | Características Principais |
|---|---|---|---|
| hook | 5-8s | Gancho inicial | Efeito de máquina de escrever, animação de salto |
| textDisplay | 15-20s | Exibição de informações principais | fitText adaptável, animação de deslizamento |
| numberComparison | 12-18s | Comparação de dados | Animação de números, layout de antes/depois |
| threeColumns | 15-20s | Comparação em três colunas | Exibição escalonada, sequência Series |
| caseStudy | 20-30s | História de caso | TransitionSeries, transição antes/depois |
| cta | 8-12s | Chamada para ação | Exibição em várias etapas, animação de destaque |
Animações Físicas com Spring
Todas as animações usam o motor físico spring() do Remotion:
const scale = spring({
frame,
fps,
config: { damping: 12, stiffness: 100 }
});
Proibido usar animações CSS (viola as melhores práticas do Remotion)
Texto Responsivo
Use @remotion/layout-utils para garantir a adaptação do texto:
import { fitText, measureText } from '@remotion/layout-utils';
const fittedText = fitText({
text: narration,
withinWidth: 1600,
fontFamily: 'Inter',
fontSize: 80
});
Legendas Inteligentes Segmentadas
Divida automaticamente narrações longas em legendas de fácil leitura:
- Divisão natural por pontuação
- Cada segmento com duração de 3 a 8 segundos
- Efeito de fade in/fade out (0,2 segundos)
- Sincronia perfeita com o áudio
Arquivos de Regras
Todas as regras do fluxo de trabalho estão documentadas no diretório rules/:
Regras principais:
component-generation.md- Guia de geração de componentes Reactproject-assembly.md- Estrutura e configuração do projetorender-configuration.md- Configurações de renderização do Remotiontroubleshooting.md- Solução de problemas comuns
Guias de tipos de cena (6):
scene-types/hook-scene.md- Cena de gancho inicialscene-types/text-display-scene.md- Cena de exibição de textoscene-types/number-comparison-scene.md- Cena de comparação de númerosscene-types/three-columns-scene.md- Cena de três colunasscene-types/case-study-scene.md- Cena de estudo de casoscene-types/cta-scene.md- Cena de CTA
Áudio e Legendas:
tts-integration.md- Geração de áudio TTS (opcional)subtitle-generation.md- Algoritmo de segmentação de legendas
Arquivos de Modelo
Modelos de código prontos para uso no diretório templates/:
Arquivos de configuração:
package.json.template- Dependências do projetotsconfig.json.template- Configuração TypeScriptremotion.config.ts.template- Configuração Remotiontheme.ts- Tema neon glassmorphism
Componentes compartilhados:
components/NeonBackground.tsx- Fundo gradiente dinâmicocomponents/SceneAudio.tsx- Player de áudiocomponents/Subtitle.tsx- Componente de legenda
Outros:
Root.tsx.template- Modelo do componente principaltts-generator.js.template- Script de geração TTS
Exemplos
examples/script-input.json- Script de entrada de exemploexamples/Hook-scene-example.tsx- Componente de cena Hook completoexamples/complete-project/- Referência de projeto completo
Comandos Bash
Todas as operações CLI estão documentadas em commands/bash-commands.md:
- Comandos de configuração do projeto
- Instalação de dependências
- Geração TTS (opcional)
- Visualização e renderização
- Tratamento de erros
Garantia de Qualidade
Deve seguir as melhores práticas do Remotion
Regras principais:
- ✅ Use spring() para todas as animações
- ✅ Use fitText/measureText para texto
- ✅ Componentes devem ser funções puras (sem efeitos colaterais)
- ✅ Use useCurrentFrame() e useVideoConfig() corretamente
- ❌ Não use animações ou transições CSS
- ❌ Não use useState/useEffect
- ❌ Não faça chamadas de API externas
Padrão de Qualidade dos Componentes
Cada componente gerado deve:
- Compilar sem erros no TypeScript
- Exportar o tipo correto (componente de cena)
- Props devem incluir startFrame, durationFrames, scene
- Animações suaves (60fps)
- Texto claro e legível
- Contraste de cores adequado
Solução de Problemas
Problemas comuns e soluções em rules/troubleshooting.md:
- Erros de compilação TypeScript
- Travamentos de animação
- Estouro de texto
- Problemas de sincronização de áudio
- Falha na renderização
Histórico de Versões
- v3.0.0 (2025-01): Skill puramente documental, orientada por modelos
- v2.1.0 (2024-12): Implementação orientada por CLI das Fases 4 a 8
- v1.0.0 (2024-11): Skill monolítica inicial
Suporte
Ao encontrar problemas:
- Consulte
rules/troubleshooting.mdpara problemas comuns - Veja
examples/para implementações de exemplo - Consulte a skill
remotion-best-practices - Verifique a documentação oficial do Remotion
Skills Relacionadas
- article-to-script - Upstream: gera script.json
- remotion-best-practices - Deve ser consultada: garante a qualidade dos componentes