krishnagoswami52/stickman

/stickman

Transforme um tópico em um filme stickman finalizado, renderizado inteiramente a partir de código: personagens 2D planos, uma paleta crepuscular, movimentos de câmera cinematográficos e som real. A skill cobre quatro saídas: o vídeo, o roteiro de narração, títulos para YouTube e prompts para miniaturas.

Funciona em qualquer lugar onde o Claude possa executar código, incluindo o plano gratuito do Claude. Nenhuma ferramenta paga é necessária e nenhuma ferramenta de imagem ou vídeo com IA é usada. ElevenLabs é opcional e usado apenas para narração. Sem um MP3, a skill fala o roteiro por si mesma com uma voz gratuita de código aberto (scripts/tts.py, veja references/free-voice.md), então um filme narrado não precisa de ElevenLabs.

Tudo abaixo é relativo à pasta desta skill (a pasta que contém este arquivo). Encontre seu caminho absoluto uma vez e use-o para cada script. No Claude Code é ${CLAUDE_SKILL_DIR}. Chame-o de SKILL nos comandos abaixo. Use python3, ou python no Windows.

Etapa 1: Entender o que foi solicitado

O usuário pode querer o pacote completo ou apenas uma parte. Faça apenas o que foi solicitado:

Solicitação	Faça
Ideias de histórias	Faça "Ideias de histórias" abaixo e pare
Fazer um vídeo	Etapas 2 a 6
Escrever um roteiro de narração	Leia references/script-playbook.md, entregue o roteiro e pare
Transformar um roteiro em narração	Leia references/free-voice.md, execute tts.py, entregue vo.mp3 e pare
Títulos ou miniaturas	Leia references/packaging-playbook.md, entregue os pares e pare
Pacote completo	Roteiro, depois vídeo, depois títulos e prompts de miniatura

Ideias de histórias

Se a duração não for informada, primeiro pergunte quanto tempo os vídeos devem ter. Em seguida, dê 5 ideias numeradas para que a pessoa possa escolher uma pelo número. Cada ideia tem um nome curto, uma frase simples dizendo o que acontece e o final. Ajuste cada ideia à duração: menos de 20 segundos significa um personagem e uma reviravolta simples. As ideias devem ser fáceis de animar com o que está em references/engine.md, e cada uma deve ser original. Posteriormente, "fazer ideia 3" significa aquela ideia.

Etapa 2: Perguntar antes de construir

A menos que o pedido já esteja claro, faça estas perguntas juntas em uma única mensagem e use uma ferramenta de perguntas, se houver. Pule qualquer coisa já respondida. Se não houver ninguém para responder, use o padrão e diga isso.

1. Estilo: 2D ou 3D? Padrão 2D. Ambos usam a mesma aparência. 3D adiciona movimentos reais de câmera ao redor da cena.
2. Duração: quanto tempo? Padrão 30 segundos. Com um MP3, a narração define a duração.
3. Narração: sim ou não? Pule isso se um MP3 estiver anexado. Se sim, eles fornecem um MP3 e o texto do roteiro, ou pedem que você escreva um roteiro para ElevenLabs e volte com o MP3. Nenhum SRT é necessário. Ou, o padrão quando não há MP3: a voz gratuita embutida fala o roteiro, o deles ou um que você escreva, para que eles nunca saiam do chat. Pergunte qual voz apenas se eles se importarem; references/free-voice.md tem a audição.
4. Efeitos sonoros: sim ou não? Padrão sim.
5. Música de fundo: sim ou não? Padrão não. Se sim, use a faixa enviada por eles, se houver; caso contrário, a base musical gerada por código.
6. Storyboard: você quer ver um storyboard primeiro? Sempre pergunte isso, a menos que o pedido já diga. Se não houver ninguém para responder, pule.

Não presuma música, efeitos ou voz. Ambiente silencioso de sala não é música.

Etapa 3: Configuração

python3 SKILL/scripts/doctor.py
python3 SKILL/scripts/new_film.py film        # adicione --3d para 3D

doctor.py instala o que estiver faltando. Se o Chromium não puder ser executado, vá para "Se a renderização não for possível".

Voz gratuita: faça agora, antes do planejamento, porque a voz define o tempo. Salve o roteiro como film/script.txt, depois execute python3 SKILL/scripts/tts.py film film/script.txt --voice am_michael e defina VOICE = "vo.wav" em film/audio_mix.py. Detalhes em references/free-voice.md.

Em seguida, leia, nesta ordem:

1. references/style-bible.md: a aparência e as regras que nunca mudam.
2. references/production.md: o caminho rápido e as armadilhas conhecidas.
3. references/engine.md: o kit de ferramentas, para reutilizá-lo em vez de redesenhar.
4. references/film-craft.md: história e enquadramentos para filmes mudos ou curtos.

Leia também quando relevante: references/script-playbook.md para escrever um roteiro, references/free-voice.md para a voz gratuita embutida, references/voiceover.md para um MP3, references/sound.md para a mixagem, references/symbolic-beats.md para filmes de cerca de um minuto ou mais, references/3d.md para 3D.

Etapa 4: Planejar o filme

Escreva estes itens antes de qualquer código de desenho, porque planejar dentro do código produz slides, não filmes:

1. Uma frase que um espectador distraído entenderia.
2. Uma lista de batidas onde cada batida tem uma ação, um sentimento, uma câmera e um som.
3. Um mundo: uma lista de posições fixas para cada personagem e adereço. Cada cena é apenas uma câmera naquele mundo.
4. Uma lista de cenas com quadros de corte, não segundos. Mire em 8 a 11 cenas por 30 segundos e inclua uma cena aberta que mostre a geografia.
5. O momento da miniatura, se um pacote foi solicitado, para que exista como uma cena real.

Se um storyboard foi solicitado, siga "Storyboard" na Etapa 5 antes de renderizar.

Etapa 5: Construir

1. Substitua film/film.js, mantendo os arquivos do motor. Comece pelos padrões no filme inicial.
2. Verifique imagens estáticas nos momentos mais movimentados e veja a imagem: python3 SKILL/scripts/stills.py film sheet.jpg 1 4.5 9 .... Duas rodadas é normal.
3. Storyboard, se solicitado. Execute python3 SKILL/scripts/storyboard.py film. Ele escreve film/storyboard.jpg, uma prévia numerada por cena, desenhada pelo mesmo código do filme final. Mostre à pessoa uma tabela com uma linha por cena (cena, tempo, o que acontece, câmera, som) e mostre ou envie a imagem. Se as imagens não puderem ser mostradas aqui, envie o arquivo, ou dê apenas a tabela e diga isso. Em seguida, pare e aguarde. Altere o filme conforme solicitado, execute novamente o storyboard se mudou muito, e renderize somente após a aprovação.
4. Edite o bloco marcado de film/audio_mix.py para corresponder ao resumo do som.
5. Renderize, misture, junte e audite com um comando:

python3 SKILL/scripts/build.py film --out meu-filme.mp4

Execute isso em segundo plano se o ambiente limitar o tempo do comando e monitore. Executar o mesmo comando novamente retoma, porque cada cena é seu próprio arquivo. Após uma correção, use --shots 3 7 para refazer apenas aquelas cenas, ou --audio-only para remixar o som.

Etapa 6: Verificar e entregar

build.py termina com a auditoria. Corrija cada ISSUE, ou declare por que um momento sinalizado é intencional. Em seguida, veja film/contact_sheet.jpg, que vem do arquivo codificado. Verifique estes itens visualmente, porque a auditoria não pode:

• Os rostos transmitem a emoção pretendida, e as sobrancelhas não estão acidentalmente irritadas.
• As mãos tocam o que seguram, e nada cruza o rosto.
• Os braços dobram no sentido correto em cada caminhada.
• As portas abrem primeiro e, em seguida, o personagem entra.
• Os personagens mantêm a mesma distância dos objetos de cena para cena.
• Nenhum círculo decorativo em lugar nenhum.

Entregue o MP4 com uma nota curta. Diga claramente que você não pode ouvir a mixagem: você a mediu, então o usuário deve ouvi-la. Não reivindique verificações que você não executou. Se o usuário pediu títulos e miniaturas, adicione os pares do manual de empacotamento.

Se a renderização não for possível

Se nenhuma execução de código ou navegador estiver disponível, execute python3 SKILL/scripts/bundle_player.py film quando puder, que escreve um arquivo HTML que reproduz o filme e grava um WebM em tempo real. Se você não puder executar nada, diga o que está faltando e ofereça o roteiro, títulos e prompts de miniatura, que não precisam de renderização. Nunca renomeie um WebM para MP4.

Regras de originalidade

Vídeos de referência, títulos, miniaturas ou transcrições que um usuário compartilha são apenas para padrões gerais: duração, redação, estrutura, ritmo. Nunca copie ou salve nada específico do trabalho de outra pessoa e nunca reutilize uma premissa, personagem, enredo, fala ou aparência. Cada filme recebe sua própria história.