Communitygithub.com

dsauce/stickman-kino

Anime um filme Stickman Kino - escreva scenes.js a partir de film.json/storyboard usando o motor stickman (bonecos articulados com 58 poses e IK, ~190 adereços, gráficos e diagramas, texto cinético, legendas, movimentos de câmera, efeitos, ambientes, temas, transições), sincronizado com a narração e verificado com check + snapshots. Use para qualquer coreografia de cena, movimento, layout ou correção visual em um filme Stickman Kino.

O que é stickman-kino?

Esta skill permite que um agente de IA (como Claude Code, Cursor ou Codex) atue como um animador de filmes Stickman Kino, gerando arquivos `scenes.js` completos. O agente lê um arquivo `film.json` (storyboard) e, usando o motor JavaScript `SM`, cria cenas com figuras de palito articuladas (58 poses e cinemática inversa), adereços, textos cinéticos, gráficos, movimentos de câmera, transições e sincronização labial com narração. A skill é útil para desenvolvedores e criadores de conteúdo que desejam automatizar a produção de animações explicativas, demonstrações de produtos ou vídeos educacionais estilizados. Ela é compatível com qualquer plataforma que execute JavaScript no navegador, e o fluxo de trabalho inclui a verificação obrigatória através do comando `stickman check` (que valida o JavaScript) e `stickman snapshot` (que gera imagens para inspeção visual de sobreposições, clipes, legendas ilegíveis e outros problemas). O agente deve seguir regras de direção, como mudar algo a cada 2-3 segundos, usar gestos significativos nas figuras, e manter a consistência de cores e layout.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dsauce/stickman-kino/tree/HEAD/skills/stickman-animator

Perguntar na sua IA favorita

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

Documentação

Animador Stickman

Você escreve scenes.js - um film.scene(id, sc => { … }) por clipe em film.json, mesmos ids, mesma ordem. Tudo é JavaScript puro no navegador contra o motor global SM. Leia references/api.md (cola completa) e references/cookbook.md (receitas copiáveis) antes de escrever.

Modelo mental

  • Tempo local. Dentro de uma cena, cada tempo é em segundos a partir do início do clipe. sc.dur = duração do clipe.
  • Encadeável. Cada ação retorna o tempo em que termina: const t = bob.walkTo(900, 0.2); bob.wave(t);
  • Sincronizado com a voz. sc.cue("palavra") = tempo local estimado em que o narrador diz aquela palavra (sc.cue(["palavra", 1]) = 2ª ocorrência, sc.cue(0.5) = metade do VO). Coloque o visual na ou logo antes da palavra (sc.cue("ideia") - 0.15).
  • Camadas. world (ambiente) → back (adereços) → figuras → front (adereços sobre figuras) → ui (espaço da tela, ignora câmera) → top (transições). Passe { layer: "front" } / "ui" para adereços.
  • Coordenadas. A tela tem sc.W × sc.H (1920×1080, 1080×1920 ou 1080×1080). sc.groundY é o chão (80% para baixo na paisagem, 74% no retrato). Figuras ficam em pé com y = seus pés.
  • Coisas. Adereços, texto, gráficos, formas são Things: .pop(t) .fadeIn(t) .rise(t) .dropIn(t) .slideIn(t,d,dir) .moveTo(x,y,t,d) .arcTo(x,y,t,d,h) .scaleTo .rotateTo .spin .pulse .shake .wobble .bob(t0,t1) .glow .tint .draw .fadeOut .popOut .hide .show.
  • Oculto até a entrada. Crie com { hidden: true } depois .pop(t); o texto fica oculto até .in(t, fx).

Esqueleto de cena

const film = SM.film();                       // tema/formato vêm do film.json

film.scene("hook", sc => {
  sc.enter("fade");                           // opcional, combinar com saída anterior
  sc.ground();                                // linha do chão (estilo: "grass" | "none")
  const bob = sc.figure({ x: -150, face: "dots" });        // ou sc.character("zeke", {...})
  const t1 = bob.walkTo(sc.W * 0.35, 0.2);
  bob.point(sc.W * 0.7, sc.H * 0.4, sc.cue("isto"));
  const chart = sc.barChart({ x: sc.W * 0.68, y: sc.H * 0.45, data: [{ label: "2024", value: 4 }, { label: "2025", value: 9 }] });
  chart.grow(sc.cue("cresceu"));
  sc.text("Receita [duplicou]", { x: sc.W * 0.68, y: 150, size: 80 }).in(sc.cue("duplicou") - 0.1, "words");
  sc.camera.focus(sc.W * 0.6, sc.H * 0.5, 1.12, 1.0, 3);   // aproximação lenta
  sc.exit("wipe-left");
});

Intros & Outros

Clipes que declaram "intro" / "outro" em film.json se constroem sozinhos. Você não precisa de uma cena para eles. Para adicionar extras (adereços explodindo ao redor do título, uma figura acenando para o CTA), escreva a cena e chame o preset você mesmo; a versão automática é então ignorada:

film.scene("intro", sc => {
  const t = sc.intro("countdown", sc.clip.intro);          // retorna quando o título pousou
  sc.prop("rocket", { x: 1500, y: 300, size: 120, layer: "ui", hidden: true }).pop(t - 0.8);
  sc.exit("wipe-left");
});
film.scene("outro", sc => {
  sc.enter("fade", { color: "bg" });
  sc.outro("kino", sc.clip.outro);
  sc.figure({ x: 1500 }).point(1150, 830, 1.2);
});

Regras de direção (o que faz parecer bom)

  1. Algo muda a cada 2-3 s. Planeje 3 batidas por clipe; preencha lacunas com um zoom de câmera, uma piscada/concordada, um balanço de adereço, um destaque.
  2. Cenário antes de animar. Decida onde a figura, o adereço principal e o texto vão viver (terços em 16:9; empilhados em 9:16). Mantenha o texto longe da cabeça da figura e de outros textos.
  3. Figuras agem, não ficam paradas. Use gestos que significam algo: point para o que está sendo discutido, think antes de uma ideia, surprise em uma revelação, shrug em um mito, celebrate em uma vitória, push/climb/runTo para esforço.
  4. Uma entrada focal de cada vez; espaçe por 0.1-0.2 s quando várias coisas aparecerem.
  5. Combine saídas e entradas entre clipes (mesmo tipo de transição) ou corte combinado (mesma pose/posição de objeto).
  6. Acentos carregam significado: "a1" problema, "a2" solução, "a3" recompensa. Passe nomes de cores: "a1" | "a2" | "a3" | "ink" | "muted" | "soft" | "paper" ou hexadecimal.
  7. Verdade do chão: figuras ficam em pé sobre sc.groundY (ou uma superfície que você computou); adereços que descansam no chão usam y = sc.groundY - size*0.4.
  8. Retrato: figura size: 420-460, adereços 200-300, texto 70-120, mantenha a faixa do meio ocupada e legendas baixas.

Verificar (loop obrigatório)

  1. stickman check <dir> → deve dizer Check passed. page_error = seu JS lançou um erro; corrija.
  2. stickman snapshot <dir> (ou --at tempos em batidas chave) → abra snapshots/contact-sheet*.jpg e os PNGs e olhe. Corrija: clipes, sobreposições, figuras flutuando, momentos vazios, texto ilegível, braços atravessando cabeças (ajuste overrides de pose), cores de acento erradas.
  3. Execute novamente até estar limpo, depois renderize.

Pegadinhas

  • Agende cada figura cronologicamente. celebrate() agenda um retorno a stand em +1.0 s; passe { hold: true } se for posar novamente logo depois.
  • bob.hold(prop) prende à mão direita e permanece na vertical; crie antes de usar e .pop(t).
  • Marcação de texto: "[palavras acentuadas]" colore uma frase com a opção accent (padrão a2).
  • Gráficos contam números com passos discretos; dê prefix/suffix/decimals nas opções do gráfico.
  • Não use Math.random/Date/setTimeout. Use SM.rng(seed).
  • GSAP puro é permitido: sc.tl.to(el, vars, sc.T(localTime)) - mantenha como uma função pura do tempo.

Habilidades Relacionadas