A /editar-video é uma skill do Claude Code (e, desde que a Anthropic abriu o formato como padrão aberto, também do Codex CLI) pra vídeo bruto — você falando pra câmera, ou uma gravação de tela. Ela cobre duas coisas diferentes, e você escolhe qual no chat:
- Cortar e separar. Corta silêncios, tomadas erradas ou trechos específicos, e devolve clipes avulsos no formato e na resolução originais — sem recodificar, sem virar Reel se você não pedir isso.
- Montar o Reel completo. Transcreve a fala, sugere e monta inserts visuais (screenshots, logos, gráficos) e queima a legenda, entregando um Reel/Short 9:16 pronto pra postar.
Tudo isso roda no seu próprio computador — o vídeo nunca sai da sua máquina, e não tem nenhuma API paga envolvida.
Este tutorial cobre só a instalação e o uso básico, no Mac e no Windows. Não é sobre criar roteiro nem sobre os detalhes internos do design visual — é o caminho mais curto entre "baixei o repositório" e "rodei /editar-video pela primeira vez".
O que você precisa ter instalado, e por quê
| O quê | Pra quê serve |
|---|---|
| Python 3.11+ | A linguagem em que a skill inteira é escrita. |
| ffmpeg + ffprobe | O motor de vídeo/áudio de verdade: corta, junta, sobrepõe imagem, queima legenda, mede duração e volume. Tudo que toca o vídeo em si passa por ele. |
| faster-whisper (via pip) | Transcreve a fala localmente. Dá o texto pra você revisar (a skill sempre pede confirmação antes de continuar, porque o Whisper erra nome próprio e gíria) e o timestamp de cada palavra, usado pra posicionar legenda e inserts. |
| mediapipe + opencv-contrib-python (via pip) | Detecta onde está o rosto no vídeo, pra legenda e cards nunca cobrirem a cara de quem está falando. |
| Playwright + Chromium (via pip) | Título, legenda estilizada e os inserts visuais são montados como página HTML+CSS; o Playwright abre essa página num Chromium invisível e tira um screenshot (ou grava um clipe curto, pra insert animado). Sem ele, nenhum desses elementos renderiza. |
| cairosvg + cairocffi (via pip) | Converte logo em SVG (baixado da web) pra PNG, porque a composição final trabalha com imagem raster, não com vetor. |
| Claude Code ou Codex CLI | O agente que lê a skill e chama os scripts acima. |
Nenhuma chave de API é necessária. Nada é pago — o único download é o modelo de transcrição do Whisper (~150 MB), que baixa sozinho na primeira execução.
Passo 1 — Baixar a skill (igual em qualquer sistema)
git clone https://github.com/luiscortex/editar-video-skill.git cd editar-video-skill
Passo 2 — Instalar o ffmpeg
No Mac (com Homebrew):
brew install ffmpeg
No Windows (com winget, já vem instalado no Windows 10/11):
winget install Gyan.FFmpeg
Confirme que instalou certo, nos dois sistemas:
ffmpeg -version ffprobe -version
Passo 3 — Ambiente Python e dependências
No Mac / Linux (Terminal):
python3 -m venv venv source venv/bin/activate pip install -r requirements.txt playwright install chromium
No Windows (PowerShell):
python -m venv venv venv\Scripts\Activate.ps1 pip install -r requirements.txt playwright install chromium
==A ativação do venv (source venv/bin/activate ou venv\Scripts\Activate.ps1) precisa ser repetida toda vez que você abrir um terminal novo pra rodar a skill.==
Se o pip install travar no cairocffi no Windows: essa biblioteca depende da lib nativa Cairo, que no Windows não vem pronta. O jeito mais direto é instalar o MSYS2 e rodar pacman -S mingw-w64-x86_64-cairo antes do pip install, ou usar o Anaconda/Miniconda e trocar esse pip install por conda install -c conda-forge cairo cairocffi. É o único passo realmente diferente entre os dois sistemas.
Passo 4 — Instalar no Claude Code
No Mac / Linux:
mkdir -p ~/.claude/skills cp -r editar-video-skill ~/.claude/skills/editar-video
No Windows (PowerShell):
mkdir $env:USERPROFILE\.claude\skills -Force Copy-Item -Recurse editar-video-skill $env:USERPROFILE\.claude\skills\editar-video
Reinicie o Claude Code (ou abra uma sessão nova) e, dentro do chat, rode:
/editar-video caminho/da/pasta/com/o/video/bruto
A skill também ativa sozinha se você só descrever o que quer ("edita esse vídeo", "corta os silêncios desse bruto", "separa esse vídeo em pedaços") — o Claude Code lê a description da skill e decide chamar ela.
Passo 5 — Instalar no Codex CLI
Desde dezembro de 2025 o Codex CLI fala o mesmo formato de skill que o Claude Code (o padrão aberto Agent Skills).
No Mac / Linux:
mkdir -p ~/.agents/skills cp -r editar-video-skill ~/.agents/skills/editar-video
No Windows (PowerShell):
mkdir $env:USERPROFILE\.agents\skills -Force Copy-Item -Recurse editar-video-skill $env:USERPROFILE\.agents\skills\editar-video
Dentro de uma sessão do Codex, rode /skills pra confirmar que ela apareceu na lista. Pra chamar de forma explícita:
$editar-video
O Codex também tenta ativar a skill sozinho quando o seu pedido combina com a descrição dela — mas, como esse comportamento varia mais de versão pra versão que no Claude Code, prefira o $editar-video explícito se ela não entrar automaticamente.
Como funciona, na prática
Pra um corte simples, você só pede — "corta os silêncios desse vídeo e separa em clipes por assunto" — e a skill entrega os arquivos, sem recodificar nada.
Pro fluxo completo de Reel, ela pergunta o essencial numa única mensagem (layout dos inserts, estilo visual, tipo de conteúdo) e guia você por 6 etapas com 5 pontos de aprovação — você vê e aprova cada resultado (transcrição corrigida, plano de inserts, vídeo montado, legenda, versão final) antes de seguir pro próximo passo. Nenhuma etapa avança sem sua confirmação no chat.
O resultado fica sempre numa pasta de saída própria — sua pasta de vídeo bruto nunca é alterada.
Se algo travar
| Sintoma | O que fazer |
|---|---|
| "command not found: ffmpeg" (Mac) ou "não é reconhecido" (Windows) | Reinstale com o comando do Passo 2 e abra um terminal novo |
pip install trava no cairocffi (Windows) | Veja a caixa de aviso no Passo 3 — precisa da lib Cairo nativa |
| Legenda ou título não aparecem | Rode playwright install chromium de novo, com o venv ativado |
| Skill não aparece na lista do Codex | Confira se a pasta está exatamente em .agents/skills/editar-video/ (dentro da sua pasta de usuário) com o SKILL.md dentro |
| Primeira execução demora muito | Normal — é o download do modelo de transcrição (~150 MB), só acontece uma vez |
Repositório completo, com a spec técnica da skill (
SKILL.md) e o changelog de versões: github.com/luiscortex/editar-video-skill.
