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.
- 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.
- Crie uma pasta chamada
meus-efeitose abra essa pasta como projeto na ferramenta. Faça a instalação a partir dela. - 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.
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.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.Prepare o ambiente
Continue em Preparar as dependências. Depois volte à raiz do projeto, reinicie o Claude Code e abra uma nova conversa.
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.
- Abra
meus-efeitoscomo projeto no Codex. - Instale o repositório completo na pasta de skills do projeto:
New-Item -ItemType Directory -Force -Path ".agents/skills" | Out-Null git clone https://github.com/Vibha-Ramprakash/claude-video-effects.git ".agents/skills/effects"
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.
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.
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:
# 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.
# 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 --listO 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
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.
- 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.
- Copie o pedido abaixo e ajuste o texto e os segundos para o seu vídeo.
- Confira a imagem antes do render: rosto livre, máscara correta, texto legível e margens suficientes.
- Abra o MP4 exportado e veja o trecho inteiro. O vídeo original deve continuar intacto.
/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.
& ".\.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
& ".\.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
| Comando | Resultado visual |
|---|---|
noise | Vídeos empilhados atrás da pessoa |
lineup | Cartões numerados acima da cabeça |
locked-on | Moldura que acompanha o rosto; inclui aproximação |
orbit | Cartões em órbita ao redor da pessoa |
lean-in | Aproximação rápida em um momento |
backdrop-word | Uma palavra grande atrás da pessoa |
spotlight | Fundo escuro e pessoa em destaque |
the-bill | Texto aparecendo como um recibo |
moody | Tratamento de cor |
swipe | Comparação de antes e depois |
todo | Lista de tarefas ao lado da pessoa |
comment-box | Animação de um comentário; não publica comentário real |
tap | Animação de um botão Seguir |
pause-point | Quadro congelado com indicação visual |
uninstall | Barra de remoção com distorção visual |
reel-frame | Vídeo dentro de uma moldura de Reel |
shortcut-rain | Teclas caindo atrás da pessoa |
reject-stamp | Carimbo de destaque |
countdown-flip | Contagem regressiva |
rabbit-hole | Cena em túnel com movimento |
cover-star | Composição de capa de revista |
scribble | Traços desenhados ao redor da pessoa |
glass-widgets | Elementos com aparência de vidro |
red-collage | Colagem em preto, branco e vermelho |
split-headline | Título e vídeo dividindo a tela |
pastel-word | Fundo suave e palavra em destaque |
check-pills | Itens com marcação visual |
timeline | Linha do tempo de edição ilustrativa |
headline-box | Título em caixa; inclui aproximação |
profile-wall | Mural com seus próprios conteúdos |
tier-list | Lista organizada em níveis |
broll-split | Vídeo de apoio e pessoa em tela dividida |
phone-fan | Cartões de vídeos em leque |
dot-reveal | Imagem revelada por pontos |
headline-wall | Mural com seus títulos |
checklist | Etapas de uma tarefa sendo concluídas |
liquid-glass-graph | Gráfico e contador ilustrativos; forneça dados reais |
carousel-spin | Cartões em rotação |
match-cut | Páginas alternadas em torno de uma palavra |
apple-toggles | Interruptores animados |
led-sign | Texto luminoso atrás da pessoa |
slow-push | Aproximaçã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 TXTDestaque 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
/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
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
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
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.
- Repositório original: claude-video-effects.
- README da versão conferida e instruções da skill.
- Licença MIT · Copyright 2026 Vibha Ramprakash. Fontes e modelos mantêm suas próprias licenças; veja os avisos no repositório.
- Skills no Claude Code · Skills no Codex.
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.