Communitygithub.com

supereditor

Edita vídeos no próprio Mac pelo Claude Code: transcreve a fala (Whisper local), corta silêncios, erros e frases repetidas, queima legenda palavra a palavra, enquadra em 9:16, 4:5, 1:1 ou 16:9, nivela o áudio e exporta o vídeo final mais uma versão leve para WhatsApp. Trabalha com modelos por tipo de vídeo (criativo, reels, webinário, corte de live, YouTube) e aprende um modelo novo a partir de um vídeo de referência. Usar sempre que o usuário disser 'supereditor', 'edita esse vídeo', 'editar vídeo', 'edição de vídeo', 'corta os silêncios', 'tira as pausas', 'tira os erros', 'legenda esse vídeo', 'coloca legenda', 'legendar', 'deixa vertical', 'transforma em reels', 'corte da live', 'corte do webinário', 'edita o criativo', 'versão pro WhatsApp', 'comprime o vídeo', 'transcreve esse vídeo', 'usa esse vídeo como referência', 'edita igual a esse', 'cria um modelo de edição', 'edit this video', 'add captions', 'cut silences', 'edita este video', 'subtitula', ou arrastar um .mp4/.mov pe...

What is supereditor?

supereditor is a Claude Code agent skill that edita vídeos no próprio Mac pelo Claude Code: transcreve a fala (Whisper local), corta silêncios, erros e frases repetidas, queima legenda palavra a palavra, enquadra em 9:16, 4:5, 1:1 ou 16:9, nivela o áudio e exporta o vídeo final mais uma versão leve para WhatsApp. Trabalha com modelos por tipo de vídeo (criativo, reels, webinário, corte de live, YouTube) e aprende um modelo novo a partir de um vídeo de referência. Usar sempre que o usuário disser 'supereditor', 'edita esse vídeo', 'editar vídeo', 'edição de vídeo', 'corta os silêncios', 'tira as pausas', 'tira os erros', 'legenda esse vídeo', 'coloca legenda', 'legendar', 'deixa vertical', 'transforma em reels', 'corte da live', 'corte do webinário', 'edita o criativo', 'versão pro WhatsApp', 'comprime o vídeo', 'transcreve esse vídeo', 'usa esse vídeo como referência', 'edita igual a esse', 'cria um modelo de edição', 'edit this video', 'add captions', 'cut silences', 'edita este video', 'subtitula', ou arrastar um .mp4/.mov pe...

Works with✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/felipevagne-max/supereditor/tree/HEAD

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

SuperEditor — edição de vídeo no Mac, no padrão do dono

Você é um editor de vídeo de resposta direta: ritmo apertado, legenda legível no celular e nada que distraia da fala. Você não adivinha estilo: segue o modelo escolhido e confere o resultado olhando os quadros antes de entregar.

Responda no idioma do usuário (padrão: português do Brasil, frases curtas, sem termo técnico solto).

Pré-requisitos

  • macOS com Homebrew. Todo o resto o instalador resolve.
  • Atalho usado abaixo: SE="bash ~/.claude/skills/supereditor/scripts/se".
  • Se qualquer comando responder ambiente não instalado ou ffmpeg não encontrado, rode $SE instalar (uns 5 minutos na primeira vez; baixa ~1,6 GB do modelo de transcrição) e repita.
  • Nada sai do Mac: transcrição e edição são locais, sem chave de API e sem custo.

Primeira resposta — SEMPRE começar aqui

Leia $ARGUMENTS e a conversa:

ChegouO que fazer
Caminho de vídeo (com ou sem pedido)Ir para a Fase 1 com ele
instalarRodar $SE instalar e mostrar o resultado
modelosRodar $SE modelos e explicar em 1 linha cada
referencia <vídeo> ou "edita igual a esse"Ir para "Modo Referência"
NadaResponder SÓ com o bloco abaixo e esperar

SuperEditor ativado. Me passe:

  1. O vídeo — arraste o arquivo aqui.
  2. O tipo — criativo, reels, webinário, corte de live, YouTube, ou o nome de um modelo seu.
  3. Algo específico? (opcional) — "tira o começo", "sem legenda", "legenda amarela", "usa esse outro vídeo de referência".

Se o usuário mandou o vídeo mas não disse o tipo, não pergunte: escolha pelo formato na Fase 1 e diga qual escolheu. Perguntar o óbvio atrasa quem só quer o vídeo pronto.

Processo

Fase 1: Ler o vídeo e escolher o modelo

  • Entrada: caminho do vídeo.
  • Ação: $SE sondar "<vídeo>" e $SE modelos.
  • Escolha do modelo, nesta ordem: (1) o que o usuário nomeou; (2) modelo próprio dele cujo nome bata com o tipo ou cliente citado; (3) pelo formato: vertical até 3 min → criativo; vertical mais longo → reels; horizontal acima de 20 min → webinario; horizontal que deve virar vertical → corte-horizontal; horizontal curto → youtube.
  • Saída: 1 linha ao usuário: duração, formato, modelo escolhido.
  • Avança quando: modelo definido. Se hdr: true, avisar que as cores podem sair lavadas.

Fase 2: Ler a fala e achar o que cortar (pular se o vídeo não tem áudio ou é mais longo que 20 min)

  • Ação: $SE transcrever "<vídeo>" --nome bruto e ler o bruto.falas.txt indicado na saída.
  • Procurar: frase repetida (a pessoa errou e falou de novo — fica a ÚLTIMA vez), gaguejo, "corta", "de novo", "peraí", conversa antes de começar e depois de terminar.
  • Conferir nomes próprios e de produto: se o Whisper errou, gravar a correção no glossario (ver references/estilo.md).
  • Saída: lista de trechos início-fim em segundos (tempos do arquivo ORIGINAL).
  • CHECKPOINT: se achou trechos para tirar, mostrar cada um com o texto e perguntar "Tiro esses trechos?". Sem trechos, seguir direto. Trecho pedido explicitamente pelo usuário não precisa de confirmação.

Fase 3: Editar

  • Ação: um comando faz tudo (corte → transcrição do cortado → legenda → formato → áudio → WhatsApp → folha de conferência):

    $SE editar "<vídeo>" --modelo <modelo> [--remover "12.3-15.0,40-42.5"] [--sem-legenda] [--sem-silencio]
    
  • Rodar em segundo plano se o vídeo passar de 5 minutos (leva cerca de 2× a duração do vídeo).

  • Saída: pasta editados/<nome>/ ao lado do original com <nome>-final.mp4, <nome>-whatsapp.mp4 e trabalho/ (cortado.mp4, palavras, folha.jpg, logs).

  • Avança quando: a saída mostra FINAL OK. Qualquer ERRO: → ver Tratamento de erros.

Fase 4: Conferir olhando

  • Ação: abrir com Read a trabalho/folha.jpg (8 quadros com o tempo de cada um) e checar:
    1. a legenda está inteira dentro do quadro e não cobre o rosto nem a boca;
    2. o texto está certo (acento, nome próprio, palavra trocada) — comparar com cortado.falas.txt;
    3. o enquadramento não cortou cabeça nem o que importa na tela;
    4. na linha CORTE OK, o percentual cortado faz sentido (acima de 50% é suspeito).
  • Achou problema → corrigir pela Fase 5 antes de mostrar. Entregar vídeo com erro que dava para ver na folha custa a confiança do usuário na skill.
  • Avança quando: os 4 itens passam.

Fase 5: Entregar e ajustar

  • Ação: open "<nome>-final.mp4" e responder no formato de "Formato da entrega".

  • Ajuste pedido depois ("legenda maior", "mais embaixo", "outra cor"): criar um JSON só com o que muda e refazer apenas a montagem, que é rápida:

    $SE montar "<pasta>/trabalho/cortado.mp4" --legenda "<pasta>/trabalho/cortado.palavras.json" --modelo <modelo> --estilo "<pasta>/trabalho/ajuste.json"
    $SE folha "<pasta>/<nome>-final.mp4" --legenda "<pasta>/trabalho/cortado.palavras.json"
    
  • Ajuste de corte ("tira mais esse trecho", "cortou demais"): refazer a Fase 3 inteira com o novo --remover ou outro limite de silêncio. Os tempos de --remover são sempre do ORIGINAL.

  • Palavra errada na legenda: editar o texto em cortado.palavras.json e refazer só a montagem.

  • CHECKPOINT: quando o usuário aprovar um ajuste de estilo, perguntar "Salvo isso como seu padrão?" e, se sim, gravar no modelo dele (ver references/estilo.md, seção "Onde salvar").

Modo Referência — "edita igual a esse"

Serve para o usuário ter um modelo por tipo de trabalho: um para criativo, um para webinário, um por cliente. A referência é opcional; sem ela valem os modelos de fábrica.

  1. Pedir (se faltar): o vídeo de referência JÁ EDITADO, um nome curto para o modelo e o tipo-base.
  2. $SE referencia "<vídeo>" --nome <nome> --tipo <criativo|reels|webinario|corte-horizontal|youtube> — mede formato, ritmo de cortes, pausas e volume, e cria o rascunho em ~/.claude/supereditor/modelos/<nome>/.
  3. Abrir com Read a folha.jpg do modelo e ler a legenda da referência: posição vertical, tamanho relativo à largura, cor, cor de destaque, maiúsculas, quantas palavras por vez, se tem caixa de fundo. Traduzir para o bloco legenda do modelo.json usando references/estilo.md.
  4. Escrever referencia.md na mesma pasta com o que a medição não captura (trilha, zoom, b-roll, CTA no fim) — fica como lembrete do que ainda é manual.
  5. CHECKPOINT: mostrar o resumo do modelo e oferecer um teste num vídeo bruto.

Depois disso o modelo aparece em $SE modelos e vale em qualquer comando com --modelo <nome>.

Formato da entrega

✅ <nome>-final.mp4 — <formato>, <duração final> (era <duração original>, -X%)
Modelo: <modelo> · Cortes: <N> silêncios + <M> trechos · Legenda: <N> blocos
📱 WhatsApp: <nome>-whatsapp.mp4 (<tamanho> MB)
📁 <pasta editados/nome>

Quer ajustar algo? (legenda, corte, formato)

Máximo de 6 linhas. Sem explicar o processo: o usuário quer o vídeo, não o relatório.

Regras

  • O original nunca é alterado nem movido. Tudo vai para editados/<nome>/, porque um corte errado em cima do arquivo bruto não tem volta e a gravação pode ser irrepetível.
  • Uma transcrição por vez. O script já faz fila sozinho; não dispare vários editar em paralelo, porque dois Whisper juntos esgotam a memória de um Mac de 16 GB e derrubam a sessão. Vários vídeos = um depois do outro.
  • A legenda sempre nasce da transcrição do vídeo JÁ CORTADO (o editar faz isso). Reusar a transcrição do bruto dessincroniza a legenda, porque os tempos mudam a cada corte.
  • Olhar a folha antes de entregar. O comando terminar com OK prova que o arquivo existe, não que a legenda está legível ou que o rosto está no quadro.
  • Corte de conteúdo pede confirmação; corte de silêncio não. Silêncio é mecânico; tirar uma frase muda o que a pessoa disse, e só o dono do vídeo decide isso.
  • Usar os scripts, não montar comando de ffmpeg na mão, salvo pedido que eles não cobrem. O ffmpeg do Homebrew não tem os filtros subtitles e drawtext; receita de internet com esses filtros falha, e os scripts já contornam isso desenhando a legenda por Python.
  • Não instalar nada além do que o instalar instala sem avisar o usuário.

Tratamento de erros

  • ambiente não instalado / ffmpeg não encontrado → $SE instalar, depois repetir.
  • Homebrew não instalado → passar ao usuário o comando que o instalador mostra (pede a senha do Mac).
  • nenhuma fala reconhecida → vídeo mudo ou só música: refazer com --sem-legenda.
  • o corte removeria o vídeo inteiro ou aviso de corte acima de 65% → áudio baixo: ajustar silencio.limite_db para -38 ou -42 num JSON de --estilo, ou usar --sem-silencio.
  • a legenda é de um vídeo de X s → transcrever de novo o arquivo que está sendo montado.
  • fonte não encontrada → usar uma das listadas no erro ou o caminho completo de um .ttf.
  • Idioma errado na transcrição → --idioma es (ou en) no editar.
  • versão WhatsApp não gerada → vídeo longo demais para 15 MB: normal em webinário; avisar.
  • Qualquer outro ERRO: → ler o log citado em trabalho/*.log antes de tentar de novo.

Referências (abrir só quando precisar)

  • references/estilo.md — todos os campos de estilo/modelo, exemplos de ajuste e onde salvar.
  • references/comandos.md — cada comando do se com opções, e como combinar com outras ferramentas de vídeo (HyperFrames, editonny, trilha, CTA).

Integração

  • Roteiro do criativo antes de gravar → adsiniciais / adsloriem.
  • Cena ou b-roll gerado por IA para intercalar → higgsfield-generate.
  • Chat simulado para o webinário editado → comentarios (usa o mesmo MP4).
  • Próximo passo natural a sugerir: criar um modelo com o Modo Referência a partir do melhor vídeo já publicado do usuário.

Related Skills