Foto de Weslley Alves@eu.weslleyalves Weslley Alves · Método MAC
Recursos gratuitos / Efeitos de vídeo

Seu vídeo.
Um efeito de cada vez.

Aqui está o guia para instalar a skill original de efeitos de vídeo, fazer o primeiro teste e pedir os próximos efeitos em português.

Skill de @vibha.in.progress · Guia por Weslley Alves · Atualizado em 26/10/2026

Comece com um trecho curto.

Uma skill reúne instruções e arquivos que ajudam a IA a executar uma tarefa. Esta inclui scripts de Python para aplicar efeitos ao vídeo, com detecção de rosto e recorte da pessoa.

  1. Use o Claude Code com acesso a arquivos e terminal. Colar o link em uma conversa comum não instala o projeto. O caminho para Codex está separado abaixo.
  2. Crie uma pasta chamada meus-efeitos e abra essa pasta como projeto na ferramenta. Faça a instalação a partir dela.
  3. Separe uma cópia de um vídeo vertical curto, com boa luz e seu rosto visível. Um trecho de 5 a 10 segundos facilita o primeiro teste.

O resultado do código preserva a proporção do vídeo de entrada e normalmente mantém o áudio original. Converter para Reels, retirar voz ou adicionar música são pedidos separados — há um prompt para isso no final.

Instale no Claude Code.

Abaixo usamos uma instalação só neste projeto; o README também oferece a pasta global ~/.claude/skills/effects. Escolha uma das duas para evitar cópias duplicadas.

  1. Confira Git, Python e FFmpeg

    Abra o terminal integrado na pasta meus-efeitos. Git baixa o repositório, Python roda os scripts e FFmpeg lê e exporta o vídeo.

    Windows · conferir os programas
    git --version
    py -3.12 --version
    ffmpeg -version
    ffprobe -version

    Se faltarem: instale Git, Python 3.12 e FFmpeg. No Windows, inclua Python e FFmpeg no PATH e reabra o terminal. No macOS, com Homebrew instalado, use brew install git python@3.12 ffmpeg. No Linux, instale Git, Python 3.10 ou superior, o pacote de ambiente virtual e FFmpeg pelo gerenciador da sua distribuição.

  2. Baixe a pasta completa da skill

    Não copie apenas o SKILL.md: os efeitos dependem de scripts, modelos e fontes. Se a pasta de destino já existir, pare e confira a instalação em vez de sobrescrevê-la.

    Windows · instalar no projeto
    New-Item -ItemType Directory -Force -Path ".claude/skills" | Out-Null
    git clone https://github.com/Vibha-Ramprakash/claude-video-effects.git ".claude/skills/effects"
    macOS e Linux · instalar no projeto
    mkdir -p .claude/skills
    git clone https://github.com/Vibha-Ramprakash/claude-video-effects.git .claude/skills/effects

    Sem Git: no repositório original, escolha Code → Download ZIP, extraia e copie a pasta inteira para .claude/skills/effects. O arquivo deve ficar em .claude/skills/effects/SKILL.md, sem outra pasta entre eles.

  3. Prepare o ambiente

    Continue em Preparar as dependências. Depois volte à raiz do projeto, reinicie o Claude Code e abra uma nova conversa.

Instalar com ajuda do Claude Code
Instale a skill original de efeitos de vídeo de https://github.com/Vibha-Ramprakash/claude-video-effects na pasta .claude/skills/effects deste projeto. Antes de executar, leia o README, o SKILL.md, o requirements.txt e o script de instalação. Preserve os arquivos e as licenças originais. Confira Git, Python, ffmpeg e ffprobe. No Windows, crie o ambiente virtual com Python 3.12 e use .venv\Scripts\python.exe; o setup.sh original usa caminhos Unix. Não sobrescreva uma instalação existente. Configure as dependências, confira os modelos e as fontes e rode scripts/fx.py --list. Diga o que foi instalado e qualquer erro real. Não processe meus vídeos ainda.

Prefere usar o Codex?

O repositório é apresentado para Claude Code. O caminho abaixo adapta a pasta de descoberta para o Codex, mantendo os arquivos originais. Ainda não foi validado de ponta a ponta no Codex. Use o teste de instalação e o frame de conferência antes de depender dele em um projeto.

  1. Abra meus-efeitos como projeto no Codex.
  2. Instale o repositório completo na pasta de skills do projeto:
Codex · Windows PowerShell
New-Item -ItemType Directory -Force -Path ".agents/skills" | Out-Null
git clone https://github.com/Vibha-Ramprakash/claude-video-effects.git ".agents/skills/effects"
Codex · macOS e Linux
mkdir -p .agents/skills
git clone https://github.com/Vibha-Ramprakash/claude-video-effects.git .agents/skills/effects

Confirme que existe .agents/skills/effects/SKILL.md. Faça a preparação abaixo usando essa pasta, volte à raiz, abra uma nova conversa no Codex e mencione $effects. Se não aparecer, informe o caminho completo do SKILL.md e peça para ler e executar os scripts diretamente; isso não confirma descoberta automática.

Usar no Codex · adaptação
Use a skill effects instalada em .agents/skills/effects neste projeto. Leia seu SKILL.md e execute os scripts a partir do caminho absoluto dessa pasta. Adapte apenas os comandos de terminal ao meu sistema, preservando o código original. No Windows, use .venv\Scripts\python.exe; em macOS/Linux, .venv/bin/python. Comece com scripts/fx.py --list. Depois, use meu vídeo para gerar um frame de backdrop-word aos 2 segundos, com o texto IDEIA. Não dê zoom, não cubra o rosto e não altere o vídeo original. Informe se a descoberta da skill, a instalação ou a renderização falhou; não afirme que o teste passou sem executar.

Como o Codex descobre skills · documentação oficial

Prepare as dependências.

Escolha o bloco do seu sistema. A pasta effects precisa conter scripts, models, fonts e requirements.txt.

Windows · PowerShell

Na raiz do projeto, entre na pasta correspondente à sua instalação:

Entrar na skill · escolha UMA linha
# Claude Code
Set-Location ".claude/skills/effects"

# OU Codex
# Set-Location ".agents/skills/effects"

Em seguida, execute o bloco abaixo. Usamos o Python do ambiente diretamente; não é necessário ativar scripts do PowerShell nem alterar a política de execução.

Windows · criar o ambiente e listar os efeitos
# Execute na pasta effects que você acabou de instalar.
py -3.12 -m venv .venv
if ($LASTEXITCODE -ne 0) { throw "Não foi possível criar o ambiente com Python 3.12." }
& ".\.venv\Scripts\python.exe" -m pip install -r requirements.txt
if ($LASTEXITCODE -ne 0) { throw "A instalação das dependências falhou. Confira o erro acima." }
& ".\.venv\Scripts\python.exe" -c "import mediapipe, cv2, PIL, numpy; print('Dependências prontas')"
& ".\.venv\Scripts\python.exe" scripts/fx.py --list

O setup.sh original usa .venv/bin/python. Esse caminho não corresponde ao ambiente virtual nativo do Windows; por isso este guia usa .venv\Scripts\python.exe.

macOS e Linux · Terminal
Entrar e preparar · Claude Code
cd .claude/skills/effects
bash scripts/setup.sh
.venv/bin/python scripts/fx.py --list

No Codex, troque a primeira linha por cd .agents/skills/effects. Aguarde a mensagem READY. Se aparecer NEED_FFMPEG ou NEED_PYTHON, instale o programa indicado, reabra o terminal e execute novamente.

A lista de efeitos no terminal confirma que o script carrega. Ela não confirma detecção de rosto ou renderização; faça o teste com vídeo abaixo. A instalação pode baixar pacotes; o tempo varia conforme o computador e a conexão.

Faça o primeiro teste.

  1. Volte à raiz do projeto e abra uma nova conversa no Claude Code. Anexe seu vídeo ou informe o caminho absoluto entre aspas. No Codex, use o prompt de adaptação.
  2. Copie o pedido abaixo e ajuste o texto e os segundos para o seu vídeo.
  3. Confira a imagem antes do render: rosto livre, máscara correta, texto legível e margens suficientes.
  4. Abra o MP4 exportado e veja o trecho inteiro. O vídeo original deve continuar intacto.
Seu primeiro efeito
/effects backdrop-word de 1 a 3 segundos, com o texto IDEIA atrás da minha cabeça. Use o vídeo que anexei. Preserve o enquadramento, a proporção e o áudio original. Não aplique zoom nem recorte no rosto. Gere primeiro um frame de conferência aos 2 segundos. Confira se o rosto está livre e o texto cabe na tela; depois renderize em um novo MP4. Não altere o original.
Teste pelo terminal · Windows

Execute dentro da pasta effects. Troque os caminhos de exemplo pelos seus. O vídeo precisa ter mais de 3 segundos.

Gerar um frame aos 2 segundos
& ".\.venv\Scripts\python.exe" scripts/fx.py backdrop-word "C:/Videos/meu-video.mp4" "C:/Videos/conferencia.png" --start 1 --end 3 --text "IDEIA" --still 2 --width 540
Depois de conferir · exportar o vídeo
& ".\.venv\Scripts\python.exe" scripts/fx.py backdrop-word "C:/Videos/meu-video.mp4" "C:/Videos/meu-video_efeito.mp4" --start 1 --end 3 --text "IDEIA"

No macOS/Linux, use .venv/bin/python e os caminhos do seu computador. O parâmetro --width 540 reduz apenas a conferência; o exportador usa 1080 como lado curto por padrão.

Escolha o efeito pelo resultado.

Para começar, teste backdrop-word, spotlight e glass-widgets. Use janelas curtas de 1,5 a 4 segundos e altere uma coisa de cada vez.

Alguns efeitos aproximam a câmera. Se quiser preservar o enquadramento, evite lean-in, locked-on, headline-box e slow-push, e peça uma conferência dos demais.

Ver os 42 nomes e o que cada um faz
ComandoResultado visual
noiseVídeos empilhados atrás da pessoa
lineupCartões numerados acima da cabeça
locked-onMoldura que acompanha o rosto; inclui aproximação
orbitCartões em órbita ao redor da pessoa
lean-inAproximação rápida em um momento
backdrop-wordUma palavra grande atrás da pessoa
spotlightFundo escuro e pessoa em destaque
the-billTexto aparecendo como um recibo
moodyTratamento de cor
swipeComparação de antes e depois
todoLista de tarefas ao lado da pessoa
comment-boxAnimação de um comentário; não publica comentário real
tapAnimação de um botão Seguir
pause-pointQuadro congelado com indicação visual
uninstallBarra de remoção com distorção visual
reel-frameVídeo dentro de uma moldura de Reel
shortcut-rainTeclas caindo atrás da pessoa
reject-stampCarimbo de destaque
countdown-flipContagem regressiva
rabbit-holeCena em túnel com movimento
cover-starComposição de capa de revista
scribbleTraços desenhados ao redor da pessoa
glass-widgetsElementos com aparência de vidro
red-collageColagem em preto, branco e vermelho
split-headlineTítulo e vídeo dividindo a tela
pastel-wordFundo suave e palavra em destaque
check-pillsItens com marcação visual
timelineLinha do tempo de edição ilustrativa
headline-boxTítulo em caixa; inclui aproximação
profile-wallMural com seus próprios conteúdos
tier-listLista organizada em níveis
broll-splitVídeo de apoio e pessoa em tela dividida
phone-fanCartões de vídeos em leque
dot-revealImagem revelada por pontos
headline-wallMural com seus títulos
checklistEtapas de uma tarefa sendo concluídas
liquid-glass-graphGráfico e contador ilustrativos; forneça dados reais
carousel-spinCartões em rotação
match-cutPáginas alternadas em torno de uma palavra
apple-togglesInterruptores animados
led-signTexto luminoso atrás da pessoa
slow-pushAproximação lenta com fundo desfocado

Os nomes dos efeitos ficam em inglês; você pode dar as instruções e os textos do vídeo em português. Contadores e gráficos são elementos visuais, não provas de resultados. Use somente números reais que você tenha fornecido.

Copie, ajuste e teste.

Troque os textos, o caminho do vídeo e os segundos antes de enviar. Os botões copiam o pedido completo; se o navegador bloquear a cópia, use “Selecionar texto”.

Baixar todos os prompts em TXT

Destaque de luz

Destaque de luz
/effects spotlight de 1 a 4 segundos, com a palavra FOCO atrás de mim. Desative a aproximação usando push=0. Preserve as proporções e o enquadramento. Confira um frame aos 2 segundos antes de renderizar e ajuste o recorte da pessoa se aparecerem falhas. Salve um novo arquivo sem substituir o original.

Cartões de vidro

Cartões de vidro
/effects glass-widgets de 1 a 4 segundos, usando look=simple. Use meu nome, meu @ e apenas informações que eu fornecer. Não invente seguidores, receita ou resultados. Preserve meu enquadramento e não aproxime meu rosto. Mostre um frame de conferência antes de renderizar; se o efeito aplicar aproximação, ajuste o efeito e explique a alteração.

Três efeitos em sequência

Três efeitos em sequência
Use a skill effects no vídeo anexado. De 1 a 3 segundos: backdrop-word com o texto IDEIA. De 4 a 6 segundos: spotlight com o texto FOCO e push=0. De 7 a 9 segundos: checklist com os itens Planejar, Gravar e Revisar. Se o vídeo tiver menos de 10 segundos, ajuste os intervalos antes de renderizar. Não aplique zoom, não corte meu rosto e não invente métricas. Gere frames de conferência no meio de cada efeito, revise rosto, texto e margens e só então exporte um novo MP4. Preserve o áudio original nesta etapa.

Corrigir o resultado

Corrigir o resultado
Revise o último render. O problema é: [descreva o erro e o segundo em que aparece]. Corrija apenas esse trecho. Confira máscara da pessoa, posição e tamanho do texto, bordas e enquadramento. Gere um frame antes e outro depois da correção para comparar. Preserve a duração, a proporção e o áudio, e exporte com outro nome para não perder a versão anterior.

Preparar para Reels e trocar o áudio

Preparar para Reels e trocar o áudio
Prepare o vídeo com efeitos para Reels em 1080x1920, proporção 9:16. Não dê zoom no meu rosto. Se a origem for horizontal, componha o quadro com margens ou fundo, sem esticar nem fazer corte agressivo. Remova o áudio original e use somente a música que anexei, depois de confirmar que a licença permite esta publicação. Não baixe uma música sem fonte e licença verificáveis. Ajuste volume e fades. Exporte MP4 H.264, yuv420p, áudio AAC e faststart. Confira duração, dimensões, enquadramento e faixa de áudio do arquivo final. Não publique automaticamente.

Se algo não funcionar.

A skill não aparece na ferramenta

Confira se SKILL.md está diretamente em .claude/skills/effects ou .agents/skills/effects, dentro do projeto aberto. Não deixe a pasta extra do ZIP entre effects e SKILL.md. Abra uma nova conversa. No Codex, a adaptação ainda precisa de teste completo; peça a leitura pelo caminho absoluto se a descoberta falhar.

“git”, “py”, “ffmpeg” ou “ffprobe” não é reconhecido

Instale o programa que falta, confira o PATH e feche e abra o terminal. No Windows, o comando py -3.12 exige Python 3.12 instalado. FFmpeg e ffprobe devem estar acessíveis no mesmo terminal usado pela ferramenta.

“Destination path already exists”

A pasta já existe. Não apague nem sobrescreva sem conferir o conteúdo. Peça à ferramenta que examine a instalação atual. Para atualizar um clone sem alterações locais, use git pull dentro da pasta effects; se houver mudanças, preserve-as antes de atualizar.

Erro em .venv/bin/python no Windows

Você está usando o caminho Unix do instalador. Use o bloco de dependências do Windows deste guia e execute o Python em .venv\Scripts\python.exe. Não é necessário liberar a política de scripts para isso.

Erro ao carregar modelos, fontes ou pacotes

Confirme que baixou a pasta inteira, inclusive models e fonts. Use o Python do ambiente virtual para instalar requirements.txt e executar fx.py. Copie a mensagem completa para a ferramenta investigar; não baixe modelos de links aleatórios nem use outra versão de Python sem conferir compatibilidade.

Texto cobre o rosto ou o recorte fica ruim

Peça um frame no segundo do erro. Reduza o texto, mude a posição ou escolha outro efeito. Cabelo, mãos, pouca luz e fundos complexos podem exigir ajustes. Preserve uma versão anterior e confira o MP4 inteiro depois da correção.

O vídeo ficou horizontal, com voz ou sem música

O exportador mantém a proporção da entrada e normalmente preserva o áudio. Use o prompt “Preparar para Reels e trocar o áudio”. Música e legendas são uma etapa adicional; confira a licença da trilha antes da publicação.

O resultado não está igual ao Reel da autora

O projeto disponibiliza versões iniciais dos efeitos. A edição de referência também tem ajustes manuais de tempo e som. Este guia não promete reprodução idêntica nem substitui a revisão do vídeo.

Projeto original, guia em português.

A skill e seus efeitos são de Vibha Ramprakash · @vibha.in.progress. A curadoria e os prompts em português deste guia são de Weslley Alves / Método MAC.

Fontes conferidas em 26/10/2026. Versão de referência: d675cff93cb3. Os comandos de instalação baixam a versão atual do projeto, que pode mudar.

Verificação local deste guia: instalação das dependências em ambiente isolado Windows/Python 3.12 e carregamento da lista de efeitos. Isso não representa um teste completo em cada editor ou sistema. O caminho do Codex é uma adaptação de instalação, sem validação completa de renderização no editor.

O código original não foi modificado nem reempacotado como uma skill própria. Material independente, sem vínculo com Anthropic ou OpenAI.

Continue nos recursos gratuitos.

Quer implementar uma automação ou IA no seu negócio?

Clique no botão abaixo e agende uma consultoria gratuita de 30 minutos comigo.