atakoylan125-sketch/AI-Filmmaking-Skills

Encenação top-down com ManimGX: planeie onde tudo numa cena está e renderize como um mapa animado de planta baixa. Use quando alguém quiser encenar ou bloquear uma cena, planear posições de câmara, lentes ou cobertura, colocar luzes, ou verificar o eixo de 180° e a direção de tela — a partir de uma lista de planos completa ou de uma frase casual. Abrange ambiente e objetos-chave, posições, posturas, faces e movimentos dos personagens, fontes de luz física e cada câmara com seu cone de campo de visão. Faz uma breve ronda de perguntas de múltipla escolha específicas da cena quando o briefing é enxuto, mostra o layout e descrições de plano em linguagem simples para aprovação, depois renderiza um MP4 mais uma especificação JSON editável da cena através de um CLI Python independente.

O que é AI-Filmmaking-Skills?

Esta skill é uma ferramenta especializada para encenação e bloqueio de cenas, destinada a cineastas, animadores e criadores de conteúdo que precisam visualizar o layout espacial de uma cena antes da produção. Ela utiliza ManimGX para gerar um mapa animado em planta baixa, mostrando a posição de personagens, objetos, fontes de luz e câmaras, com cones de campo de visão. A skill é útil para planeamento de cobertura, verificação do eixo de 180° e direção de tela, e pode ser usada tanto por profissionais com listas de planos completas quanto por iniciantes com descrições vagas. Ela funciona analisando um briefing, realizando uma ronda de perguntas de múltipla escolha específicas da cena se necessário, gerando um layout proposto para aprovação e, em seguida, renderizando um vídeo MP4 e um arquivo JSON editável da cena através de um script Python independente. A skill não escreve história, diálogo ou atuação, focando-se exclusivamente na colocação espacial e no movimento.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/atakoylan125-sketch/AI-Filmmaking-Skills/tree/HEAD/skills/staging-with-manimgx

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

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

Documentação

Encenação com ManimGX

Apenas colocação. Esta skill não escreve história, diálogo ou atuação, e não está vinculada a nenhum sistema de câmara, gerador de vídeo ou ferramenta de produção. Ela responde a uma pergunta: onde estão todas as coisas e pessoas, como se movem, de onde vem a luz, e onde cada câmara está e para onde olha? A saída é um vídeo curto no estilo de uma planta baixa de diretor: o mapa finalizado mostra por um segundo, depois o mapa é construído, depois os caminhos de movimento, depois as câmaras aparecem uma a uma com seus cones de campo de visão, depois o eixo de 180° e as linhas de visão.

A pessoa pode ser um profissional com uma lista de planos completa ou um iniciante com uma frase. Ambos devem terminar com a mesma qualidade de mapa. O que difere é o caminho até lá: um briefing completo vai direto para um layout proposto; um briefing enxuto passa primeiro por uma breve ronda de perguntas guiadas, para que a pessoa decida a colocação em vez de você adivinhar. As perguntas também ensinam a um iniciante o que um briefing de encenação precisa. Todo caminho termina com um plano que a pessoa aprova ou corrige antes de qualquer renderização.

A arte da encenação — planos, altura da câmara, sensação de lente, leis de colocação, continuidade espacial e como descrever cada plano — está em references/staging-craft.md. Leia-o antes de escolher câmaras, escrever o plano ou executar a verificação final.

Trabalhe apenas a partir da cena à sua frente. Os modelos de perguntas, a tabela de tamanhos e o exemplo de especificação abaixo mostram formas e sintaxe, não conteúdo: nunca carregue suas localizações, adereços, nomes, posições ou cores para uma cena real.

O briefing completo — sete campos

Um briefing está completo quando responde a estes sete. Verifique cada briefing recebido em relação a eles antes de fazer qualquer outra coisa.

#CampoO que definePor que o mapa precisa
1Localizaçãotipo, tamanho e caráter do lugar (pequeno ou grande, apertado ou aberto, estilo ou época) e sua geometria fixa: paredes, portas, janelas, os objetos que importam para o bloqueiodefine a escala de todo o mapa e quais adereços existem
2Posiçõesquem está onde, sua postura (em pé, sentado, deitado, ajoelhado…), quem enfrenta quem, a que distânciaos pontos, etiquetas de postura e setas de direção; o eixo de 180° é desenhado a partir daqui
3Orientaçãode que lado de um personagem está a característica chave (janela, porta, parede, estrada), declarada em relação a um personagem: "janela à sua direita"sem ela, o mapa pode sair espelhado e todos os fundos ficam errados
4Luzcada fonte que importa, onde está fisicamente, de que lado vem, dura ou suavedecide que lado de cada rosto está iluminado e quais planos olham para a luz
5Arredoreso que está nos outros lados da açãotorna-se o fundo de cada plano reverso
6Planosquantos, em que ordem, e o tamanho, lente e ângulo de cada um (close-up no A, dois planos centrados, sobre o ombro de A para B…)estas são as câmaras
7Batidasquem se move, de onde para onde e quando (levanta-se, atravessa, entra, sai, vira-se), e o que acontece em cada planoo movimento altera posições, direções e às vezes o eixo no meio da cena; os movimentos são desenhados como caminhos

Um campo conta como preenchido quando o briefing o declara ou o torna inequívoco ("eles sentam-se em lados opostos de uma cabine" preenche Posições). O campo 7 só importa quando alguém se move: se cada batida é uma linha de diálogo e ninguém se mexe, não precisa de pergunta.

Ronda de perguntas — quando o briefing é enxuto

  1. Avalie o briefing em relação aos sete campos, silenciosamente. Nunca mostre a lista de verificação à pessoa.
  2. Tudo preenchido → salte a ronda de perguntas e vá para Fluxo de Trabalho. Também salte quando a pessoa disser que não quer perguntas ("sorma", "direkt yap", "apenas faça"): preencha as lacunas com valores predefinidos; eles estão listados no plano (Passo 4 do Fluxo de Trabalho).
  3. Algo em falta → pergunte, no idioma da pessoa:
    • No máximo 3 perguntas por mensagem e no máximo 2 mensagens. Ordem: Localização → Posições → Planos primeiro, porque decidem a estrutura do mapa; depois Orientação → Luz → Arredores; Batidas por último.
    • Se Localização e Posições estiverem ambos em falta, pergunte apenas esses dois na primeira mensagem: as opções de todas as outras perguntas dependem das suas respostas.
    • Cada pergunta é de múltipla escolha: 2–4 opções escritas para esta cena, construídas a partir do que o briefing já diz, mais uma opção final "Você decide" (no idioma da pessoa, por exemplo, "Sen öner"). A pessoa pode sempre escrever a sua própria resposta.
    • Marque a opção que escolheria como (recomendado) com algumas palavras de motivo, para que um iniciante possa simplesmente escolhê-la.
    • Cada pergunta traz uma linha curta sobre por que importa para o mapa.
    • Se o seu ambiente tiver uma ferramenta de perguntas de múltipla escolha estruturada, use-a; caso contrário, escreva perguntas numeradas com opções com letras em texto simples.
    • Nunca pergunte o que o briefing já responde. Nunca pergunte sobre história, diálogo ou atuação: esse não é o trabalho desta skill.
    • Quando a pessoa escreve como um profissional (lentes, tamanhos de plano, "sobre o ombro de A", eixo), aceite cada escolha declarada exatamente como dada. Pergunte apenas sobre campos que estão genuinamente em falta, e nunca reabra uma decisão que eles tomaram.
  4. Após as respostas, qualquer coisa ainda em aberto ou respondida com "Você decide" recebe um valor predefinido sensato. Depois vá para Fluxo de Trabalho; o plano no passo 4 é onde a pessoa confirma ou corrige esses valores predefinidos.

Modelos de perguntas

Estes mostram a forma de cada pergunta. Reescreva a redação e as opções para a cena à sua frente; nunca as cole na íntegra.

  • Localização — "Onde isto acontece, e como é o lugar?" → opções construídas a partir do briefing, por exemplo, interior pequeno e apertado · interior grande e aberto · exterior · Você decide. Porquê: define a escala e quais adereços existem.
  • Posições — "Como estão colocados?" → opções que se ajustam ao lugar e às pessoas no briefing, combinando posição e postura (ambos sentados, frente a frente · lado a lado · um sentado, um em pé · Você decide). Porquê: o eixo de 180° é desenhado entre os dois personagens principais.
  • Orientação — "De que lado de está a <janela / porta / parede>?" → à esquerda de · à direita de · atrás de · atrás de . Porquê: sem ela o mapa pode sair espelhado e todos os fundos mudam.
  • Luz — "De onde vem a luz principal?" → fontes que existem neste lugar (do lado da <janela / porta> · de luminárias suspensas · de um prático em cena · de trás de um deles (contraluz) · Você decide). Pergunte sobre dura ou suave apenas se nomearam uma fonte. Porquê: decide que lado de cada rosto está iluminado.
  • Arredores — "O que está do outro lado deles?" → opções que se ajustam à localização. Porquê: é o fundo de cada plano reverso.
  • Planos — "Como quer cobrir a cena?" → Vou dar-lhe uma lista (contagem, ordem, tamanho) · cobertura clássica: um plano aberto, dois sobre o ombro, dois close-ups · um plano contínuo · Você decide. Porquê: estas são as câmaras.
  • Batidas (apenas quando o movimento é plausível) — "Alguém se move durante a cena?" → não, todos ficam parados · <um movimento que esta cena sugere, escrito para ela> · sim (diga-me quem, de onde para onde e quando) · Você decide. Porquê: os movimentos são desenhados como caminhos e podem deslocar o eixo.

Fluxo de Trabalho

  1. Leia a cena — o briefing mais quaisquer respostas da ronda de perguntas. Extraia:

    • a localização, sua geometria fixa e os adereços que importam para o bloqueio (paredes, portas, janelas, móveis, veículos, caminhos);
    • cada personagem: onde estão, postura, o que enfrentam;
    • cada movimento: quem, de onde, por onde, para onde, a direção e postura no final;
    • cada fonte de luz que importa (sol, janela, candeeiro, prático): onde está fisicamente, de que lado vem, quem atinge;
    • a relação principal — o par que mais fala ou se olha. Esse par define o eixo de 180°. Se um movimento muda a geometria, decida o eixo para os planos depois dele;
    • os planos. Se a pessoa os deixou para si ou escolheu cobertura clássica, construa-os você mesmo (veja Cobertura).

    Depois responda a três perguntas para si mesmo antes de dispor qualquer coisa: o que muda fisicamente durante a cena (quem se move, o que é pego, o que abre); o que o público deve ver ao mesmo tempo (duas pessoas no mesmo quadro, um rosto e a porta atrás dele); o que deve permanecer fixo entre planos (a janela iluminada, a mesa, o objeto em que a cena se baseia). As respostas decidem quais adereços ganham nomes, quais planos devem ser dois-planos e onde o eixo deve ser mantido.

  2. Disponha em metros com tamanhos do mundo real (tabela abaixo). Convenção do mapa: +y é "para dentro da cena" visto da câmara principal/de abertura, +x é direita. Coloque a câmara principal ao sul da ação olhando para norte.

  3. Escreva a especificação da cena (JSON, esquema abaixo; JSON Schema completo em references/scene.schema.json) para o diretório de trabalho, depois valide-a sem renderizar: uv run <skill-dir>/scripts/staging_render.py scene.json --check (<skill-dir> é a pasta que contém este SKILL.md). Imprime o relatório resolvido (posições da câmara, avisos) ou uma única linha spec error: ...; corrija e verifique novamente até passar.

  4. Pré-visualize e obtenha aprovação — antes de qualquer renderização. Execute uv run <skill-dir>/scripts/staging_render.py scene.json -o <nome>.mp4 --preview (alguns segundos). Escreve <nome>.preview.png, o mapa finalizado, e <nome>.report.json. Olhe para a pré-visualização primeiro e corrija problemas óbvios (se não conseguir ver imagens, verifique o relatório e diga à pessoa que não pôde inspecionar a imagem). Depois mostre à pessoa a imagem de pré-visualização e um plano compacto no seu idioma:

    • Ambiente — tamanho do espaço, os objetos-chave e onde estão (palavras relativas mais metros);
    • Personagens — posição, postura, direção; depois cada movimento por ordem;
    • Luz — cada fonte, onde está, que lado de quem ilumina;
    • Câmaras — uma tabela: número, tamanho, lente, onde está (por exemplo, "2.9 m frente-direita de A, altura dos olhos"), o que vê, e uma linha sobre por que esta câmara (seu trabalho na cobertura);
    • Descrições dos planos — para cada câmara, uma curta descrição em linguagem simples do quadro, construída a partir da especificação e dos dados frame do relatório com o modelo em references/staging-craft.md: quem e o que está no quadro e de que lado, o que está atrás deles, de que lado a luz vem, direção da linha de visão e lado do eixo. Neutra e factual: sem palavras de estilo ou humor, sem redação para qualquer ferramenta de imagem ou vídeo específica;
    • Eixo de 180° — qual par, de que lado as câmaras permanecem, qualquer plano que seja espelhado ou cruze;
    • Suposições — cada valor que escolheu em vez da pessoa, marcado como tal;
    • Alternativas — duas ou três opções de câmara que a pessoa não mencionou, uma linha cada com sua troca (veja "Oferecer alternativas" em references/staging-craft.md). Aplique uma apenas se eles a escolherem. Peça-lhes que aprovem ou corrijam qualquer coisa ("coloque a porta na outra parede", "faça o plano 3 um close-up", "ela fica sentada"). Aplique correções à especificação, pré-visualize novamente e mostre o plano alterado; repita até aprovarem. Renderize apenas após a aprovação. Salte este passo apenas se a pessoa pediu explicitamente para renderizar sem revisão; então liste as suposições na entrega.
  5. Renderize com o motor incluído, scripts/staging_render.py (caminho relativo à pasta desta skill; não reescreva nem copie): uv run <skill-dir>/scripts/staging_render.py scene.json -o <nome>.mp4 --quality h. Use --quality l para um rascunho rápido. O vídeo abre no mapa finalizado por 1 segundo (--poster 1.0, o padrão), depois faz cross-fade para a construção passo a passo. Esse primeiro quadro é também a miniatura em plataformas sociais, por isso deve mostrar o resultado completo; use --poster 0 apenas se a pessoa pedir uma construção simples. Imprime um relatório JSON com cada personagem, luz e câmara (posição, distância, campo de visão horizontal, e um bloco frame listando quem e o que está à vista em que lado do quadro e de que lado do quadro cada luz vem) e warnings (também guardado como <nome>.report.json), e guarda <nome>.last.png, o mapa finalizado.

  6. Verifique o resultado antes de entregar. Abra <nome>.last.png e olhe para ele (se não conseguir ver imagens, baseie-se no relatório e diga-o): cada etiqueta legível, nenhum ícone de câmara em cima de uma pessoa, cones apontando para o sujeito certo, caminhos de movimento legíveis, legenda não cortada. Depois execute a verificação espacial final em references/staging-craft.md: esquerda/direita e linhas de visão consistentes entre planos, cada entrada e saída possível, objetos fixos e a luz chave no mesmo lugar físico em todos os planos, nenhuma travessia de eixo não marcada. Leia warnings — um plano espelhado automaticamente ou uma câmara a cruzar o eixo deve ser mencionado à pessoa. Corrija a especificação e re-renderize (no máximo duas rondas).

  7. Entregue o vídeo mais o JSON da especificação (para que o layout possa ser editado alterando números) e as descrições de plano aprovadas, atualizadas para a especificação final. No idioma da pessoa, diga em duas ou três linhas quais predefinições permanecem (apenas o que a ronda de perguntas deixou em aberto ou a pessoa devolveu), e qualquer aviso de eixo. As etiquetas do mapa são em inglês, a menos que a pessoa peça o contrário.

Cobertura (quando os planos são deixados para si)

Construa o conjunto mais pequeno que cobre a cena, por ordem de script de filmagem, máximo 8:

  1. Plano aberto de estabelecimento — todos no quadro (target: lista de todos os nomes, size: "wide", lens: 35, from: "S").
  2. Para o par principal A/B: um sobre o ombro de cada um (over_shoulder: B, target: A e o inverso). Escolha os ombros de modo que ambas as câmaras fiquem no mesmo lado do eixo; o motor espelha qualquer uma que não fique e reporta-o.
  3. Planos individuais para as batidas chave: size: "cu" ou "mcu", lens: 85/50, from: "frente-esquerda"/"frente-direita" (relativo à direção do personagem), mesmo lado do eixo.
  4. Inserts para qualquer adereço de que a ação dependa (size: "insert", lens: 85, height: "high" para coisas numa mesa).
  5. Após um movimento: cubra a posição final (target: "A@1"), e dê aos planos após o movimento o seu próprio eixo ("axi…

Habilidades Relacionadas