CommunityImagemgithub.com

Diagramas HTML e Apresentações

Construa diagramas SVG interativos e animados, figuras de arquitetura desenhadas à mão e slides 16:9 como arquivos HTML autônomos (temas claro e escuro, construções em etapas com legendas, pacotes fluindo por conectores, detalhes ao passar o mouse, verificação de layout, um sprite de 50 ícones incluindo símbolos de grade/energia).

O que é Diagramas HTML e Apresentações?

Esta skill permite criar diagramas animados e interativos em SVG, figuras de arquitetura com estilo 'hand-drawn' e apresentações de slides 16:9, tudo em um único arquivo HTML autocontido. Ela é ideal para desenvolvedores e agentes de IA que precisam gerar diagramas de fluxo, visões de plataforma, figuras explicativas, walkthroughs em etapas ou apresentações completas para uso em ferramentas como Claude Code, GitHub Copilot e outros agentes que leem skills do Agent Skills. A skill fornece duas bibliotecas de figuras (EdgeDiagram para grafos declarativos e EdgeSketch para figuras desenhadas à mão), um mecanismo de slides (EdgeDeck), três temas (engineering, indigo, drafting) com suporte a temas claro e escuro, e templates prontos. O fluxo de trabalho envolve decidir o que a figura deve mostrar, selecionar a biblioteca adequada, copiar um template, definir o layout em uma grade, escrever os passos de animação, aplicar um tema, e depois construir, verificar e publicar o arquivo HTML. A skill também inclui scripts para verificar contraste WCAG, exportar para draw.io, criar temas a partir de um arquivo de design, e fazer screenshots headless.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nilsonfh/trazo/tree/HEAD/skills/html-diagrams-decks

Installed? Explore more Imagem skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Perguntar na sua IA favorita

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

Documentação

O que Diagramas HTML e Apresentações faz?

Esta skill (uma Agent Skill: Claude Code, GitHub Copilot e outros agentes a leem) fornece duas pequenas bibliotecas de figuras, um mecanismo de apresentação, três temas e três modelos. Cada resultado é um arquivo HTML que funciona offline após o cache do GSAP, segue o tema claro ou escuro do visualizador e pode ser publicado como um artefato do claude.ai.

CaminhoO que é
lib/edgediagram.jsGrafos SVG declarativos: zone, node, text, link (ortogonal por padrão, setas, rótulos, fluxos de pacotes), fan (um ponto alimentando vários nós), bindFocus, steps, e uma verificação de layout a cada etapa
lib/edgesketch.jsFiguras desenhadas à mão em uma grade: zone, box (ajusta seu texto; colunas verticais e barras centralizadas), arrow (ângulos retos, duas cabeças), connect (caixa a caixa), fan, text; e EdgeSketch.check, uma verificação de layout para qualquer SVG, incluindo fios inclinados e curvos
lib/icons.jswindow.EDGE_ICONS: 50 ícones de linha em uma grade de 24 unidades (equipamentos de grade, computação, confiança, operações)
lib/edgedeck.jsEdgeDeck.run: um palco de slides 1600×900 com etapas por slide, legendas, teclado, swipe e links #n
themes/*.cssTemas de cor e tipo, claro e escuro, em um único contrato de tokens: engineering (azul sobre verde-cinza, Archivo Narrow e IBM Plex), indigo (índigo sobre lavanda-cinza, Space Grotesk e Inter), drafting (verde-azulado sobre papel quente, Barlow Condensed e Source Sans 3)
templates/diagram.htmlUma figura EdgeDiagram com etapas, legendas, Anterior/Próximo e pontos
templates/sketch.htmlUma figura EdgeSketch desenhada à mão: zonas da esquerda para a direita, colunas, serviços, setas de duas cabeças, uma legenda
templates/deck.htmlUm slide de título mais um slide de conteúdo cujo diagrama é construído passo a passo
scripts/inline.pyEmbuti os arquivos da biblioteca e o tema na página para que ela seja publicada como um único arquivo; falha em qualquer coisa que não encontrar
scripts/shot.shScreenshots headless (claro ou escuro, qualquer largura, após cliques dados, --only um elemento, --full página) e --check, a verificação de layout de cada figura em uma página
scripts/todrawio.shExporta uma figura de uma página construída para um arquivo draw.io, para ser editada lá: figuras EdgeDiagram com seus links anexados, figuras SVG desenhadas à mão, figuras HTML
scripts/check_theme.pyVerifica o contraste WCAG de um tema no claro e escuro, e se seus dois blocos escuros concordam
scripts/theme_from_design.pyCria um tema a partir de um arquivo DESIGN.md (as cores e fontes de uma marca), claro e escuro, cada par com seu contraste
scripts/test.shExecuta os testes em tests/; execute-o após alterar lib/, scripts/ ou themes/
scripts/vendor.shCopia a biblioteca para outro projeto, e --check mostra se essa cópia está desatualizada
references/api.mdTodas as opções de ambas as bibliotecas e do mecanismo de apresentação
references/conventions.mdTokens, o significado de cada tom, regras de layout, publicação e as verificações a serem executadas
examples/ci-canary-deck.htmlUma apresentação completa de dois slides sobre um fluxo de trabalho neutro (CI/CD, depois um rollout canário)
examples/isometric/Um gerador de figuras em camadas isométricas (o cubo SGAM), com lições aprendidas
examples/design-md/DESIGN.mdUm exemplo de DESIGN.md (Harbor) para criar um tema a partir dele

Fluxo de trabalho

  1. Decida o que a figura deve mostrar. Nomeie o mecanismo, as partes das quais depende e a sequência para revelá-lo. Uma frase que o diga mais rápido vence uma figura.
  2. Escolha a biblioteca. Um grafo de partes unidas por fios significativos, revelado passo a passo: EdgeDiagram (templates/diagram.html). Uma grade de caixas, uma pilha em camadas ou uma visão de plataforma da esquerda para a direita, onde a disposição carrega o significado: EdgeSketch (templates/sketch.html). Uma apresentação: templates/deck.html, com qualquer biblioteca em seus slides.
  3. Copie o modelo para o diretório de trabalho, por exemplo cp <skill>/templates/sketch.html ./minha-figura.html. Corrija os caminhos <script src> e do tema para que apontem para <skill>/lib/ e <skill>/themes/, ou execute inline.py com --lib e --themes no final.
  4. Organize em uma grade. Escolha o viewBox, depois as zonas, depois as caixas (tamanhos iguais, espaçamentos uniformes), depois os fios (veja Conectores abaixo). Coloque caixas que se comunicam entre si na mesma linha ou coluna, para que seu fio seja um único percurso reto. Dê aos links que carregam significado um info. Leia references/api.md para as opções.
  5. Escreva as etapas (EdgeDiagram). A etapa 0 é o estado de repouso. Cada etapa posterior adiciona uma ideia e tem uma legenda curta. Use flows para os dados que se movem e dim ou hide para o que a etapa deixa para trás.
  6. Tema. As páginas vinculam um tema, <link rel="stylesheet" href="../themes/engineering.css">; troque o nome para alterá-lo. engineering para material técnico denso, indigo para entrega de produtos e software, drafting para propostas e estudos lidos como documentos. Mantenha o significado de cada tom (references/conventions.md). Para a aparência de uma marca, crie um tema a partir de seu DESIGN.md: python3 <skill>/scripts/theme_from_design.py DESIGN.md -o themes/<nome>.css (examples/design-md/DESIGN.md é um exemplo). Manualmente, copie um tema, mantenha cada nome de token, altere os valores e execute scripts/check_theme.py themes/<nome>.css até que passe.
  7. Construa, verifique e visualize:
    python3 <skill>/scripts/inline.py minha-figura.html > build/minha-figura.html
    <skill>/scripts/shot.sh --check build/minha-figura.html          # toda figura; saída 1 em qualquer problema
    <skill>/scripts/shot.sh --only '#minha-fig' build/minha-figura.html /tmp/f-claro.png light 1280
    <skill>/scripts/shot.sh --only '#minha-fig' build/minha-figura.html /tmp/f-escuro.png dark 1280
    <skill>/scripts/shot.sh build/minha-figura.html /tmp/sN.png dark 1280 'for(var i=0;i<5;i++)document.getElementById("next").click()'
    
    Corrija tudo que --check relatar. Em seguida, abra os PNGs e corrija o que ele não pode ver, como caixas fora da grade, cabeças de seta que colidem ou rótulos congestionados, e olhe novamente na largura 420. Screenshots congelam pacotes perto do início de seus fios, portanto, julgue o movimento em um navegador real.
  8. Entregue uma cópia editável quando solicitado. <skill>/scripts/todrawio.sh build/minha-figura.html <svg id ou seletor> out.drawio "Nome" escreve um arquivo draw.io de uma figura, no tema claro e em sua última etapa. Diga o que ele não carrega: movimento, etapas, dicas de ferramentas e formas preenchidas que não sejam retângulos e elipses (ele imprime quantas deixou de fora).
  9. Publique. O arquivo com os recursos embutidos é a página: compartilhe-o como um arquivo, faça commit ou, no Claude, entregue-o à ferramenta Artifact (republique o mesmo caminho ou URL para atualizá-lo).

Conectores

Os fios são o que um leitor segue, portanto, devem parecer deliberados:

  • Apenas horizontal e vertical. Nunca uma diagonal e nunca uma curva. Os links do EdgeDiagram são ortho por padrão: deixe route de fora. 'straight' é apenas para duas extremidades já alinhadas, e 'curve' apenas quando o usuário solicitar uma. No EdgeSketch, use s.arrow, s.connect e s.fan, que fazem curvas em ângulos retos. Em SVG escrito à mão, desenhe fios com comandos de caminho H e V e arredonde apenas os cantos.
  • Um único percurso reto quando as caixas estão de frente uma para a outra. Deixe de fora a posição (t) e o EdgeDiagram, ou s.connect, coloca ambas as extremidades em linha quando as duas caixas compartilham um intervalo. Se a verificação relatar um desvio de alguns pixels, mova uma caixa para que as extremidades se alinhem; não ajuste t.
  • Uma fonte alimentando várias caixas é um fan-out, não um monte de fios separados. d.fan(id, {from: [src, 'bottom'], to: ['a', 'b', 'c']}), ou s.fan(src, 'bottom', [a, b, c]), desenha um tronco, um barramento em ângulo reto e um ramo em cada caixa, com um ponto em cada junção. Várias caixas alimentando uma é o mesmo fan-out com as listas trocadas ({from: [[...], ...], to: [...]} ou {into: true}).
  • Poucas curvas, nenhum cruzamento. Escolha os lados para que cada fio gire no máximo duas vezes. Espalhe os fios que compartilham um lado ('auto'). Roteie ao redor das caixas, nunca através delas.
  • shot.sh --check relata fios inclinados, curvos e com desvios. Corrija-os como qualquer outro problema. Marque uma exceção deliberada, como uma figura isométrica, com data-route="free".

Regras

  • Não use outras bibliotecas. GSAP 3 do cdnjs é opcional: sem ele, cada etapa mostra seu estado final.
  • Toda cor vem de um token, para que os componentes nunca contenham cores literais.
  • Cada nó, caixa ou link que possui info é focalizável por teclado. O SVG tem role="img" e um aria-label que declara o que a figura afirma.
  • Uma figura mais larga que um telefone rola dentro de seu próprio contêiner overflow-x: auto, nunca na página.
  • Mantenha nomes internos, nomes de clientes e endereços fora das páginas que serão compartilhadas.

Habilidades Relacionadas