engenheirode vídeo.
Workflow para videomakers

Como organizar skills e projetos para editar com IA

Skills por pasta, regras por cliente, rascunho antes da timeline e checklist de revisão: a organização que faz o agente de IA errar menos na edição.

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.

Puxe o próximo fio

Uma ideia leva a outra.

Todos os conteúdos ↗
ENGENHEIRO DE VÍDEO / TUTORIAL TUTORIAIS
Tutorial5 min de leitura

Transcrição local com Whisper na GPU

Como rodar o Whisper na placa de vídeo do seu computador para transcrever horas de material, palavra por palavra, sem pagar por minuto.

TutoriaisLer conteúdo ↗
ENGENHEIRO DE VÍDEO / TUTORIAL TUTORIAIS
Tutorial5 min de leitura

Os programas que você precisa instalar para editar com IA

A stack mínima para editar vídeo com IA, explicada programa por programa, com os comandos de instalação no Mac e no Windows.

TutoriaisLer conteúdo ↗
ENGENHEIRO DE VÍDEO / TUTORIAL TUTORIAIS
Tutorial5 min de leitura

Legendas dinâmicas com IA: passo a passo

Da transcrição palavra por palavra ao arquivo pronto para a timeline: como fazer o agente gerar legendas dinâmicas sem texto encavalado.

TutoriaisLer conteúdo ↗