Repolode
Agents365-ai

Agents365-ai/drawio-skill

Uma skill de agente que transforma linguagem natural e fontes reais do sistema, como Terraform, Kubernetes, SQL e OpenAPI, em diagramas de arquitetura editáveis no draw.io.

Alternativa open source a:Lucidchart

Estrelas
10,234
Forks
870
Issues abertas
0
Último commit
há 9 dias

O que é?

drawio-skill é um pacote no formato Agent Skills que gera modelos de arquitetura .drawio fáceis de manter a partir de prompts em linguagem natural, código, configurações de infraestrutura e esquemas. Ele abrange Terraform, Kubernetes e docker-compose com ícones oficiais de provedores de nuvem; converte SQL DDL em diagramas ER; transforma OpenAPI, AsyncAPI, Protobuf e GraphQL em diagramas; e converte pipelines de CI em DAGs. Também importa snapshots de infraestrutura ativa a partir da saída de terraform, docker e kubectl.

Além da geração pontual, o projeto se concentra em manter os diagramas sincronizados com os sistemas. A sincronização incremental atualiza os nós alterados sem perder o layout ajustado manualmente; os diffs de divergência comparam dois diagramas ou snapshots; e regras de arquitetura em YAML/JSON podem ser executadas como testes no CI. Os diagramas podem ser exportados para HTML interativo, PowerPoint, SVG animado, Mermaid ou Markdown. Os fluxos de trabalho principais usam apenas a biblioteca padrão, e a principal dependência é a CLI do draw.io para desktop.

Recursos principais

  • 01Gera arquivos .drawio editáveis a partir de linguagem natural e verifica automaticamente o resultado renderizado
  • 02Importa fontes de Terraform, Kubernetes, docker-compose, SQL, OpenAPI, AsyncAPI, Protobuf e GraphQL
  • 03Sincroniza diagramas de forma incremental, preservando o layout e as anotações manuais
  • 04Executa regras de arquitetura como testes de CI e gera diffs de divergência entre diagramas
  • 05Exporta para HTML interativo, PowerPoint, SVG animado, Mermaid e Markdown
  • 06Pesquisa entre mais de 10.000 formas oficiais do draw.io e 321 logotipos de marcas de IA/LLM

Casos de uso

  • Documentar infraestrutura em nuvem a partir de arquivos Terraform ou manifests do Kubernetes, usando ícones oficiais dos provedores
  • Impor regras de arquitetura, como bloquear o acesso direto da internet ao banco de dados, em pull requests
  • Acompanhar como um sistema implantado diverge da arquitetura documentada
  • Criar apresentações para stakeholders ou tours interativos pela arquitetura a partir do código existente

Início rápido

  1. 1

    Instalar a CLI para desktop do draw.io (macOS)

    brew install --cask drawio
  2. 2

    Instalar a skill em qualquer agente

    npx skills add Agents365-ai/drawio-skill -g
  3. 3

    Verificar a instalação da CLI

    drawio --version

Antes de usar

  • O toolkit completo precisa da CLI para desktop do draw.io, e a versão 30 ou posterior é recomendada para conversão de Mermaid e layout ELK.
  • A configuração da CLI no Windows e no Linux é mais complexa, e o WSL2 usa o executável desktop do Windows.

Tópicos

Perguntas frequentes

O que é drawio-skill?
Uma skill de agente que transforma linguagem natural e fontes reais do sistema, como Terraform, Kubernetes, SQL e OpenAPI, em diagramas de arquitetura editáveis no draw.io. drawio-skill é um pacote no formato Agent Skills que gera modelos de arquitetura .drawio fáceis de manter a partir de prompts em linguagem natural, código, configurações de infraestrutura e esquemas. Ele abrange Terraform, Kubernetes e docker-compose com ícones oficiais de provedores de nuvem; converte SQL DDL em diagramas ER; transforma OpenAPI, AsyncAPI, Protobuf e GraphQL em diagramas; e converte pipelines de CI em DAGs. Também importa snapshots de infraestrutura ativa a partir da saída de terraform, docker e kubectl.
drawio-skill é gratuito? Qual é a licença?
drawio-skill é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
drawio-skill ainda é mantido?
Manutenção ativa. O último commit de drawio-skill foi em 11 de out. de 2026.
Para que posso usar drawio-skill?
Documentar infraestrutura em nuvem a partir de arquivos Terraform ou manifests do Kubernetes, usando ícones oficiais dos provedores Impor regras de arquitetura, como bloquear o acesso direto da internet ao banco de dados, em pull requests Acompanhar como um sistema implantado diverge da arquitetura documentada Criar apresentações para stakeholders ou tours interativos pela arquitetura a partir do código existente
Como instalar drawio-skill?
Instalar a CLI para desktop do draw.io (macOS): brew install --cask drawio Instalar a skill em qualquer agente: npx skills add Agents365-ai/drawio-skill -g Verificar a instalação da CLI: drawio --version
Onde consigo drawio-skill?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/Agents365-ai/drawio-skill

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados