Communitygithub.com

stick-scene

Cria pequenas cenas animadas com palitos desenhados à mão para páginas de destino e sites, onde um palito opera uma máquina ou adereço que demonstra o que um produto faz (puxar uma alavanca, fixar um bilhete, carimbar uma página). Cada uma é um widget de tela interativo, `<stick-scene>`, que fica ocioso suavemente e executa uma pequena ação ao clicar, passar o mouse ou ao ser rolado para a visualização.

O que é stick-scene?

Este skill cria animações de palitos (stick figures) no estilo tinta-e-manteiga de Kamran, projetadas para explicar visualmente a funcionalidade de um produto em uma landing page ou site. Cada cena é um componente `<stick-scene>` autônomo que desenha em um elemento `<canvas>` e funciona sem dependências externas. O skill fornece um runtime completo (`stick.js`), uma plantilla para novas cenas (`scene.js`), e um conjunto de ferramentas para verificar a qualidade: um script para gerar folhas de contato de frames congelados (`frames.mjs`) e outro para detectar artefatos de animação como articulações estalando ou braços atravessando o rosto (`motion.mjs`). O fluxo de trabalho recomendado envolve entender o produto, sugerir 2-3 metáforas físicas (alavanca, carimbo, pinboard) para o usuário escolher, escrever a cena com foco em mostrar o resultado final, e verificar rigorosamente cada quadro e o movimento completo antes de considerar a cena pronta. O sistema também suporta temas de cores, etiquetas de acessibilidade e modos de reprodução (por clique, hover, loop ou ao ficar visível), sendo ideal para desenvolvedores que desejam adicionar animações explicativas, divertidas e de alto impacto visual em suas interfaces web.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nilbuild/stick-scene/tree/HEAD

Perguntar na sua IA favorita

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

Documentação

Stick scene

Um palito no estilo tinta-e-manteiga de Kamran faz um trabalho que mostra o que um produto faz. A cena fica ociosa (respira, olha, coça o queixo) e executa uma ação de 5 a 8 segundos quando acionada, depois retorna ao estado de repouso. É um único <canvas> dentro de um elemento <stick-scene>, sem dependências.

Tudo aqui é comprovado em ~90 cenas em kamranahmed.info/story. Comece a partir desses padrões; não invente um novo estilo de desenho.

Arquivos

  • runtime/stick.js: todo o runtime. A estrutura (figura, poses, easing, caneta), um kit de adereços, o palco e o elemento <stick-scene>. Copie-o para a pasta estática do projeto sem modificações.
  • templates/scene.js: o ponto de partida para uma nova cena.
  • templates/preview.html + scripts/frames.mjs: renderiza uma cena congelada em momentos escolhidos em uma folha de contato e relata erros.
  • scripts/motion.mjs: percorre uma cena a 60 qps e relata falhas que um quadro congelado pode esconder: articulações que estalam, um braço através do rosto, um adereço desenhado sobre a cabeça, um cotovelo dobrado para o lado errado ou projetado para trás, uma virada esmagada, pés deslizando, uma mão que não alcança, e um salto onde a ação começa ou termina.
  • references/craft.md: folha de dicas da API, livro de receitas de poses, receita de temporização, receitas de adereços, catálogo de metáforas e os erros já cometidos uma vez. Leia-o antes de escrever uma cena.
  • examples/: cenas reais. diffity-review.js (comentário → correção do agente → aprovar, duas figuras, um quadro e uma mesa) é o exemplo completo mais limpo. scenes-p3.js e scenes-p4.js contêm ~30 mais; o catálogo de metáforas em craft.md diz qual é qual.

Fluxo de trabalho

  1. Entenda o produto. Uma linha cada: o que o usuário faz, o que ele obtém. Leia a landing page ou README, se houver.
  2. Sugira 2 a 3 metáforas e deixe o usuário escolher, a menos que ele tenha dito para ir em frente. Uma linha por ideia: o adereço, a ação, o resultado. Uma boa é física (alavanca, carimbo, esteira, quadro de avisos, trilho de quadros, pilha de caixas), lê-se em um relance sem a legenda e termina em um resultado visível (um visto, um carimbo, algo subindo ou acendendo). Veja o catálogo em craft.md.
  3. Escreva a cena a partir de templates/scene.js. Primeiro, organize os adereços em coordenadas mundiais fixas, depois a ociosidade, depois a ação como uma linha do tempo ao longo de T segundos. Dê ao label uma frase simples para leitores de tela.
  4. Verifique com a folha de contato. Olhe cada folha antes de considerar a cena pronta:
    # uma vez, em um diretório temporário:  npm i [email protected]
    NODE_PATH=<temp>/node_modules node <caminho-skill>/scripts/frames.mjs \
      --scene <id> --src caminho/para/scene.js \
      --frames "idle:0,idle:2.5,s:0.8,s:1.6,s:2.4,s:3.2,s:4.0,s:5.0" --fw 400 --out /tmp/<id>.png
    
    <caminho-skill> é a pasta onde este SKILL.md está. Em seguida, leia o PNG. idle:<seg> congela o loop de repouso, s:<seg> um momento na ação, u:<0..1> uma fração dela. Adicione @<n> para renderizar a n-ésima execução (s:2.4@1), para que cenas que variam com S.n tenham todas as variantes verificadas. Corrija e renderize novamente até: nada esteja cortado nas bordas, nenhum adereço cubra o rosto ou a coisa sendo explicada, cada batida se leia sozinha, o texto fique dentro de sua caixa com espaço acima e abaixo, as mãos estejam na frente do que seguram, as coisas seguradas encontrem o corpo onde uma real encontraria (um microfone na boca, uma alça na palma), as setas sejam chevrons desenhados à mão, não triângulos preenchidos, e o último quadro corresponda ao estado ocioso (nenhum salto quando volta ao loop). Duas ou três rodadas é normal. Em seguida, verifique o movimento, que a folha não pode mostrar:
    NODE_PATH=<temp>/node_modules node <caminho-skill>/scripts/motion.mjs --scene <id> --src caminho/para/scene.js
    
    Corrija cada jump (misture a pose em vez de alterná-la), arm-through-face (braço através do rosto), head-covered (cabeça coberta por um adereço, nota ou bolha), bent-back-elbow (cotovelo dobrado para trás), elbow-out-back (braço de asa quebrada mantido por mais de um momento), squash (esmagamento), start-pop (salto no início) e end-pop (salto no fim) até que imprima "motion is clean". Um skate (deslize) curto no início ou fim de uma caminhada é aceitável.
  5. Embuta-a. Copie runtime/stick.js e o arquivo da cena para a pasta estática do site e adicione:
    <stick-scene scene="<id>" play="view" style="height:230px; max-width:560px"></stick-scene>
    <script src="/scenes/stick.js" defer></script>
    <script src="/scenes/<id>.js" defer></script>
    
    No Astro, use <script is:inline ... defer>. stick.js deve vir antes de cada script de cena na ordem do documento (scripts com defer são executados em ordem e as cenas leem window.RIG ao carregar). Em uma landing page com várias cenas, coloque cada uma em um quadro para que não flutue em uma linha de base nua: um cartão arredondado com borda de 1px, fundo branco, uma grade de pontos fraca (radial-gradient(#e6e6e6 1px, transparent 1.2px) em 14px) e a faixa do chão mantida (sem no-floor); a linha do chão então corre de ponta a ponta como um pequeno palco. Dê a cada cena na página o mesmo quadro e largura total do conteúdo. Em seguida, carregue a página real em um navegador sem cabeça, role o elemento para a visualização, aguarde ~3 s e faça uma captura de tela nas larguras de desktop e celular.

O elemento

  • scene: o id registrado como SCENES['<id>'].
  • play: view (executa uma vez quando meio visível, depois ao clicar; melhor padrão para landing pages), click, hover (loop enquanto o mouse está sobre ele, clique no toque), loop (sempre executando, use com moderação), idle (nunca executa).
  • no-floor: remove a faixa cinza clara sob a linha do chão. Use em páginas brancas simples. no-ground: remove também a linha.
  • zoom: escala o desenho para cima ou para baixo dentro da caixa (padrão 1).
  • label ou aria-label: o que a cena mostra. O padrão é o label da cena.
  • no-font: não carrega Balsamiq Sans do Google Fonts (quando o site já a hospeda ou não pode chamar o Google).
  • Dimensione com CSS. O desenho se ajusta à altura (230px é o tamanho nativo) e à width da cena em unidades mundiais, centralizado.
  • Movimento reduzido mostra um quadro estático e nunca executa. Cenas fora da tela não são desenhadas.
  • STICK.theme({ butter: '#…', greenInk: '#…' }) troca as cores da paleta para toda a página. Prefira constantes de cor locais na cena (como os verdes de adicionar/remover do GitHub em diffity-review.js) quando apenas uma cena precisar delas.

Regras de estilo

  • Tinta #141414, preenchimentos de papel branco, um destaque manteiga ou acento, muito espaço vazio. Balsamiq Sans em 8,5–11px para quaisquer palavras, e apenas algumas palavras.
  • A figura é a heroína: nunca esconda sua cabeça ou a mão ativa atrás de um adereço. Desenhe os adereços primeiro, depois as figuras, depois as coisas seguradas ou voando.
  • Uma ideia por cena. Se você precisar de uma legenda para explicá-la, a metáfora está errada.
  • Mostre o resultado, não o trabalho: termine em algo que mudou de estado e permanece por um momento.
  • Objetos físicos em vez de animais desenhados ou personagens detalhados. Uma segunda figura (um ajudante) recebe uma única cor via ink/far. Um agente de IA é um robô: fig(..., { ink: '#d97757', far: '#e8b7a3', bot: { col: '#d97757', dark: '#a8553a', glow, blink, happy } }) desenha uma cabeça arredondada com um visor escuro e olhos brilhantes, parafusos de orelha, uma antena e uma luz no peito. Um segundo agente vai em verde-azulado (#3d7a8c, dark #2a5866, far #a9c9d1). Um agente preto também funciona: um col escuro recebe um visor branco e olhos de tinta automaticamente. Luz glow enquanto trabalha, happy quando termina, e coloque uma pequena etiqueta (você, agente, claude) sob cada figura em y = 16.
  • Agentes não devem reagir instantaneamente. Segure um momento após uma solicitação chegar (uma linha pensando…, uma bolha hmm…, uma mão no queixo, uma piscada lenta da antena) antes de o trabalho começar.
  • Não use logotipos de outras empresas. Nomes de produtos como texto simples em um adereço são aceitáveis.

Habilidades Relacionadas