video-to-blender: transforme vídeos de referência, imagens ou ideias em sistemas de nós procedurais editáveis do Blender

Para quem é

Este Skill é para usuários que querem reproduzir um vídeo de referência, uma imagem ou uma ideia no Blender usando nós procedurais (Geometry Nodes, Shader Nodes, compositor). Ele vem com uma biblioteca testada de grupos de nós NK e um construtor Python nodekit, acionado por um agente de codificação, que ajuda a localizar grupos de nós, construí-los e validar o resultado.

Pré-requisitos obrigatórios:

• É necessário Blender 5.2 ou superior, disponível e utilizável: blender no PATH, a variável de ambiente $BLENDER, ou o aplicativo macOS.
• É necessário um agente de codificação compatível para conduzir o fluxo de trabalho.
• Situações inadequadas: as evidências não indicam se há uso offline sem depender do Blender, não especificam quais formatos de vídeo de entrada são suportados nem o intervalo de idiomas de materiais suportados — tudo isso é desconhecido, não faça suposições. Se o seu ambiente não puder fornecer Blender 5.2+, não é possível confirmar dentro do escopo das evidências se o uso é viável.

Primeira tentativa em 3 minutos

Caminho principal recomendado: instalar via marketplace oficial de plugins no Claude Code.

1. Pré-requisito: Claude Code instalado e Blender 5.2+ disponível (blender no PATH, $BLENDER configurado, ou aplicativo macOS).
2. Local e comando de instalação (texto oficial):

claude plugin marketplace add gokayfem/video-to-blender

Em seguida, instale o plugin seguindo o fluxo oficial.

1. Acione uma tarefa de baixo risco: peça ao agente para converter um vídeo de referência ou uma imagem sua em um sistema de nós procedurais editável do Blender. Na primeira tentativa, recomenda-se começar pela construção de um único grupo de nós, para facilitar a observação do resultado.

2. No fluxo de trabalho central oficial, o agente usa nodes_tools.py search para localizar grupos de nós na biblioteca, usa try para construir um grupo sobre entradas de teste, imprime seus avisos de nós e lint, e renderiza um quadro estático; depois, validate.py reabre o .blend salvo e verifica avisos, contagens, tempos de avaliação e lacunas de câmera.

Sinais de sucesso: try emitiu avisos de nós e lint, e renderizou um quadro estático; validate.py reabriu o .blend e relatou os resultados da verificação (avisos, contagens, tempos de avaliação, lacunas de câmera). Esses são os resultados observáveis explicitamente descritos nas evidências.

Observação: a documentação oficial também apresenta outras formas de instalação — para agentes como Codex, Cursor, Gemini CLI, Copilot etc., há a skills CLI (npx skills add gokayfem/video-to-blender), e no Claude Code também é possível copiar manualmente (cp -R skills/procedural-blender-nodes ~/.claude/skills/). Essas são alternativas secundárias, não o caminho principal recomendado aqui. Construir nós e salvar o .blend são ações que escrevem arquivos; antes da primeira tentativa, confirme que você aceita gerar arquivos .blend e saídas de renderização no Blender; além disso, se o Skill executa outros comandos ou acessa a rede, as evidências não indicam — é desconhecido.

Casos de uso

Caso 1: gerar um sistema de nós a partir de um vídeo de referência. Cenário: você tem um vídeo cujo efeito visual deseja reproduzir. Inicie a tarefa com o agente: "com este vídeo de referência, monte um sistema de nós procedurais editável no Blender". O agente seguirá o fluxo oficial: usará nodes_tools.py search para localizar grupos adequados na biblioteca NK, usará try para construir e renderizar um quadro estático e, em seguida, usará validate.py para reverificar avisos, contagens, tempos de avaliação e lacunas de câmera do .blend. Resultado esperado: um sistema de nós editável de Geometry/Shader/compositor e um relatório de validação. Quanto aos formatos de vídeo especificamente suportados, as evidências não indicam; siga o retorno real do agente.

Caso 2: construir e validar um único grupo de nós a partir de uma imagem ou ideia. Cenário: você só quer testar um material ou efeito de geometria. Peça ao agente para "construir um grupo de nós sobre entradas de teste a partir desta imagem (ou desta ideia)". O agente chamará try para construir o grupo sobre entradas de teste, imprimirá avisos de nós e lint e renderizará um quadro estático; depois usará validate.py para reabrir o .blend salvo e verificar. Resultado esperado: a lista de avisos do grupo, os resultados do lint e um quadro estático renderizado; se o relatório de validação contiver avisos, você pode pedir ao agente para ajustar e tentar novamente.

Limites de uso

• Arquivos e efeitos colaterais: o fluxo de trabalho constrói nós e salva o .blend, e validate.py reabre esse .blend; renderizar o quadro estático gera saídas. Os pontos de confirmação explícitos antes da construção são a escolha do material de referência (vídeo/imagem/ideia) e o alvo a construir. O Skill produz o sistema de nós e informações de validação; se ele modifica diretamente outros seus arquivos, as evidências não indicam.
• Comandos e rede: as chamadas de script confirmadas pelas evidências são nodes_tools.py search, try e validate.py; se executa outros comandos ou acessa a rede, não está especificado — é desconhecido.
• Ambiente de execução e clientes: é obrigatório fornecer Blender 5.2+ (blender no PATH, $BLENDER ou aplicativo macOS). No Claude Code, instalação via marketplace de plugins; para agentes como Codex, Cursor, Gemini CLI, Copilot etc., instalação via skills CLI; as evidências não indicam se o Skill funciona apenas nos clientes listados — se outros agentes podem usá-lo é desconhecido.
• Limitações oficiais explícitas e informações não confirmadas: não foram encontradas informações sobre formatos de entrada suportados, intervalo de idiomas, formas de uso offline, nem sobre operações além de try/validate.py; não faça inferências por conta própria.