Communitygithub.com

joyehuang/skills

Converta roteiros de vídeo em projetos Remotion prontos para produção, com componentes React, áudio e renderização.

O que é skills?

Esta skill converte um script.json estruturado em um projeto Remotion funcional, gerando componentes React para cada cena, integrando opcionalmente áudio TTS via API Gemini do Google e legendas inteligentes. O fluxo de trabalho é dividido em quatro fases: geração de componentes, montagem do projeto, geração de áudio TTS (opcional) e renderização final. A skill segue práticas recomendadas do Remotion, como uso de animações spring() e texto responsivo com fitText/measureText. Suporta 6 tipos de cena (hook, textDisplay, numberComparison, threeColumns, caseStudy, cta) com modelos e animações específicos. É útil para transformar scripts textuais em vídeos prontos para produção, mas não deve ser usada para editar vídeos existentes ou criar conteúdo interativo. Depende de Node.js 18+ e pnpm, e requer referência à skill remotion-best-practices para garantir qualidade dos componentes.

Funciona com✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/joyehuang/skills/tree/HEAD/script-to-remotion

Perguntar na sua IA favorita

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

Documentação

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:

  1. Leia script.json
  2. Consulte a skill remotion-best-practices
  3. Gere componentes correspondentes para cada tipo de cena
  4. Garanta o uso de animações spring (sem animações CSS)
  5. 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:

  1. Crie a estrutura de diretórios do projeto
  2. Copie package.json, tsconfig.json, remotion.config.ts
  3. Crie o componente principal Root.tsx
  4. Copie componentes compartilhados (NeonBackground, Subtitle, etc.)
  5. Copie o arquivo de tema (theme.ts)
  6. 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:

  1. Crie um script independente tts-generator.js
  2. Gere arquivos de áudio para cada cena
  3. Aplique velocidade de reprodução de 1.25x
  4. Gere dados de segmentação de legendas
  5. 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:

  1. Inicie o servidor de visualização Remotion (pnpm start)
  2. Verifique o resultado no navegador
  3. Renderize o vídeo final (pnpm build)
  4. 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 CenaDuraçãoFinalidadeCaracterísticas Principais
hook5-8sGancho inicialEfeito de máquina de escrever, animação de salto
textDisplay15-20sExibição de informações principaisfitText adaptável, animação de deslizamento
numberComparison12-18sComparação de dadosAnimação de números, layout de antes/depois
threeColumns15-20sComparação em três colunasExibição escalonada, sequência Series
caseStudy20-30sHistória de casoTransitionSeries, transição antes/depois
cta8-12sChamada para açãoExibiçã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 React
  • project-assembly.md - Estrutura e configuração do projeto
  • render-configuration.md - Configurações de renderização do Remotion
  • troubleshooting.md - Solução de problemas comuns

Guias de tipos de cena (6):

  • scene-types/hook-scene.md - Cena de gancho inicial
  • scene-types/text-display-scene.md - Cena de exibição de texto
  • scene-types/number-comparison-scene.md - Cena de comparação de números
  • scene-types/three-columns-scene.md - Cena de três colunas
  • scene-types/case-study-scene.md - Cena de estudo de caso
  • scene-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 projeto
  • tsconfig.json.template - Configuração TypeScript
  • remotion.config.ts.template - Configuração Remotion
  • theme.ts - Tema neon glassmorphism

Componentes compartilhados:

  • components/NeonBackground.tsx - Fundo gradiente dinâmico
  • components/SceneAudio.tsx - Player de áudio
  • components/Subtitle.tsx - Componente de legenda

Outros:

  • Root.tsx.template - Modelo do componente principal
  • tts-generator.js.template - Script de geração TTS

Exemplos

  • examples/script-input.json - Script de entrada de exemplo
  • examples/Hook-scene-example.tsx - Componente de cena Hook completo
  • examples/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.md para 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

Habilidades Relacionadas