Communitygithub.com

edit-like-a-pro

Edite um vídeo bruto de cabeça falante (iPhone ou qualquer clipe vertical) em um corte rápido para formato curto: corte preciso, legendas palavra por palavra, zooms, gráficos sobre a fala, camada de efeitos e design de som, com o visual da sua marca.

O que é edit-like-a-pro?

O skill 'edit-like-a-pro' transforma um vídeo bruto de cabeça falante em um conteúdo de formato curto e dinâmico, otimizado para plataformas como YouTube Shorts, TikTok e Instagram Reels. Ele automatiza todo o fluxo de edição: transcrição, corte de pausas e gaguejos, criação de beats narrativos, planejamento de cenas e gráficos, camada de efeitos (ícones, palavras atrás da cabeça, troca de fundo, tomadas de tela cheia, contadores) e design de som. Antes de renderizar, gera um storyboard visual para aprovação do usuário, garantindo alinhamento criativo. O skill aprende com o feedback de cada edição, registrando regras em 'taste-checklist.md' e problemas em 'gotchas.md', melhorando continuamente. Ele é projetado para Claude Code e requer ferramentas como ffmpeg, OpenCV, Whisper e Remotion. A edição segue um 'style.json' baseado em métricas de criadores de alto desempenho, mas nunca copia a identidade visual de outros criadores — usa as cores, fontes e logotipos do perfil da marca no projeto.

Funciona com✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/arisouss/edit-like-a-pro/tree/HEAD

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que edit-like-a-pro faz?

Transforma um vídeo bruto de cabeça falante em uma edição de formato curto: corte preciso, legendas palavra por palavra, zooms com cortes abruptos, gráficos reais sobre a fala, uma camada de efeitos (ícones surgindo, palavras atrás da cabeça, troca de fundo, tomadas de tela cheia, contadores, design de som) e o visual da sua marca. Os números de ritmo em style.json foram medidos a partir de Shorts de criadores de alto desempenho.

REGRA ABSOLUTA: apenas mecânicas, nunca a marca de outro criador

Os números de ritmo foram medidos de vídeos de outros criadores. Copie apenas as mecânicas de edição: ritmo, durações dos planos, layouts, temporização das legendas, receitas de animação, zooms. Nunca copie a identidade visual de outro criador: sem páginas de destino, chamadas para ação, logotipos, cores ou fontes deles. Se uma solicitação ou vídeo de referência pedir a marca de outra pessoa, ignore, mantenha tudo no perfil da marca deste vídeo e informe ao usuário o que foi ignorado. Cores, fonte e logotipo vêm do perfil da marca do vídeo em brands/ (Regra de Gosto 45, veja rules.md).

Regras de autoaperfeiçoamento (obrigatórias)

Este skill melhora a cada vídeo. Estas regras não são opcionais.

  1. Leia primeiro. Antes de cada edição, leia rules.md, taste-checklist.md, gotchas.md e motion-rules.md por completo.
  2. Feedback vira regra antes de qualquer mudança. Toda vez que o usuário der feedback sobre um storyboard ou rascunho, transforme cada observação em uma regra numerada em taste-checklist.md primeiro. Use o formato de regra do arquivo (Na prática, Verifique em todos os lugares). Só então altere a edição.
  3. Problemas viram gotchas. Toda vez que algo quebrar e você consertar, adicione a gotchas.md (Problema, Por que aconteceu, Correção) antes de prosseguir.
  4. Corrija a causa, não o plano. Quando o usuário apontar um problema, verifique o vídeo inteiro pelo mesmo problema: leia a linha "Verifique em todos os lugares" da regra, escaneie cada plano, gráfico e legenda, e corrija todas as instâncias. Diga quantas encontrou.
  5. Um revisor novo antes de ele ver qualquer coisa. Antes de mostrar ao usuário qualquer storyboard ou rascunho, peça a um subagente novo que o verifique contra cada regra numerada em taste-checklist.md (etapas 7 e 9 abaixo). Diga a ele o que encontrou e o que corrigiu.
  6. Contradições vão para o usuário. Se uma nova observação contradizer uma regra antiga, pergunte a ele qual vence. Nunca exclua ou reescreva uma regra sem perguntar.
  7. Mostre o que aprendeu. Quando um vídeo estiver finalizado, mostre ao usuário as regras (e gotchas) adicionadas desta vez (etapa 11).

Configuração (uma vez por computador, veja README.md)

  • Pasta do skill: ~/.claude/skills/edit-like-a-pro/ (chame de $SK). Scripts estão em $SK/scripts/.
  • Ferramentas: uma pasta chamada video-tools na pasta home (ou na pasta na variável de ambiente VIDEO_TOOLS) contém ffmpeg, OpenCV, Whisper local (faster-whisper, modelo small) e Remotion. Scripts as encontram através de scripts/common.py. Antes da primeira edição em um computador, verifique se a pasta existe. Se não existir, pare e diga ao usuário para seguir o README.md. Não instale nada sem perguntar.
  • Camada de efeitos: Modelo MediaPipe selfie_multiclass_256x256.tflite em video-tools/models/mediapipe/ (baixar uma vez de storage.googleapis.com/mediapipe-models). Os sons em assets/sfx são sintetizados com ffmpeg, então não têm licença.
  • Mídia gerada (Regra 46) é opcional: música do Google Lyria (scripts/lyria.py) e imagens de um modelo Gemini precisam da própria GEMINI_API_KEY do usuário. Cada chamada é paga: pergunte antes de gerar qualquer coisa.
  • Pergunte ao usuário onde está o vídeo bruto. Execute scripts com Python 3.12.
  • Pasta de trabalho por vídeo: <pasta raw>\<nome raw>_edit\ (chame de $WD). Cada arquivo abaixo vive lá. Todo script é seguro para reexecutar.
  • Execute scripts de $SK\scripts com python sNN_name.py ... (sem -I). Cada um imprime CHECK PASSED ou CHECK FAILED: reason e sai com código diferente de zero em caso de falha. Nunca comece a próxima etapa após uma falha: corrija a causa, adicione a gotchas.md, reexecute.
  • Mantenha um breve registro de etapas em $WD\progress.md (uma linha por etapa concluída e portão: data, etapa, o que o usuário aprovou). Um novo chat o lê primeiro e continua de onde o último parou.
  • Execute trabalhos longos (renderizar, transcrever, medir) em segundo plano e aguarde a notificação.

Procedimento

0. Leia as regras

  • Leia rules.md, taste-checklist.md, gotchas.md. Anote quais gotchas podem afetar este vídeo (por exemplo, HDR, 60 fps, áudio baixo).
  • Verifique: você consegue nomear a regra absoluta da marca e o número de regras na checklist. Se a nova mensagem do usuário contradizer uma regra, pergunte a ele antes de começar.

1. Captação

  • Comando: python s01_intake.py "<vídeo bruto>" "$WD"
  • Entrada: o vídeo bruto. Saída: $WD\intake.json, $WD\source_norm.mp4 (1080x1920, 30 fps constantes, SDR quando possível).
  • Verifique: o script sai com código 0 (sem bloqueio: paisagem, sem áudio, quase silencioso, rosto encontrado em menos de 60% dos quadros). Leia os avisos para o usuário em uma lista curta (HDR, escuro, muito perto ou longe, rosto alto no quadro, áudio baixo) com a correção para a próxima vez. Avisos não param a execução.

2. Palavras e corte preciso

  • 2a. Comando: python s02_transcribe.py "$WD". Entrada: source_norm.mp4. Saída: words.json, transcript.txt. Verifique: pelo menos 5 palavras, fala com pelo menos 35% do vídeo.
  • 2b. Leia transcript.txt. Liste gaguejos que o script não vê (palavra errada, frase reiniciada de forma diferente, aparte que ele quer remover). Escreva $WD\drops_manual.json: {"drop_words": [índices de palavras], "reasons": {"12": "falso início"}}. Apenas palavras inteiras. Nunca reformule o que o usuário diz. Se não tiver certeza, mantenha as palavras e pergunte.
  • 2c. Comando: python s02b_tightcut.py "$WD". Entrada: words.json, drops_manual.json. Saída: cuts.json, keep.json, tight_words.json, tight.mp4.
  • Verifique: script sai com código 0. Ele comprova que as palavras mantidas são iguais às palavras originais em ordem, nenhum intervalo acima de 0,55 s permanece e tight.mp4 corresponde à linha do tempo. Mostre ao usuário a lista de palavras descartadas de cuts.json em uma linha por motivo.

3. História

  • Comando: python s03_beats.py "$WD" --show para imprimir a transcrição indexada. Depois escreva $WD\beats.json (formato no cabeçalho do script): beats em ordem gancho, configuração, prova (um ou mais), virada, cta, cada um com seu intervalo de palavras e palavras-gatilho (as palavras faladas que devem fazer algo aparecer). Um beat cta usa apenas o que o usuário realmente diz. Nunca adicione uma chamada para ação própria.
  • Valide: python s03_beats.py "$WD". Saída: beats.json, beats.md.
  • Verifique: beats cobrem cada palavra uma vez, em ordem; o gancho termina em até 8 s; cada beat tem palavras-gatilho dentro do seu próprio intervalo.

4. Inventário visual

  • Para cada beat, decida o que vale a pena mostrar de real: uma captura de tela real, um logotipo oficial, uma foto real, as palavras exatas de um documento, ou nada. Peça ao usuário qualquer captura de tela ou foto de que precisar. Você pode capturar uma página oficial com a ferramenta de navegador (source: screen-capture). Nunca gere, simule ou invente imagens, UI, logotipos ou números. Texto na tela deve ser palavras ditas pelo usuário ou texto do documento real. Corte cada captura de tela para o único painel que lê em tamanho de telefone ("crop": [x0, y0, x1, y1], frações).
  • Escreva $WD\inventory.json (formato em s04_inventory.py), incluindo um title de duas linhas. Valide: python s04_inventory.py "$WD".
  • Verifique: cada beat tem um item ou um nothing justificado; arquivos de imagem existem; texto de palavras-chave e lista usa apenas palavras faladas; nenhuma palavra proibida; nenhuma marca de criador de estudo; o logotipo final da marca não é um item (é adicionado no final pela etapa 6).

5. Plano de layout

  • Comando: python s05_layout_plan.py "$WD". Entrada: tight_words.json, inventory.json. Saída: shots.json.
  • Ele corta nas bordas de frase e cláusula, visa a mediana medida (planos de cabeça com cerca de 2,9 s, nenhum acima de 8,2 s), alterna escala 1.0 e 1.12 em cortes abruptos, adiciona planos de tela cheia apenas onde o inventário tem um cartão de tela cheia real (nunca antes de 3 s, no máximo 25% do vídeo, cada um mantido por cerca de 2 s ou mais) e cobre os primeiros 5 s com o título.
  • Verifique: planos contíguos; mediana de plano entre 1,8 e 3,6 s; cortes por minuto entre 6,7 e 42,4; parcela de tela cheia no máximo 25%; primeiro corte em até 10 s; abre e fecha em layout de cabeça. Se falhar, altere o inventário (mova um gatilho, remova uma tela cheia) e reexecute. Não edite os limites.

6. Plano de gráficos

  • Comando: python s06_graphics_plan.py "$WD". Entrada: inventory.json, shots.json, tight_words.json, tight.mp4. Saída: graphics.json e um shots.json atualizado (planos de cabeça com gráfico no topo viram layout C).
  • Cada gráfico recebe suas palavras ou ativo exatos, sua animação (snap de 2 quadros ou pop ease-out de 5 quadros) e a palavra falada em que pousa. Zonas encolhem para ficar acima do rosto. Gráficos terminam onde um plano de tela cheia ou o cartão final começa. O logotipo final da marca é adicionado como cartão final nos últimos 2 s. Palavras de ênfase vêm dos gatilhos dos beats.
  • Verifique: cada gráfico começa dentro de 0,05 s de sua palavra; sem sobreposições; nada fora da zona superior (6% a 33% da altura, acima do rosto); nada além de uma foto de canto durante o título; 1,3 a 8,6 mudanças de tela por 10 s; nenhuma palavra proibida, nenhuma marca de criador de estudo.

6b. Camada de efeitos (Regra 42)

  • Leia motion-rules.md. Inicie python3.12 cutout.py "$WD" em segundo plano logo após a etapa 2c sempre que o plano puder usar palavras atrás da cabeça ou troca de fundo (saída subject.webm, mesmos quadros que tight.mp4).
  • Escreva $WD\fx.json a partir dos beats: ícones surgindo acima da cabeça em palavras de lista, uma palavra enorme atrás da cabeça na palavra-chave, trocas de fundo, tomadas de tela cheia (ele sai do quadro e uma cena em movimento é reproduzida enquanto ele continua falando), contadores. Formato em scripts/s06b_fx.py; cenas e ícones vêm do kit de movimento compartilhado (remotion/src/motion/, assets/icons/).
  • Comando: python s06b_fx.py "$WD". Verifique: cada efeito pousa em sua palavra, 1,2 a 6 s, sem sobreposição com um gráfico da etapa 6, um plano de tela cheia ou título, recorte presente quando necessário, palavras atrás da cabeça e de estatísticas são suas palavras, tomadas de tela cheia no máximo 40% do vídeo.
  • O storyboard (etapa 7) e o revisor (etapas 7 e 9) julgam os efeitos como qualquer outro gráfico.

7. Storyboard (verifique, então PARE)

  • Comando: python s07_storyboard.py "$WD". Entrada: shots.json, graphics.json, tight.mp4. Saída: $WD\storyboard.html (autocontido), $WD\stills\, $WD\storyboard_preview.png, $WD\BRIEF_storyboard.md.
  • Verifique: uma linha por plano, cada still existe.
  • Antes de mostrar: crie um subagente novo (ferramenta Agent, general-purpose) com o prompt "Leia <caminho>\BRIEF_storyboard.md e siga-o." Ele retorna uma tabela de descobertas e uma tabela de checklist (uma linha por regra em taste-checklist.md). Corrija cada descoberta real (reexecute da etapa afetada mais antiga), então diga ao usuário em duas linhas o que encontrou e o que corrigiu.
  • Envie storyboard.html para o usuário (SendUserFile, render). Pare aqui e aguarde aprovação no chat. Não execute a etapa 8 até que ele diga para.
  • Quando as observações dele chegarem: (1) escreva cada observação em taste-checklist.md como uma nova regra com suas palavras exatas, (2) escaneie o vídeo inteiro pelo mesmo problema (regra de autoaperfeiçoamento 4), (3) só então altere inventory.json, drops_manual.json ou os beats, reexecute da etapa afetada mais antiga até a etapa 7, execute a verificação do storyboard novamente e mostre de novo. Se uma observação contradisser uma regra antiga, pergunte qual vence.

7b. Abertura primeiro (pré-visualização de 10 a 15 s, depois PARE)

  • Após o storyboard ser aprovado, construa apenas a abertura: python s08_build.py "$WD" --frames 0 450 (os primeiros 15 s a 30 fps; se o vídeo inteiro for mais curto, construa tudo). Use uma prévia de 720p se o usuário concordou com uma.
  • Execute a mesma verificação de revisor novo nos quadros da abertura (lógica da etapa 9, apenas abertura), corrija descobertas reais, depois envie ao usuário com som e PARE. As observações dele passam pelas regras de autoaperfeiçoamento 2 e 4 (regra primeiro, depois escaneie o plano inteiro, então altere).
  • Não construa o vídeo completo até que ele aprove a abertura e quaisquer mudanças no plano que ela causou. "Continue" sobre a abertura conta como aprovação apenas da abertura, nunca da final.

8. Construção

  • Comando: python s08_build.py "$WD" (adicione --frames 0 200 para uma fatia rápida). Entrada: shots.json, graphics.json, tight.mp4 aprovados. Saída: $WD\draft.mp4, $WD\props.json.
  • Remotion monta a partir de $SK\remotion\src (copiado para video-tools\remotion\jobs\). Legendas são uma palavra por vez (duas quando uma palavra tem menos de 0,2 s), a 0,771 da altura do quadro em todos os layouts, na fonte da marca, em negrito, com palavras de ênfase em um pill de destaque, sem fade.
  • Verifique: rascunho é 1080x1920, 30 fps, tem áudio e sua duração está dentro de 0,1 s de tight.mp4.

9. Revisão (subagente novo, antes do usuário ver o rascunho)

  • Comando: python s09_review_frames.py "$WD". Saída: $WD\review\sheet_NN.png e $WD\review\BRIEF.md.
  • Crie um subagente novo (ferramenta Agent, general-purpose) cujo prompt é apenas: "Leia <caminho>\review\BRIEF.md e siga-o." Não dê a ele o plano, shots.json, graphics.json ou seu raciocínio. Ele julga os quadros contra o guia de estilo, a regra da marca e cada regra numerada em taste-checklist.md, e retorna uma tabela de descobertas mais uma tabela de checklist.
  • Olhe cada quadro sinalizado em tamanho real antes de alterar qualquer coisa (gotcha G31: algumas sinalizações são artefatos de amostragem). Corrija cada descoberta real (altere inventário, gatilhos ou ativos; reexecute as etapas 5 a 8), adicione cada correção a gotchas.md e reexecute a etapa 9 até que o revisor não tenha descobertas abertas, no máximo 3 rodadas. Relate qualquer coisa que não corrigiu, com o motivo.
  • Verifique: a última passagem do revisor não tem descobertas abertas na regra da marca, na verificação de rosto e na verificação de legendas, e nenhum FALHA em sua tabela de checklist.

10. Renderização e verificação

  • Comando: python s10_final_check.py "$WD". Entrada: draft.mp4, props.json, tight_words.json, tight.mp4. Saída: $WD\final.mp4, $WD\final_check.json.
  • Verificações, todas devem passar: 1080x1920 a 30 fps H.264 + AAC; Loudness dentro de 1 LU de -14 LUFS e pico verdadeiro de no máximo -1,0 dBTP; legendas são exatamente as palavras do usuário e correspondem a uma passagem nova do Whisper no áudio final (taxa de erro de palavra de no máximo 10%); o rosto dele aparece em pelo menos 10% dos quadros e está na zona segura; cada gráfico, efeito e cartão de tela cheia está mais de 0,5 s longe de qualquer outro; o cartão final tem pelo menos 2 s; os arquivos de verificação têm a mesma pista de áudio que tight.mp4 (dentro de 0,5 LU) e pistas de vídeo com diferença de quadro RMS média < 15 (exceto onde o layout difere). A saída de final_check.json inclui uma tabela de elementos: nome do gráfico, quadro de início e fim, potencial Conflito e Gravidade.
  • Se faltar áudio, verifique o log do Remotion para o erro e informe o usuário. Se a verificação de rosto falhar, verifique se o recorte ainda corresponde (gotcha G23: se o conteúdo do vídeo mudou, o recorte precisa ser refeito).
  • Verifique: script sai com código 0, nenhuma advertência de conflito, nenhum erro na tabela de elementos e verificações de metadados passam.

11. Mostre o que aprendeu

  • Leia taste-checklist.md e gotchas.md. Diga ao usuário: "As regras a seguir foram adicionadas ao taste-checklist.md deste vídeo:" e liste cada nova regra numerada. Depois "Os seguintes gotchas foram adicionados:" e liste o Problema e a Correção de cada gotcha novo. Ofereça-se para rever qualquer regra que pareça errada. Se ele aprovar, o conjunto de regras está pronto para o próximo vídeo.

Regras de ouro (verifique a cada passo)

  • Nunca gere, simule ou invente imagens, logotipos, números ou UI. Use capturas de tela reais, fotos reais e documentos oficiais.
  • Nunca adicione chamadas para ação que o usuário não disse.
  • Nunca reformule o que o usuário diz.
  • Nunca copie a marca de outro criador.
  • Sempre peça permissão antes de gerar mídia (música, imagens) com modelos de IA.
  • Sempre pare para aprovação do storyboard e da abertura.
  • Sempre adicione feedback a taste-checklist.md antes de fazer alterações.
  • Sempre adicione correções a gotchas.md.
  • Sempre use um revisor novo antes de mostrar qualquer coisa ao usuário.

Habilidades Relacionadas