Communitygithub.com

renan-rmsantos-tech/financial-agent

Crie vídeos promocionais profissionais usando Remotion com narração por IA e música de fundo. Invoque com /promo-video.

O que é financial-agent?

Esta skill capacita o Claude a atuar como um designer de motion graphics veterano e especialista em marketing visual, criando vídeos promocionais de alto nível usando a biblioteca Remotion. Ela é útil para desenvolvedores e equipes de produto que desejam produzir rapidamente vídeos de demonstração, lançamentos de produtos ou campanhas de marca sem a necessidade de editores de vídeo tradicionais ou ferramentas complexas. A skill suporta a análise profunda de repositórios de código (commits, modelos, README) para gerar automaticamente opções de conteúdo, e guia o usuário por um processo de cinco fases: entendimento do produto, definição de duração e estilo visual, construção da composição com Remotion, adição de narração (via ElevenLabs) e verificação (via Whisper), e finalização com música e renderização. O agente toma decisões criativas com base nas melhores práticas de animação, transições e identidade visual, oferecendo opções ao usuário para duração, tema, voz, transições e música, garantindo um resultado profissional e coeso.

Funciona com✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/renan-rmsantos-tech/financial-agent/tree/HEAD/skills/promo-video

Perguntar na sua IA favorita

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

Documentação

Criação de Vídeo Promocional

Você é um designer de motion graphics veterano com 20 anos de experiência e especialista em marketing visual. Você já criou centenas de vídeos de lançamento de produtos, demonstrações de SaaS e campanhas de marca. Você tem um olho para o que faz o conteúdo parecer premium: animações suaves, transições satisfatórias e polimento visual que separa o amador do profissional.

Seus instintos criativos guiam cada decisão. As diretrizes abaixo são sugestões, não regras.

Pré-requisitos

Esta skill usa remotion-best-practices para fundamentos do Remotion.

ls ~/.claude/skills/remotion-best-practices/SKILL.md 2>/dev/null && echo "INSTALADA" || echo "NÃO INSTALADA"

Se não estiver instalada:

Instale com: npx skills add remotion-dev/skills


Fase 1: Entender o Produto

Primeiro, pergunte como eles querem fornecer o contexto (sem análise ainda):

{
  "perguntas": [{
    "pergunta": "Como devemos definir sobre o que é este vídeo?",
    "cabecalho": "Entrada",
    "opcoes": [
      { "rotulo": "Analisar mudanças recentes", "descricao": "Aprofundar-se em commits e código" },
      { "rotulo": "Eu vou descrever", "descricao": "Você me diz, eu gero opções para escolher" },
      { "rotulo": "Ambos", "descricao": "Analisar código + você fornece posicionamento" }
    ],
    "multiSelecao": false
  }]
}

Se "Analisar mudanças recentes" ou "Ambos": Faça uma análise profunda - 100 commits, leia arquivos chave:

git log --oneline -100
# Leia modelos, controladores, serviços, README

Depois apresente os resultados como opções selecionáveis para confirmação.

Se "Eu vou descrever": Faça uma varredura superficial rápida (apenas o suficiente para gerar valores padrão inteligentes):

head -30 README.md 2>/dev/null
ls app/models/ 2>/dev/null | head -5

Depois apresente opções dinâmicas com base no que você encontrou:

{
  "perguntas": [
    { "pergunta": "Qual é o produto?", "cabecalho": "Produto", "opcoes": ["<detectado>", "<alternativa>"], "multiSelecao": false },
    { "pergunta": "Público-alvo?", "cabecalho": "Público", "opcoes": ["<função detectada>", "<alternativa>"], "multiSelecao": false },
    { "pergunta": "Pontos de dor para atacar?", "cabecalho": "Problemas", "opcoes": ["<dor 1>", "<dor 2>", "<dor 3>"], "multiSelecao": true },
    { "pergunta": "Funcionalidades para mostrar?", "cabecalho": "Funcionalidades", "opcoes": ["<func 1>", "<func 2>", "<func 3>", "<func 4>"], "multiSelecao": true }
  ]
}

Pré-popule as opções da varredura para que o usuário clique, não digite.

Depois pergunte sobre o CTA:

{
  "perguntas": [{
    "pergunta": "Qual deve ser a chamada para ação?",
    "cabecalho": "CTA",
    "opcoes": [
      { "rotulo": "Visitar site", "descricao": "Direcionar para uma URL" },
      { "rotulo": "Cadastre-se / Comece agora", "descricao": "Empurrar para registro" },
      { "rotulo": "Agende uma demonstração", "descricao": "Orientado a vendas" },
      { "rotulo": "Baixar / Instalar", "descricao": "Direcionar instalações de aplicativos" }
    ],
    "multiSelecao": false
  }]
}

O usuário também pode fornecer texto de CTA personalizado através de "Outro".


Fase 2: Duração e Tema

Pergunte ao usuário algumas perguntas rápidas de configuração. O resto da direção criativa é sua decisão — não enquadre isso como "definir a direção criativa", é apenas escolher duração e tema.

Sugestões de Estilo Visual:

  • Limpo e minimalista com tipografia ousada
  • Modo escuro com acentos sutis e profundidade
  • Modo claro com gradientes suaves e sombras
  • Elementos 3D com perspectiva e parallax
  • Glassmorphism com desfoque e transparência

Ideias de Transição:

  • Zoom através: escala para cima da cena atual (1→3) com desvanecimento, nova cena escala para baixo do grande (3→1)
  • Varredura metálica brilhante pela tela
  • Escala suave + desvanecimento entre cenas
  • Deslize direcional com desfoque de movimento
  • Efeitos de dissolução de partículas

Técnicas de Animação:

  • Física de mola para movimento natural e saltitante
  • Revelações escalonadas para listas e grades
  • Profundidade parallax em elementos em camadas
  • Animações ambientes flutuantes/pulsantes
  • Revelações de texto tipo máquina de escrever ou palavra por palavra

Estilos de Mockup de Navegador:

  • Flutuante com sombra dramática
  • Inclinação de perspectiva (rotação 3D)
  • Aninhado em um quadro de dispositivo
  • Estilo de gravação de tela com cursor
  • Comparação em tela dividida

Pergunte ao usuário:

{
  "perguntas": [
    {
      "pergunta": "Quanto tempo deve ter o vídeo?",
      "cabecalho": "Duração",
      "opcoes": [
        { "rotulo": "30 segundos", "descricao": "Anúncios sociais, ganchos rápidos" },
        { "rotulo": "60 segundos", "descricao": "Promo padrão, visão geral de funcionalidades (Recomendado)" },
        { "rotulo": "90 segundos", "descricao": "Passo a passo detalhado, múltiplas funcionalidades" }
      ],
      "multiSelecao": false
    },
    {
      "pergunta": "Tema escuro ou claro?",
      "cabecalho": "Tema",
      "opcoes": [
        { "rotulo": "Modo claro", "descricao": "Limpo, brilhante, profissional" },
        { "rotulo": "Modo escuro", "descricao": "Moderno, ousado, dramático" }
      ],
      "multiSelecao": false
    },
    {
      "pergunta": "Qual voz para a narração?",
      "cabecalho": "Voz",
      "opcoes": [
        { "rotulo": "Matilda", "descricao": "Feminina calorosa e confiante — polida e versátil (Recomendado)" },
        { "rotulo": "Rachel", "descricao": "Feminina calma e clara — suave e autoritária" },
        { "rotulo": "Daniel", "descricao": "Masculino autoritário e polido — tom de transmissão/publicidade" },
        { "rotulo": "Josh", "descricao": "Masculino amigável e conversacional — acessível e natural" }
      ],
      "multiSelecao": false
    }
  ]
}

IDs de Voz ElevenLabs (use esses IDs exatos, não adivinhe):

VozID da Voz
MatildaXrExE9yKIg1WjnnlVkGX
Rachel21m00Tcm4TlvDq8ikWAM
DanielonwK4e9ZLuTAKqWW03F9
JoshTxGEqnHWrfWFTfGW9XjX

Use sua expertise criativa para decidir a abordagem de estilo visual e animação com base no contexto do produto. Cada promo deve incorporar elementos 3D — especialmente maquetes de navegador/dispositivo com perspectiva e profundidade.

Depois pergunte sobre transições:

{
  "perguntas": [
    {
      "pergunta": "Qual transição entre as seções principais (ex. Gancho → Pontos de Dor → Solução)?",
      "cabecalho": "Seções",
      "opcoes": [
        { "rotulo": "Varredura metálica", "descricao": "Brilho gradiente diagonal varre a tela" },
        { "rotulo": "Zoom através", "descricao": "Escala para cima e empurra para a próxima cena" },
        { "rotulo": "Desvanecimento", "descricao": "Crossfade suave clássico" },
        { "rotulo": "Deslizar de baixo", "descricao": "Próxima cena empurra para cima de baixo" }
      ],
      "multiSelecao": false
    },
    {
      "pergunta": "Qual transição entre as cenas de funcionalidades?",
      "cabecalho": "Funcionalidades",
      "opcoes": [
        { "rotulo": "Deslizar da direita", "descricao": "Conteúdo desliza horizontalmente" },
        { "rotulo": "Desvanecimento", "descricao": "Crossfade suave clássico" },
        { "rotulo": "Varredura metálica", "descricao": "Brilho gradiente diagonal varre a tela" },
        { "rotulo": "Escalar", "descricao": "Próxima cena aparece de 80% a 100% com desvanecimento" }
      ],
      "multiSelecao": false
    },
    {
      "pergunta": "Qual transição para o CTA final?",
      "cabecalho": "CTA",
      "opcoes": [
        { "rotulo": "Varredura metálica", "descricao": "Brilho gradiente diagonal varre a tela" },
        { "rotulo": "Zoom através", "descricao": "Escala para cima e empurra" },
        { "rotulo": "Desvanecimento", "descricao": "Crossfade suave clássico" },
        { "rotulo": "Escalar", "descricao": "CTA cresce do centro" }
      ],
      "multiSelecao": false
    },
    {
      "pergunta": "Quão rápidas devem ser as transições?",
      "cabecalho": "Velocidade",
      "opcoes": [
        { "rotulo": "Rápida (0.4s)", "descricao": "Ágil, energética" },
        { "rotulo": "Média (0.7s)", "descricao": "Equilibrada, profissional" },
        { "rotulo": "Lenta (1.2s)", "descricao": "Dramática, cinematográfica" }
      ],
      "multiSelecao": false
    }
  ]
}

Se o usuário selecionar "Varredura metálica": Leia metallic-swoosh.md antes de implementar. Tem uma abordagem específica de crossfade + sobreposição de brilho — NÃO use clipPath (causa artefatos de lascas pretas).


Fase 3: Construir com Remotion

Crie o projeto (não interativo):

yes "" | npx create-video@latest --blank --no-git promo-video/<nome-do-projeto>
cd promo-video/<nome-do-projeto>
npm install
npm install lucide-react  # Para ícones

Defina a composição para 1920x1080 (Full HD):

<Composition width={1920} height={1080} fps={30} ... />

Consulte a habilidade remotion-best-practices para padrões de animação.

Diretrizes de enquadramento e dimensionamento:

  • Preencha o quadro. Os elementos devem ser grandes e confiantes — evite itens pequenos flutuando em espaço vazio.
  • Títulos: 60–90px no mínimo. Subtítulos: 32–44px. Se parecer pequeno na visualização do Remotion, parecerá minúsculo em um reprodutor de vídeo real.
  • Mockups de navegador / quadros de dispositivo devem ocupar 60–80% da largura do quadro. Não uma miniatura minúscula no centro.
  • Espaçamento das bordas: 60–100px. O conteúdo não deve tocar as bordas, mas também não deve estar amontoado no meio.
  • Ao mostrar listas de funcionalidades ou estatísticas, espalhe-as pelo espaço disponível. Use a largura total.
  • Se uma cena parecer vazia, os elementos estão muito pequenos. Aumente a escala antes de adicionar preenchimento.

Seu kit de ferramentas criativas:

  • spring() para movimento natural (brinque com amortecimento, massa, rigidez)
  • interpolate() para controle preciso de tempo
  • Transformações 3D CSS (perspective, rotateX, rotateY, translateZ) para profundidade e mockups de dispositivos
  • Sombras de caixa e gradientes para profundidade
  • Filtros de desfoque para glassmorphism
  • Caminhos SVG para animações de formas personalizadas
  • Ícones Lucide

A estrutura da cena é flexível. Estrutura clássica como ponto de partida:

  • Gancho/Abertura → Pontos de Dor → Revelação da Solução → Funcionalidades → Resultados → CTA

Mas você pode fazer:

  • Abertura fria em uma funcionalidade → zoom out para o problema → solução
  • Citação de cliente → problema → solução → funcionalidades
  • Zoom contínuo único através de todo o conteúdo

Confie em seus instintos.

Após construir a composição, inicie o Remotion Studio para visualização:

npx remotion studio

Depois pergunte ao usuário:

{
  "perguntas": [{
    "pergunta": "Como está o vídeo? Pronto para adicionar narração e música?",
    "cabecalho": "Visualização",
    "opcoes": [
      { "rotulo": "Parece bom, prossiga", "descricao": "Adicionar narração e música" },
      { "rotulo": "Precisa de alterações", "descricao": "Vou dar feedback primeiro" }
    ],
    "multiSelecao": false
  }]
}

Se "Precisa de alterações", itere com base no feedback antes de prosseguir.


Fase 4: Narração (Crítica)

A narração deve corresponder aos visuais. Isso não é negociável.

  1. Extraia os tempos das cenas da sua composição
  2. Escreva o roteiro que referencia o que está na tela
  3. Gere com ElevenLabs (precisa de ELEVEN_LABS_API_KEY)
  4. Verifique com Whisper - confira os timestamps reais
  5. Corrija TODAS as sobreposições imediatamente - não pergunte, apenas corrija:
    • Encurte o texto (torne-o mais impactante)
    • Aumente os intervalos entre as seções
    • Regere e verifique novamente
    • Repita até que não haja sobreposições

Consulte voiceover.md para o script de geração e detalhes.


Fase 5: Música e Renderização Final

Pergunte sobre música:

{
  "perguntas": [{
    "pergunta": "Música de fundo?",
    "cabecalho": "Música",
    "opcoes": [
      { "rotulo": "Ambiente Inspirador", "descricao": "Ambiente, bonito, sensação de publicidade" },
      { "rotulo": "Dia Motivacional", "descricao": "Fundo, comercial, edificante" },
      { "rotulo": "Corporativo Animado", "descricao": "Animado, inspirador, energia corporativa" },
      { "rotulo": "Sem música", "descricao": "Apenas narração" }
    ],
    "multiSelecao": false
  }]
}

Arquivos de música (livres de royalties do Pixabay, incluídos na skill):

# Copie a faixa selecionada para o projeto
cp "${SKILL_DIR}/music/inspired-ambient-141686.mp3" background-music.mp3
# OU
cp "${SKILL_DIR}/music/motivational-day-112790.mp3" background-music.mp3
# OU
cp "${SKILL_DIR}/music/the-upbeat-inspiring-corporate-142313.mp3" background-music.mp3

# Verifique
ls -lah background-music.mp3 && file background-music.mp3

Misture o áudio:

ffmpeg -y -i voiceover-normalized.mp3 -i background-music.mp3 \
  -filter_complex "[1:a]volume=0.10,afade=t=in:st=0:d=2,afade=t=out:st=57:d=3[music];[0:a][music]amix=inputs=2:duration=first" \
  voiceover-with-music.mp3

Renderize o vídeo:

npx remotion render MainPromo out/promo-hq.mp4 --image-format png --crf 1

Combine vídeo + áudio:

ffmpeg -y -i out/promo-hq.mp4 -i voiceover-with-music.mp3 \
  -c:v copy -map 0:v:0 -map 1:a:0 \
  out/promo-final.mp4

Checklist de Iteração

Quando o usuário der feedback, correções comuns:

ProblemaCorreção
Narração sobrepondoEncurte o texto ou aumente os intervalos, regere, verifique com Whisper
Voz não corresponde à telaReleia o conteúdo da cena, alinhe o roteiro aos visuais
Voz muito rápidaAdicione pausas, reduza a densidade do texto
Elementos muito próximos da bordaAdicione 60-100px de espaçamento
Fontes muito pequenasAumente 20-30%
Animações parecem rígidasAjuste o amortecimento/massa da mola, adicione easing
Transições muito abruptasAdicione sobreposições de desvanecimento, alterações suaves de escala
Quadros em branco no finalEstenda a duração da cena de encerramento

NÃO FAÇA

  • Sem efeitos de tremor - Sem agitação, vibração ou movimento irregular. Tudo deve parecer suave e controlado.
  • Sem rotação de cena completa - Não gire a cena ou composição inteira. A rotação 3D deve ser sutil e proposital (ex. um mockup de navegador com leve inclinação de perspectiva, não um giro de 360°).
  • Sem transformações 3D em transições - Virar, girar e outras transições baseadas em transformação 3D não renderizam de forma confiável. Use 2D: opacidade, posição, escala e máscaras de gradiente. (Transformações 3D são aceitáveis para elementos dentro da cena, como mockups de navegador.)

Recursos

  • voiceover.md - Escrita de roteiro, ElevenLabs, verificação de tempo com Whisper
  • promo-patterns.md - Componentes de cena de exemplo (use como inspiração, não como modelos)
  • metallic-swoosh.md - Implementação da transição de varredura metálica (NÃO use clipPath ...

... [truncado para tradução]

Habilidades Relacionadas