Communitygithub.com

isometric-svg-animation

Gera diagramas de arquitetura isométrica como SVG animado por meio de um script de build. Use quando for solicitado um diagrama de sistema, pipeline ou arquitetura isométrico ou 2.5D, uma ilustração animada em SVG para um site, ou para revisar um diagrama construído dessa forma.

O que é isometric-svg-animation?

Esta skill cria diagramas isométricos animados em SVG, inteiramente baseados em código, utilizando um único script de build (Node.js). Ela é ideal para desenvolvedores que precisam gerar ilustrações de arquitetura de sistema, pipelines ou fluxos de processo em estilo 2.5D de forma automática e reprodutível. Suporta plataformas como Claude Code, Cursor e Codex, e o resultado é um SVG auto-contido com animações CSS keyframes, que pode ser usado como uma tag `<img>` comum. O fluxo de trabalho envolve definir a história do diagrama, criar um layout estático com auditoria automática de sobreposições e, em seguida, adicionar animações baseadas na geometria do diagrama. A skill enfatiza princípios rigorosos de design, como grades, planos de projeção isométrica e um sistema de tons que representa o estado do fluxo, garantindo que o diagrama final seja preciso, legível e visualmente consistente.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/413ZERO/isometric-svg-animation/tree/HEAD

Perguntar na sua IA favorita

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

Documentação

Animação SVG Isométrica

Um script (node build.mjs) posiciona cada forma em unidades de planta, projeta-a isometricamente e escreve um diagram.svg auto-contido (com keyframes CSS internos, que pode ser usado como uma tag <img> simples) além de preview.html (o mesmo SVG inline e ajustado à janela). Nada é desenhado à mão: cada correção é uma alteração de código e uma reconstrução.

Antes de escrever o script, leia references/generator.md: suas seções e o código central para projeção, cartões, texto no chão, rotas, keyframes, plataformas e montagem.

Passos

  1. História. Leia a documentação do próprio sistema e escreva a história do diagrama em uma linha: o que entra, o que processa, o que impulsiona o trabalho, o que sai. O fluxo é lido da esquerda inferior para a direita superior. Concluído quando cada estágio da linha é um nó que você pode nomear em uma a três palavras e o usuário concorda com a linha.
  2. Briefing. Obtenha uma imagem de referência para o estilo (peso da linha, densidade, estilo da plataforma); quando o usuário não tiver nenhuma, mostre os diagramas em references/examples.md e deixe-o escolher. Defina o tema, a proporção (1.6:1 cabe em uma janela do navegador) e onde o SVG será armazenado. Concluído quando todos os quatro itens estiverem no comentário do cabeçalho do script.
  3. Build estático. Plataformas, nós, rotas, rótulos; sem movimento ainda. Concluído quando a auditoria do build não imprimir sobreposições nem cantos apertados, e o usuário tiver aprovado uma captura de tela do layout.
  4. Movimento. Adicione o loop. Concluído quando um loop conta a história uma vez, em ordem, e a exibição de movimento reduzido mostra o estado finalizado.
  5. Exportação. Veja Exportação abaixo.

Cada rodada de revisão: pegue as notas do usuário uma de cada vez, responda a qualquer pergunta antes de alterar qualquer coisa, copie o build atual para versions/ antes de uma grande alteração e responda com uma captura de tela. Quando o usuário estiver escolhendo entre nomes ou ícones, renderize as opções lado a lado.

Princípios

Conteúdo

  • Um fluxo, poucos detalhes. Cada nó é nomeado pelo que realmente faz; quando um nome é contestado, diga qual é preciso e por quê, então deixe o usuário escolher.
  • Todo rótulo é lido por si só por um estranho. Um rótulo que precisa de explicação é reescrito ou removido.
  • Uma pilha de placas apenas para algo que realmente é uma pilha (as páginas de um relatório); todo outro nó é um único cartão.
  • Desvios honestos permanecem desenhados (entradas que pulam um estágio), mesmo que custem espaço.
  • Sistemas externos ficam em plataformas com o mesmo preenchimento que os internos; uma borda tracejada sozinha os marca como externos.
  • Entradas soltas ficam planas no chão, sem plataforma embaixo.

Geometria

  • Unidades de planta em todos os lugares: a corre ao longo do fluxo (tela para cima e para a direita), b o cruza (tela para baixo e para a direita), z para cima. Posições, tamanhos, espaçamentos e rotas são em unidades de planta; pixels de tela existem apenas dentro da projeção.
  • Um cartão é uma face superior mais uma faixa lateral (o contorno de seus contornos superior e inferior) com um traço no contorno externo, e a face encontra a espessura sem linha. Plataformas traçam sua face superior, já que essa face está na grade.
  • Uma espessura para cada cartão e pílula de módulo. Pílulas de nome ficam planas, sem espessura.
  • Pinte em camadas (chão, plataformas, fios, objetos, rótulos), ordenadas por profundidade dentro de cada uma.

Texto

  • Cada rótulo fica no plano do chão com sua linha de base ao longo de a. Os glifos são convertidos em caminhos em tempo de build, para que o SVG renderize igual como <img> em qualquer lugar e não carregue nenhuma fonte.
  • Os tamanhos vêm de uma pequena tabela (pílula, rótulo, pequeno, legenda, título). Os títulos das plataformas são letras maiúsculas monoespaçadas espaçadas.

Layout

  • Uma grade de chão a 2 unidades. As bordas da plataforma se encaixam para fora nas linhas da grade; os espaçamentos entre plataformas e entre fileiras são células inteiras; um tronco compartilhado corre em uma linha de grade centralizada em seu espaço.
  • As plataformas se dimensionam sozinhas: cada nó e rótulo registra sua área com sua plataforma, e a plataforma é essa caixa mais um preenchimento uniforme, ajustado à grade. Plataformas em uma fileira compartilham suas bordas opostas.
  • Um título de plataforma fica tão longe da borda esquerda quanto da borda frontal (medido até a base de suas maiúsculas), alinhado à esquerda com o conteúdo.
  • A grade se estende além de cada borda do quadro e desaparece através de uma elipse com a proporção do quadro, para que a imagem não tenha borda rígida. O fundo é transparente.
  • Cada build imprime uma auditoria: as quatro margens de cada plataforma, os espaçamentos entre plataformas, sobreposições de rótulo × rótulo e rótulo × cartão, e cantos muito apertados para seu raio. Leia-a antes de mostrar qualquer coisa.

Linhas

  • Cada conexão é um caminho contínuo: ortogonal, com cantos de um quarto de volta de um raio fixo, de modo que rotas que compartilham um trecho o compartilham exatamente e uma ramificação sai de seu tronco ao longo de uma tangente. Desenhe as rotas primeiro e os nós por cima; o resultado não tem tocos, bifurcações ou lacunas.
  • Os tipos de linha diferem pelo padrão: sólido para o fluxo, tracejado para um trilho externo, pontos redondos para acesso somente leitura.

Tom

  • Tom é estado. Apenas neutros (R = G = B). Claro = ainda não alcançado, um tom mais escuro = sua entrada está pronta, mais escuro = completo nesta execução. Ícones e contornos seguem a mesma regra, de modo que qualquer "por que este é mais escuro?" tem um estado para sua resposta. A tinta mais escura é um cinza médio-escuro; preto puro e blocos escuros sólidos são evitados.
  • As linhas descansam muito claras e escurecem apenas depois que uma luz percorreu por elas.
  • Cor significa trabalhando agora: o cartão permanece branco enquanto uma sugestão do gradiente da marca aparece por baixo dele, com um brilho fraco ao redor. As luzes pegam sua cor de um gradiente colocado em toda a imagem ao longo do fluxo.
  • Um acento para uma fase (por exemplo, entradas sendo coletadas) é mostrado apenas enquanto aceso, depois retorna ao cinza em que descansava.

Movimento

  • Animação SVG: keyframes CSS dentro do SVG, sem script, funcionando como <img>. Um vídeo renderizado apenas quando solicitado.
  • O estilo de repouso é a execução completa; os keyframes iniciam cada loop a partir de uma execução não tocada. Movimento reduzido e uma exportação estática, portanto, mostram o diagrama completo.
  • O tempo vem da geometria. As luzes viajam a uma velocidade de tela (cerca de 400 px/s); cada chegada é início + comprimento da rota ÷ velocidade, e o próximo evento é essa chegada mais uma pausa. Mova um nó e a linha do tempo segue. Calcule toda a linha do tempo, e o comprimento do loop junto com ela, antes de escrever qualquer keyframe.
  • Um loop conta a história uma vez: as entradas viajam para dentro, o driver executa de cima para baixo, as peças se reúnem e a saída se monta, exporta, segura, limpa, repete. Lento o suficiente para acompanhar (cerca de 20 s).
  • Uma luz é um traço curto executado ao longo de sua rota com um halo mais suave e mais amplo; um traço mais escuro permanece atrás dela até que o loop limpe. Um nó em funcionamento levanta alguns pixels, brilha e exibe sua face gradiente.

Custo de renderização

Como <img>, qualquer animação em execução faz o navegador re-rasterizar a imagem inteira a cada quadro.

  • Máscaras, filtros e grupos permanecem pequenos: a grade desaparece através de seu próprio gradiente de traço, e uma máscara abraça o caminho que revela.
  • Qualquer coisa que não pode ser vista é visibility: hidden (opacidade 0 e um traço estacionado fora de seu caminho ainda são pintados).
  • Keyframes idênticos são escritos uma vez.

Exportação

  • PNG estático: abra o próprio documento SVG com a emulação de movimento reduzido ativada e tire uma captura de tela. Dentro de um <img>, a emulação nunca atinge o SVG e você captura o primeiro quadro do loop.
  • As prévias residem em uma página independente servida localmente, fora do site do usuário, até que o usuário coloque o SVG.

Habilidades Relacionadas