Repolode
Enviar
Agents365-ai

Agents365-ai/drawio-skill

Una skill para agentes que convierte lenguaje natural y fuentes reales del sistema, como Terraform, Kubernetes, SQL y OpenAPI, en diagramas de arquitectura editables en draw.io.

Alternativa open source a:Lucidchart

Ver en GitHubSitio web
Estrellas
10,234
Forks
870
Issues abiertos
0
Último commit
hace 9 días

¿Qué es?

drawio-skill es un paquete con formato Agent Skills que genera modelos de arquitectura .drawio fáciles de mantener a partir de instrucciones en lenguaje natural, código, configuraciones de infraestructura y esquemas. Es compatible con Terraform, Kubernetes y docker-compose, e incluye íconos oficiales de proveedores de nube; convierte SQL DDL en diagramas ER, y OpenAPI, AsyncAPI, Protobuf y GraphQL en diagramas; además, convierte pipelines de CI en DAGs. También importa instantáneas de infraestructura activa a partir de la salida de terraform, docker y kubectl.

Además de generar diagramas puntuales, el proyecto se centra en mantenerlos sincronizados con los sistemas. La sincronización incremental actualiza los nodos modificados y conserva la distribución ajustada manualmente; las comparaciones de desviaciones contrastan dos diagramas o instantáneas, y las reglas de arquitectura en YAML/JSON se pueden ejecutar como pruebas en CI. Los diagramas se pueden exportar a HTML interactivo, PowerPoint, SVG animado, Mermaid o Markdown. Los flujos de trabajo principales solo usan la biblioteca estándar; la dependencia principal es la CLI de escritorio de draw.io.

Funciones clave

  • 01Genera archivos .drawio editables a partir de lenguaje natural y comprueba automáticamente el resultado renderizado
  • 02Importa fuentes de Terraform, Kubernetes, docker-compose, SQL, OpenAPI, AsyncAPI, Protobuf y GraphQL
  • 03Sincroniza diagramas de forma incremental y conserva la distribución y las anotaciones manuales
  • 04Ejecuta reglas de arquitectura como pruebas de CI y compara desviaciones entre diagramas
  • 05Exporta a HTML interactivo, PowerPoint, SVG animado, Mermaid y Markdown
  • 06Permite buscar entre más de 10.000 formas oficiales de draw.io y 321 logotipos de marcas de IA/LLM

Casos de uso

  • Documentar infraestructura de nube a partir de Terraform o manifiestos de Kubernetes con íconos oficiales de proveedores
  • Hacer cumplir reglas de arquitectura, como bloquear el acceso directo desde Internet a las bases de datos en las pull requests
  • Seguir las desviaciones entre un sistema desplegado y su arquitectura documentada
  • Crear presentaciones para las partes interesadas o recorridos interactivos por la arquitectura a partir del código existente

Inicio rápido

  1. 1

    Instalar la CLI de escritorio de draw.io (macOS)

    brew install --cask drawio
  2. 2

    Instalar la skill en cualquier agente

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

    Verificar la instalación de la CLI

    drawio --version

Antes de usarlo

  • El toolkit completo requiere la CLI de escritorio de draw.io. Se recomienda la versión 30 o posterior para la conversión de Mermaid y la disposición ELK.
  • La configuración de la CLI en Windows y Linux es más compleja, y WSL2 utiliza el ejecutable de escritorio de Windows.

Temas

#architecture-diagram#drawio#diagrams-as-code#agent-skills#terraform#kubernetes#c4-model#architecture#asyncapi#bpmn

Preguntas frecuentes

¿Qué es drawio-skill?
Una skill para agentes que convierte lenguaje natural y fuentes reales del sistema, como Terraform, Kubernetes, SQL y OpenAPI, en diagramas de arquitectura editables en draw.io. drawio-skill es un paquete con formato Agent Skills que genera modelos de arquitectura .drawio fáciles de mantener a partir de instrucciones en lenguaje natural, código, configuraciones de infraestructura y esquemas. Es compatible con Terraform, Kubernetes y docker-compose, e incluye íconos oficiales de proveedores de nube; convierte SQL DDL en diagramas ER, y OpenAPI, AsyncAPI, Protobuf y GraphQL en diagramas; además, convierte pipelines de CI en DAGs. También importa instantáneas de infraestructura activa a partir de la salida de terraform, docker y kubectl.
¿drawio-skill es gratuito? ¿Qué licencia tiene?
drawio-skill es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿drawio-skill sigue mantenido?
Mantenimiento activo. El último commit de drawio-skill fue el 11 oct 2026.
¿Para qué puedo usar drawio-skill?
Documentar infraestructura de nube a partir de Terraform o manifiestos de Kubernetes con íconos oficiales de proveedores Hacer cumplir reglas de arquitectura, como bloquear el acceso directo desde Internet a las bases de datos en las pull requests Seguir las desviaciones entre un sistema desplegado y su arquitectura documentada Crear presentaciones para las partes interesadas o recorridos interactivos por la arquitectura a partir del código existente
¿Cómo se instala drawio-skill?
Instalar la CLI de escritorio de draw.io (macOS): brew install --cask drawio Instalar la skill en cualquier agente: npx skills add Agents365-ai/drawio-skill -g Verificar la instalación de la CLI: drawio --version
¿Dónde consigo drawio-skill?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/Agents365-ai/drawio-skill

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados