Communitygithub.com

Halo Cut

Estilo de edição de vídeo premium para Claude: cortes precisos, legendas palavra-por-palavra e zoom em palavras-chave. Ideal para clipes de cabeça falante em Reels, Shorts ou TikTok: dicas, opiniões, histórias, anúncios. Transforma um clipe bruto em uma edição final 9:16 usando o motor video-studio-core (transcrição, corte automático, motion graphics, som, gradação).

O que é Halo Cut?

O Halo Cut é um estilo de edição de vídeo premium projetado para ser usado com o motor video-studio-core no Claude Code (ou agentes similares). Ele transforma um clipe bruto de cabeça falante em um reel polido para plataformas como Reels, Shorts e TikTok, usando cortes rápidos, legendas palavra-por-palavra (com palavra falada em amarelo e palavras-chave em ciano) e zoom suave (+14% e +8%) em palavras fortes, respeitando um intervalo mínimo de 2,4 segundos entre each zoom. O usuário inicia o processo executando scripts Python (run.py, render.py, finish.py) que geram um plano de edição (plan.json) e uma folha de contato (contact_sheet.png). O assistente refina o plano ajustando o gancho (hook) nos primeiros 2-3 segundos, corrigindo palavras transcritas erroneamente, selecionando 4-8 palavras-chave que carregam a mensagem e sincronizando zooms com essas palavras. O resultado final é um vídeo 9:16 (padrão, mas ajustável) com música opcional, endcard e fade suave, respeitando zonas seguras de texto (10% a 85% da altura). É compatível com qualquer sistema Unix que tenha Python e as dependências do video-studio-core.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Viprasol-Tech/claude-video-editing-skills/tree/HEAD/plugins/video-studio/skills/halo-cut

Perguntar na sua IA favorita

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

Documentação

O que Halo Cut faz?

Reel premium limpo: cortes rápidos, legendas palavra-por-palavra, zoom em palavras-chave.

  • Melhor para: qualquer clipe de cabeça falante para Reels, Shorts ou TikTok: dicas, opiniões, histórias, anúncios
  • Categoria: Reel de cabeça falante
  • Formato padrão: 9:16 (altere com --format 9:16 | 1:1 | 4:5 | 16:9)
  • Precisa de filmagem: sim, um clipe de fala bruto
  • Texto atrás do locutor: não

Antes de começar

Este estilo roda sobre o skill video-studio-core, que deve estar instalado na mesma pasta de skills.

  • CORE = a pasta video-studio-core ao lado desta (ex.: ~/.claude/skills/video-studio-core).
  • STYLE = a pasta deste skill (contém theme.json e theme.css).
  • Na primeira vez em uma máquina: python CORE/scripts/check_env.py e corrija o que ele relatar.
  • Se CORE estiver faltando, avise o usuário para instalar video-studio-core do mesmo pacote.

Fazer a edição

python CORE/scripts/run.py clip.mp4 --style STYLE --work edit-halo-cut --stop-after plan
# refinar edit-*/plan.json (veja abaixo), depois verificar os stills:
python CORE/scripts/render.py edit-halo-cut/plan.json --frames 1,3,6,9
python CORE/scripts/render.py edit-halo-cut/plan.json
python CORE/scripts/finish.py edit-halo-cut/plan.json

Abra contact_sheet.png e observe-a antes da renderização completa. O vídeo final é final.mp4 na pasta de trabalho. Use --formats 1:1,16:9 no finish.py para tamanhos extras. Adicione música com "music": {"src": "track.mp3", "volume": 0.12} no plano.

A aparência

  • As legendas ficam a 70% da altura, 2-3 palavras por vez, em maiúsculas, a palavra falada em amarelo, palavras-chave em ciano.
  • Zoom (+14%, depois +8%) em cada palavra forte, nunca mais de uma a cada 2,4 s.
  • Caixa de gancho no topo durante os primeiros 2,4 s: reescreva-a com 4-7 palavras que prometam o benefício.
  • Transição suave nos cortes, pop nas palavras-chave. Nada mais na tela.

Refinar o plano

O rascunho do make_plan.py é automático. Torne-o bom:

  • Leia words.json e reescreva o gancho (primeiros 2-3 s) em uma promessa curta e específica.
  • Substitua palavras-chave automáticas fracas pelas palavras que carregam o significado (números, resultados, nomes, contrastes).
  • Corrija quaisquer palavras mal interpretadas no array words (mantenha seus tempos).
  • Escolha 4-8 palavras-chave que carregam a mensagem e coloque-as na lista keywords do elemento de legendas.
  • Faça corresponder speaker.zooms a essas palavras (comece 0,05 s antes da palavra, termine ~1 s depois).
  • Se o clipe terminar com uma chamada para ação, adicione um elemento de texto endcard nos últimos 2 s.
  • Tipos e campos de elementos: CORE/references/plan-schema.md.

Verificar antes de entregar

  • Folha de contato: texto legível, nada cortado, nada cobrindo o rosto a menos que intencional, zonas seguras respeitadas (9:16: mantenha o texto entre 10% e 85% da altura).
  • Observe o tempo: as sobreposições devem cair com a palavra falada, não depois.
  • ffprobe no arquivo final: tamanho, duração e áudio corretos.
  • Informe ao usuário o que você cortou (segundos removidos), o que a aparência adiciona e onde o arquivo está.

Alterar a aparência

Cores e fontes estão em theme.json (vars, fontsUrl) e theme.css. Para uma alteração avulsa, edite plan.json (theme.vars, style do elemento) em vez dos arquivos do skill.

Exemplos de solicitações

  • "Edite meu clipe com halo-cut. Corte cada pausa."
  • "Faça deste um reel premium, com legendas, zoom nas palavras importantes."
  • "Halo-cut nisto, o gancho deve ser 'Eu pedi demissão por isto'."

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Habilidades Relacionadas