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.
| Caminho | O que é |
|---|---|
lib/edgediagram.js | Grafos 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.js | Figuras 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.js | window.EDGE_ICONS: 50 ícones de linha em uma grade de 24 unidades (equipamentos de grade, computação, confiança, operações) |
lib/edgedeck.js | EdgeDeck.run: um palco de slides 1600×900 com etapas por slide, legendas, teclado, swipe e links #n |
themes/*.css | Temas 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.html | Uma figura EdgeDiagram com etapas, legendas, Anterior/Próximo e pontos |
templates/sketch.html | Uma figura EdgeSketch desenhada à mão: zonas da esquerda para a direita, colunas, serviços, setas de duas cabeças, uma legenda |
templates/deck.html | Um slide de título mais um slide de conteúdo cujo diagrama é construído passo a passo |
scripts/inline.py | Embuti 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.sh | Screenshots 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.sh | Exporta 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.py | Verifica o contraste WCAG de um tema no claro e escuro, e se seus dois blocos escuros concordam |
scripts/theme_from_design.py | Cria 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.sh | Executa os testes em tests/; execute-o após alterar lib/, scripts/ ou themes/ |
scripts/vendor.sh | Copia a biblioteca para outro projeto, e --check mostra se essa cópia está desatualizada |
references/api.md | Todas as opções de ambas as bibliotecas e do mecanismo de apresentação |
references/conventions.md | Tokens, o significado de cada tom, regras de layout, publicação e as verificações a serem executadas |
examples/ci-canary-deck.html | Uma 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.md | Um exemplo de DESIGN.md (Harbor) para criar um tema a partir dele |
Fluxo de trabalho
- 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.
- 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. - 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 executeinline.pycom--libe--themesno final. - 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. Leiareferences/api.mdpara as opções. - Escreva as etapas (EdgeDiagram). A etapa 0 é o estado de repouso. Cada etapa posterior adiciona uma ideia e tem uma legenda curta. Use
flowspara os dados que se movem edimouhidepara o que a etapa deixa para trás. - Tema. As páginas vinculam um tema,
<link rel="stylesheet" href="../themes/engineering.css">; troque o nome para alterá-lo.engineeringpara material técnico denso,indigopara entrega de produtos e software,draftingpara 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 executescripts/check_theme.py themes/<nome>.cssaté que passe. - Construa, verifique e visualize:
Corrija tudo quepython3 <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()'--checkrelatar. 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. - 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). - 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
orthopor padrão: deixeroutede fora.'straight'é apenas para duas extremidades já alinhadas, e'curve'apenas quando o usuário solicitar uma. No EdgeSketch, uses.arrow,s.connectes.fan, que fazem curvas em ângulos retos. Em SVG escrito à mão, desenhe fios com comandos de caminhoHeVe 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, ous.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 ajustet. - 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']}), ous.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 --checkrelata fios inclinados, curvos e com desvios. Corrija-os como qualquer outro problema. Marque uma exceção deliberada, como uma figura isométrica, comdata-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 temrole="img"e umaria-labelque 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.