Communitygithub.com

orbit-reel

Cartões de imagem de retrato viajam ao redor do locutor em um anel 3D, passando atrás da cabeça e pelo primeiro plano. Versões verticais (9:16) e horizontais (16:9). Use para /orbit-reel ou para aplicar este tratamento específico a um clipe de cabeça falante.

O que é orbit-reel?

O orbit-reel é uma skill para agentes de IA (como Claude Code) que cria um efeito visual dinâmico de anel 3D ao redor de um locutor em clipes de vídeo. Utilizando templates HTML (vertical 1080x1920 e horizontal 1920x1080), a skill posiciona cartões de imagem em um círculo tridimensional, onde alguns passam atrás do locutor (z negativo) e outros cruzam o primeiro plano (z positivo), mantendo uma cena preserve-3D com perspectiva. Ela suporta tanto a criação de composições editáveis (com --prepare-only) quanto a renderização completa com HyperFrames, exigindo Python 3.9+, ffmpeg/ffprobe e Node.js 22+. A skill automaticamente valida dimensões e duração da mídia, prepara a composição e renderiza o MP4 final. Ideal para adicionar um tratamento visual sofisticado e automatizado a vídeos de cabeça falante, sem necessidade de transcrição ou chave de API.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/alisolanki/alis-claude-editing-skills/tree/HEAD/skills/orbit-reel

Perguntar na sua IA favorita

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

Documentação

/orbit-reel

Aplique este tratamento a um clipe de cabeça falante usando o iniciador de 4,2 segundos a 30 fps: template.html é vertical (1080x1920); template-16x9.html é horizontal (1920x1080), selecionado com "format": "horizontal" na especificação. O estilo e as imagens são independentes das palavras do locutor; siga o tópico escolhido pelo usuário.

Uso

Resolva esta pasta de skill a partir do diretório base mostrado quando a skill carrega. Seu build.py resolve o kit compartilhado através desse caminho real, inclusive quando instalado como um link simbólico. Execute:

python3 /caminho/para/skills/orbit-reel/build.py /caminho/para/spec.json

Nenhum locutor de amostra está incluído. Forneça a filmagem do usuário através dos assets da especificação (chaves speaker.mp4 / speaker_cut.webm, também usadas para o template horizontal com arquivos 1920x1080) ou coloque-a em assets/my-media/ uma vez (veja seu README) e execute sem especificação. A saída vai para o diretório .work/ do repositório. --prepare-only constrói uma composição editável sem renderizar. Python 3.9+, ffmpeg/ffprobe e Node.js 22+/npm são necessários. A primeira construção baixa o GSAP 3.15.0 fixado no cache vendor ignorado; a renderização usa HyperFrames 0.8.214. Nenhuma transcrição ou chave de API é necessária para estes templates curtos. Especificação e instruções de filmagem personalizada.

Adaptar o tratamento

Mantenha uma única cena preserve-3d com perspectiva e um apresentador alfa correspondente ao quadro em z=0. Cartões com z negativo passam atrás do locutor; cartões com z positivo passam pelo primeiro plano. Mantenha tanto o vídeo base quanto o recorte no mesmo deslocamento de origem. O exemplo usa oito cartões, uma órbita horizontal de 570px e profundidade de 290px; ajuste o anel para o novo corte do locutor. A pose inicial de cada cartão deve usar uma posição explícita de linha do tempo de 0, para que todos os cartões existam no quadro zero.

Chaves de asset: banana-heels.jpg, blue-stairs.jpg, cactus.jpg, speaker.mp4, speaker_cut.webm, pixel-burger.jpg, pixel-fruit.jpg, red-stairs.jpg. Imagens de exemplo em resolução total e créditos das fontes estão em assets/style-showcase.

Forneça um recorte alfa do mesmo tamanho e correspondente ao quadro ao trocar o apresentador. O kit/cutout.py existente pode criá-lo; veja o guia compartilhado. Inspecione cabelos e mãos tanto em imagens claras quanto escuras. O auxiliar de construção não realiza segmentação automaticamente.

Mantenha o apresentador visível desde o primeiro quadro do resultado. Use fotografias nítidas e tipografia limpa. O texto essencial e o rosto devem evitar sobreposições da plataforma; deixe a imagem decorativa sangrar em vez de encolher toda a composição. As legendas e âncoras de imagem do template são pontos de partida, não rastreamento automático.

Revisar e entregar

O auxiliar valida dimensões/duração da mídia, prepara a composição, executa a verificação do renderizador, renderiza e decodifica completamente o MP4. Inspecione o primeiro quadro, a mudança principal e o final. Verifique âncoras de corte, legibilidade do texto e correspondência de temporização entre fonte e recorte. O padrão é silencioso; preserve ou adicione fala, efeitos sonoros ou música apenas quando o usuário solicitar. Edições mais longas exigem estender a linha do tempo HTML e as janelas de origem; apenas alterar a duração não é suficiente.

Estes são fluxos de trabalho de edição local do Claude Code. Direitos de imagem de terceiros são documentados separadamente da licença de código no diretório de assets.

Estilo da casa

Apenas Inter, um acento (#5000fa), legendas brancas com sombra suave, cartões arredondados e superfícies planas. Mantenha um momento de acento por batida; não adicione cores extras. Para testar outro acento em todo o kit, defina EDIT_ACCENT=#rrggbb, embora estes templates HTML carreguem o hex diretamente: altere-o em template.html / template-16x9.html.

Individual skills in this repo

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

Habilidades Relacionadas