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
.drawioexistente
OBLIGATORIO — Leer antes de generar cualquier cosa
- Detectar el tipo de diagrama primero — consulta las referencias de tipos de diagrama antes de escribir XML
- Aplicar estándares universales de estilo de cajas — consulta
references/box-style-standards.md - Todas las posiciones están codificadas — no existe diseño automático en XML de draw.io
- Ejecutar el bucle de revisión visual después de cada exportación — consulta
references/visual-review-protocol.md - 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
mxCelltienen 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
\nliteral en atributosvalue— usar
para saltos de línea -
verticalAlign=topen 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>