CommunityEscrita e Ediçãogithub.com

Habilidade Diagramadora draw.io

Gere diagramas draw.io esteticamente bonitos com um ciclo de revisão visual obrigatório — seu agente constrói diagramas que realmente ficam corretos.

O que é Habilidade Diagramadora draw.io?

Esta habilidade permite que um agente de IA (como o Claude Code) crie, atualize e corrija diagramas draw.io de alta qualidade, como fluxogramas, ERDs, diagramas de arquitetura e UML. O processo começa com a detecção automática do tipo de diagrama com base na solicitação do usuário, seguida pela aplicação rigorosa de padrões de estilo de caixa universais, incluindo espaçamento, alinhamento vertical e alturas calculadas. Após a geração do XML, o agente exporta o diagrama como PNG e executa um loop de revisão visual obrigatório para garantir que o layout e a estética estejam corretos antes da entrega. A habilidade suporta exportação para PNG, SVG, PDF e o formato .drawio editável, e inclui comandos CLI específicos para macOS e Linux/headless. Ela foi projetada para eliminar diagramas mal renderizados e garantir que o agente produza resultados profissionais de forma consistente.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add Spotlight-Revenue/drawio-diagrammer-skill

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

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

Documentação

O que Habilidade Diagramadora draw.io faz?

Quando usar esta habilidade

  • O usuário solicita um fluxograma, mapa de processo ou diagrama de fluxo de trabalho
  • O usuário solicita um ERD, diagrama de banco de dados ou modelo de relacionamento entre entidades
  • O usuário solicita um diagrama de arquitetura, sistema ou componentes
  • O usuário solicita um diagrama de classe, sequência ou UML
  • O usuário diz "draw.io", "diagrama", "fluxograma", "visualize este processo"
  • O usuário pede para atualizar, corrigir ou estender um arquivo .drawio existente

OBRIGATÓRIO — Leia antes de gerar qualquer coisa

  1. Detecte o tipo de diagrama primeiro — consulte as referências em diagram-types/ antes de escrever XML
  2. Aplique os padrões universais de estilo de caixa — veja references/box-style-standards.md
  3. Todas as posições são codificadas manualmente — não existe auto-layout no XML do draw.io
  4. Execute o loop de revisão visual após cada exportação — veja references/visual-review-protocol.md
  5. Nunca declare concluído sem uma passada visual — exporte PNG, leia, corrija, repita

Detecção de tipo de diagrama

O usuário diz...Arquivo de referência
"fluxograma", "processo", "passos", "fluxo de trabalho", "SOP"references/diagram-types/flowchart.md
"ERD", "banco de dados", "tabelas", "entidades", "chave estrangeira"references/diagram-types/erd.md
"arquitetura", "sistema", "componentes", "serviços"references/diagram-types/layout.md
"classe", "UML", "herança", "métodos", "atributos"references/diagram-types/class.md
"sequência", "interação", "linha de vida", "chamadas de ator"references/diagram-types/sequence.md

Fluxo de trabalho padrão de geração

Passo 1 — Carregar a referência do tipo

Leia o arquivo references/diagram-types/ correto antes de escrever qualquer XML.

Passo 2 — Planejar todos os elementos

Liste cada nó, conexão e seção antes de codificar. Não improvise o layout durante a construção.

Passo 3 — Aplicar estilo de caixa universal

Cada nó deve incluir os atributos universais de espaçamento de references/box-style-standards.md.

Passo 4 — Criar pasta de saída e escrever o XML

mkdir -p ./diagrams

Salve em:

./diagrams/<nome-do-diagrama>.drawio

Lista de verificação pré-salvamento:

  • Todos os elementos mxCell possuem IDs numéricos sequenciais únicos
  • Espaçamento universal de caixa aplicado ao estilo de cada nó: spacingLeft=12;spacingRight=12;spacingTop=10;spacingBottom=10;verticalAlign=top;
  • Setas usam roteamento encadeado, não dispersão de uma única fonte para vários destinos
  • Espaçamento mínimo de 15–20px entre quaisquer duas caixas (verifique o final da lista de subitens vs. o início da próxima seção)
  • Alturas calculadas com a fórmula em box-style-standards.md (×16px por linha em fontSize=10)
  • Painéis de texto largo (notas, descrições) têm 530px+ de largura — não 460px ou menos
  • Sem \n literais em atributos de valor — use &#xa; para quebras de linha
  • verticalAlign=top em todas as caixas de conteúdo com várias linhas

Passo 5 — Exportar PNG e executar o loop de revisão visual

/Applications/draw.io.app/Contents/MacOS/draw.io --export --format png --output ./diagrams/<nome>.png --scale 2 --border 30 ./diagrams/<nome>.drawio

Em seguida, siga o protocolo completo em references/visual-review-protocol.md.

Passo 6 — Entregar

Envie o PNG para o usuário primeiro. Para diagramas maiores, envie capturas de tela das seções (topo, meio, base) antes da imagem completa.

Depois pergunte quais outros formatos eles desejam:

O diagrama está pronto. Qual formato você gostaria?

1 — Imagem PNG (pronta para visualizar)
2 — Arquivo .drawio (editável no draw.io)
3 — SVG (vetor escalável)
4 — PDF
5 — Todos os anteriores

Responda com o(s) número(s) da sua escolha.

Para entrega no Drive ou caminhos de saída personalizados, siga references/workflow-sop.md.


Referência CLI

# macOS — Exportar PNG (padrão)
/Applications/draw.io.app/Contents/MacOS/draw.io --export --format png --output <out.png> --scale 2 --border 30 <arquivo.drawio>

# macOS — Exportar PNG de alta resolução
/Applications/draw.io.app/Contents/MacOS/draw.io --export --format png --output <out.png> --scale 3 --border 30 <arquivo.drawio>

# macOS — Exportar SVG
/Applications/draw.io.app/Contents/MacOS/draw.io --export --format svg --output <out.svg> <arquivo.drawio>

# macOS — Exportar PDF
/Applications/draw.io.app/Contents/MacOS/draw.io --export --format pdf --output <out.pdf> <arquivo.drawio>

# Linux / headless — Exportar PNG
xvfb-run -a drawio --export --format png --output <out.png> --scale 2 --border 30 <arquivo.drawio>

# Linux / headless — Exportar SVG
xvfb-run -a drawio --export --format svg --output <out.svg> <arquivo.drawio>

Habilidades Relacionadas