Se eu tivesse que resumir em uma frase o que mais faz diferença na edição com IA, seria esta: organização vale mais do que skill. Skill boa num projeto bagunçado dá resultado ruim. Skill simples num projeto organizado dá resultado repetível.
Este post junta o que eu faço e o que mais funcionou no grupo de editores que eu acompanho: onde guardar as skills, como separar clientes, como fazer o agente planejar antes de executar e como revisar sem refazer tudo.
O problema: skill demais, no lugar errado
Quando você começa, a tendência é instalar tudo que aparece no GitHub. E quase tudo instala no global, ou seja, fica disponível em qualquer pasta.
Resultado: quando o agente abre uma sessão para trabalhar, ele tem centenas de skills para escolher. Ele se confunde, puxa a skill errada, mistura instrução de um projeto com outro. Muita gente acha que o modelo piorou, quando o problema é a bagunça.
1. Uma pasta por assunto, com só as skills dela
O que eu faço: cada assunto tem a sua pasta, e as skills ficam dentro dela, instaladas localmente. A pasta de vídeo tem as skills de vídeo (por exemplo, get-brolls, DaVinci Resolve, Remotion e HyperFrames) e nada mais. A pasta de marketing tem as dela.
Quando preciso daquilo, abro a sessão do agente naquela pasta. Assim ele acorda só com o que precisa.
No get-brolls, isso já está previsto: dá para instalar a skill dentro de um projeto (.claude/skills/get-brolls/ no Claude Code ou .agents/skills/get-brolls/ no Codex), em vez da pasta pessoal. O passo a passo está em como instalar o get-brolls.
Duas conferências que valem a pena:
- Veja na configuração do agente se as skills globais também estão sendo carregadas nas pastas de projeto. Pode acontecer.
- Se o agente ficou “viciado” em instruções antigas, faça backup dos seus arquivos de instrução (como o
CLAUDE.md), limpe a memória e recomece. Em geral ele volta a funcionar melhor.
2. Uma pasta por cliente, com regras e brief
Cada cliente tem um estilo, um público e um conjunto de proibições. Isso não pode ficar na sua cabeça nem no histórico do chat. Tem que estar escrito, na pasta do cliente.
Eu separo em dois arquivos:
- Regras (RULES): o que vale sempre para aquele cliente. Formato, fontes preferidas, o que é proibido.
- Brief (BRIEF): o plano daquele vídeo específico, dividido em momentos.
O get-brolls usa exatamente esse modelo. init-rules cria um RULES.md no projeto, com formato do vídeo, fontes preferidas e bloqueios; init-brief cria o BRIEF.md, com os beats do vídeo. Quando o b-roll vem ruim, quase sempre a resposta está aí: registrar como proibido o que não serve (por exemplo, vídeos com texto sobreposto ou pessoa falando para a câmera), refazer a busca e conferir o Storyboard.
E o mais importante: todo feedback vira regra. Se você corrigiu a mesma coisa duas vezes, ela entra no RULES do cliente. Na terceira vez, o agente já acerta sozinho.
3. Rascunho antes da timeline
Antes de tocar no editor, peço para o agente escrever um rascunho em Markdown com a montagem inteira declarada: que trecho entra, em que ordem, com que b-roll, que legenda, que transição. Nada de mexer no vídeo ainda.
Eu leio o rascunho e já sei se vai dar certo. Se não for, corrijo o texto, que é muito mais barato do que corrigir uma timeline. Já cheguei a fazer dezenas de rascunhos de vídeo assim, sem encostar no material, e só depois mandei executar.
A ordem fica assim: planejar, ver o storyboard, ler o rascunho, confirmar, executar.
4. Checklist de revisão por formato
Em vez de pedir “revisa aí”, monte um arquivo com os itens que você confere em cada formato. No grupo, isso ganhou nome de QUALITYGATE.md: uma lista de itens marcáveis, um por formato (reel, corte de podcast, criativo de anúncio).
Vale também transformar parte da revisão em script. Em vez de treinar a skill indefinidamente, peça ao agente um script que use o FFmpeg para conferir o que dá para medir: duração, resolução, áudio presente, legenda dentro da área segura. É como um corretor automático. O que é gosto continua com você.
5. Registro do que o agente fez
Peça para o agente manter um diário curto em cada projeto: por que executou, o que mudou, que decisão tomou. E um arquivo de lições, enxuto, com o que deu errado e como foi resolvido.
Na próxima vez, o agente lê as lições e o README daquele módulo, sem precisar varrer o projeto inteiro. Gasta menos e erra menos. Uma variação que apareceu no grupo: ao terminar um vídeo difícil, pedir à IA um .md com todos os passos, erros e correções, para replicar o processo nos próximos.
6. Teste cego
Quando fechar o formato de um cliente, faça um teste: abra um terminal novo, com um modelo menor, e peça para ele reproduzir o resultado só com o brief, as regras e os arquivos. Se reproduzir, suas instruções estão boas. Se não, ainda tem coisa só na sua cabeça.
Um exemplo de estrutura
video/
├── .claude/skills/ # só as skills de vídeo
├── clientes/
│ └── cliente-a/
│ ├── RULES.md # regras fixas do cliente
│ ├── LEGENDA.md # estilo de legenda
│ ├── QUALITYGATE.md # checklist de revisão
│ └── 2026-11-reel-01/
│ ├── BRIEF.md # plano deste vídeo
│ ├── RASCUNHO.md
│ └── brolls/
└── lessons.md # lições gerais, curtas
Não precisa ser igual. Precisa ser sempre igual dentro do seu fluxo, para o agente saber onde procurar.
Por onde começar
Não reorganize tudo de uma vez. Pegue o cliente que mais se repete, crie a pasta dele com RULES e um checklist, e use por algumas semanas. Depois replique.
Se ainda está montando o básico, comece por edição de vídeo com IA: por onde começar. E se quiser ver como outros editores estão organizando as pastas deles, a Comunidade dos Engenheiros de Vídeo é onde a gente troca isso.
