CommunityRedacción y edicióngithub.com

Spotlight-Revenue/drawio-diagrammer-skill

Genera diagramas draw.io estéticamente hermosos con un bucle de revisión visual obligatorio: tu agente construye diagramas que realmente se ven bien.

¿Qué es drawio-diagrammer-skill?

Esta skill permite a un agente de IA generar y refinar diagramas draw.io de alta calidad, incluyendo diagramas de flujo, ERD, diagramas de arquitectura y UML. El flujo de trabajo impone un estricto bucle de revisión visual: después de exportar un PNG, el agente debe inspeccionarlo visualmente, identificar problemas y corregirlos antes de declarar la tarea completa. Se basa en referencias detalladas para estilos de cajas, tipos de diagrama y protocolos de revisión, garantizando consistencia y legibilidad. Compatible con macOS y Linux, utiliza el CLI de draw.io para exportación a PNG, SVG y PDF.

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

Installed? Explore more Redacción y edición skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Skill de Diagramador draw.io

Cuándo usar esta skill

  • El usuario solicita un diagrama de flujo, mapa de procesos o diagrama de trabajo
  • El usuario solicita un ERD, diagrama de base de datos o modelo de relaciones de entidad
  • El usuario solicita un diagrama de arquitectura, sistema o componentes
  • El usuario solicita un diagrama de clases, secuencia o UML
  • El usuario dice "draw.io", "diagrama", "diagrama de flujo", "visualiza este proceso"
  • El usuario pide actualizar, corregir o extender un archivo .drawio existente

OBLIGATORIO — Leer antes de generar cualquier cosa

  1. Detectar el tipo de diagrama primero — consulta las referencias de tipos de diagrama antes de escribir XML
  2. Aplicar estándares universales de estilo de cajas — consulta references/box-style-standards.md
  3. Todas las posiciones están codificadas — no existe diseño automático en XML de draw.io
  4. Ejecutar el bucle de revisión visual después de cada exportación — consulta references/visual-review-protocol.md
  5. Nunca declarar terminado sin una pasada visual — exporta PNG, léelo, corrígelo, repite

Detección de tipo de diagrama

El usuario dice...Archivo de referencia
"diagrama de flujo", "proceso", "pasos", "flujo de trabajo", "SOP"references/diagram-types/flowchart.md
"ERD", "base de datos", "tablas", "entidades", "clave foránea"references/diagram-types/erd.md
"arquitectura", "sistema", "componentes", "servicios"references/diagram-types/layout.md
"clase", "UML", "herencia", "métodos", "atributos"references/diagram-types/class.md
"secuencia", "interacción", "línea de vida", "llamadas de actor"references/diagram-types/sequence.md

Flujo de trabajo de generación estándar

Paso 1 — Cargar referencia de tipo

Lee el archivo correcto references/diagram-types/ antes de escribir cualquier XML.

Paso 2 — Planificar todos los elementos

Enumera cada nodo, conexión y sección antes de codificar. No improvises el diseño a medio construir.

Paso 3 — Aplicar estilo de caja universal

Cada nodo debe incluir los atributos universales de espaciado de references/box-style-standards.md.

Paso 4 — Crear carpeta de salida y escribir XML

mkdir -p ./diagrams

Guardar en:

./diagrams/<nombre-del-diagrama>.drawio

Lista de verificación previa al guardado:

  • Todos los elementos mxCell tienen IDs numéricos secuenciales únicos
  • Espaciado de caja universal aplicado a cada estilo de nodo: spacingLeft=12;spacingRight=12;spacingTop=10;spacingBottom=10;verticalAlign=top;
  • Las flechas usan enrutamiento encadenado, no abanico desde una sola fuente a muchos destinos
  • Mínimo 15–20px de espacio entre dos cajas (verificar parte inferior de lista de subelementos vs parte superior de sección siguiente)
  • Alturas calculadas con la fórmula en box-style-standards.md (×16px por línea en fontSize=10)
  • Paneles de texto ancho (notas, descripciones) tienen 530px+ de ancho — no 460px o menos
  • Sin \n literal en atributos value — usar &#xa; para saltos de línea
  • verticalAlign=top en todas las cajas de contenido multilínea

Paso 5 — Exportar PNG y ejecutar bucle de revisión visual

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

Luego seguir el protocolo completo en references/visual-review-protocol.md.

Paso 6 — Entregar

Envía primero el PNG al usuario. Para diagramas grandes, envía capturas de pantalla de secciones (superior, media, inferior) antes de la imagen completa.

Luego pregunta qué formatos adicionales desea:

El diagrama está listo. ¿Qué formato te gustaría?

1 — Imagen PNG (lista para ver)
2 — Archivo .drawio (editable en draw.io)
3 — SVG (vector escalable)
4 — PDF
5 — Todos los anteriores

Responde con el(los) número(s) de tu elección.

Para entrega en Drive o rutas de salida personalizadas, seguir references/workflow-sop.md.


Referencia de CLI

# macOS — Exportar PNG (estándar)
/Applications/draw.io.app/Contents/MacOS/draw.io --export --format png --output <salida.png> --scale 2 --border 30 <archivo.drawio>

# macOS — Exportar PNG de alta resolución
/Applications/draw.io.app/Contents/MacOS/draw.io --export --format png --output <salida.png> --scale 3 --border 30 <archivo.drawio>

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

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

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

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

Skills relacionados