Drawio Visuals Skill

¿Qué hace Drawio Visuals Skill?

Crea, reconstruye y edita archivos nativos de Draw.io editables por el usuario, sin servidor, MCP, plantilla fija, Scene IR ni renderizador personalizado.

Por defecto, objetos, no módulos de texto

Para un nuevo flujo explicativo —un proceso, pipeline, carril (swimlane), ciclo de vida de solicitud o flujo de arquitectura— utiliza objetos editables reconocibles y cambios visibles por defecto. Una solicitud simple como "dibuja el flujo de trabajo" activa esta regla; el usuario no necesita pedir gráficos "pictóricos", "concretos" o "ilustrados". Elige el tipo de diagrama por separado de este tratamiento visual.

Antes de colocar nodos, identifica qué se mueve, qué cambia y quién actúa. Luego elige una silueta, contenidos significativos o una pequeña escena de objeto para cada objeto de negocio principal y etapa de procesamiento: una cola tiene tarjetas de tarea separadas y entrada/salida; un analizador (parser) muestra un documento convirtiéndose en partes extraídas; un reembolso distingue fondos pendientes de fondos devueltos. Dibuja primero estas partes nativas, luego añade nombres/acciones cortos. Una serie de rectángulos con nombres de paso no cumple este valor predeterminado, incluso si las etiquetas son breves y el diseño limpio. Estantes de servidores repetidos, emojis o un ícono no relacionado en una tarjeta de prosa no son sustitutos del significado visible. Lee visual-storytelling.md antes de crear estos flujos.

Comienza con los gráficos incluidos: consulta el índice de componentes, lee el XML .drawio correspondiente en assets/components/ y decide si reutilizar sus descendientes nativos, adaptar/combinar sus partes o usar su construcción como referencia para generar un nuevo objeto nativo. Combina objetos de navegador, documento, mensaje, cola, trabajador, almacenamiento, fragmentos, tabla, vectores, revisión, decisión y notificación según lo requiera la tarea. Por ejemplo, compón navegador + documento → almacenamiento, luego un mensaje separado → cola → trabajador; no te limites a escribir esos nombres dentro de rectángulos. Los 12 iniciadores son una biblioteca semilla extensible, no una plantilla completa ni un límite de capacidad; al generar un objeto adicional, toma prestadas ideas de construcción relevantes como silueta, contenidos significativos, marcas de estado, anidamiento y puertos de conexión, luego adáptalas al dominio. No impongas la paleta de muestra del iniciador ni fuerces una copia exacta.

Lenguaje de componentes incorporado: al añadir, generar o mantener activos reutilizables en assets/components/, mantén cada título, nombre de campo, valor de texto ilustrativo, estado, nombre de página y sugerencia (tooltip) en inglés. Los números, fórmulas y símbolos pueden permanecer como están. Esta es una regla de autoría de biblioteca: los diagramas generados para los usuarios aún siguen el idioma solicitado/fuente, adaptando el texto inicial según corresponda.

Las excepciones siguen la tarea, no la conveniencia: preserva la reconstrucción fiel, el alcance de una edición local, una solicitud explícita de solo texto/caja mínima y la notación formal requerida. Los compartimentos de clase/ER, las líneas de vida de secuencia, los símbolos de decisión/fusión/bifurcación y los límites de estado tienen semántica real; consérvalos. Una solicitud genérica de un "diagrama de flujo", un diagrama "simple", la falta de iniciadores o la disponibilidad de Mermaid no es una excepción. Explica los estados con cambios de objeto visibles cuando sea compatible; no reemplaces relaciones formales con imágenes. Estos valores predeterminados se aplican a cada página y sobreviven a cambios de orientación/tipo.

Reglas principales

• Trata el archivo .drawio actual como la fuente de verdad interna editable. Por defecto, entrega solo imágenes PNG por página y una vista previa HTML; mantén los archivos nativos en un directorio de trabajo interno, fuera del directorio de entrega, y no los enlaces en la entrega. Entrega archivos nativos, SVG, PDF u otros formatos solo cuando se solicite explícitamente.
• Nunca sobrescribas una entrada. Cada escritura mecánica debe usar una nueva ruta de salida, incluidos los archivos de trabajo internos.
• No impongas un tema, lista de formas, tipo de diagrama, cuadrícula de coordenadas o receta de diseño.
• Sigue el tipo de diagrama, notación y orientación especificados por el usuario. Cuando no estén especificados, elige la presentación que mejor responda a la pregunta real de la tarea, incluyendo formas UML y no UML; no predetermines cada solicitud a un diagrama de flujo o carril. Usa diagram-selection.md al elegir o cambiar sustancialmente la presentación.
• Aplica el valor predeterminado de objetos primero a los nuevos flujos explicativos; los símbolos de control estándar y los iniciadores de componentes reutilizables lo soportan sin imponer un catálogo de iconos fijo.
• Para diagramas de flujo verticales, ejecuta la ruta principal de arriba a abajo, coloca ramas paralelas una al lado de la otra, etiqueta las salidas de los diamantes de decisión y agrupa las comprobaciones de soporte en un cuadro punteado gris claro con un propósito en lenguaje sencillo.
• Cuando un motor central coordina módulos externos, coloca el núcleo en el centro, agrupa entradas y trabajadores a cada lado, y usa flechas numeradas con etiquetas de acción para guiar al lector a través de una tarea. Cuando sea relevante, enruta la retroalimentación por encima del núcleo, coloca las decisiones humanas y los canales de notificación debajo, y muestra un flujo de trabajo de ejemplo en la parte inferior. Elige colores que se adapten al tema.
• Mantén formas, esténciles, estilos, geometría, puntos de paso, capas, grupos y metadatos de envoltura nativos arbitrarios de Draw.io.
• Prefiere un lienzo o contenedor más grande sobre nodos, etiquetas o corredores de enrutamiento comprimidos. Un archivo sin colisiones no es necesariamente espacioso, legible o bien compuesto.
• Presupuesta el espacio de las etiquetas de los conectores antes de colocar nodos adyacentes. Las etiquetas largas deben caber entre las formas conectadas con espacio libre visible, o usar saltos de línea explícitos/otra posición de etiqueta clara. Resuelve los riesgos de etiquetas de punto final y verifica los límites de texto renderizado real antes de marcar un diagrama como listo; consulta separación de etiquetas de conector.
• Para contenido recién creado o rediseñado sustancialmente, establece flowAnimation=1 nativo en los bordes de flujo semántico dirigido por defecto, incluidos flujos normales, secundarios, de datos, de excepción y de reintento. Mantén estáticas las referencias, anotaciones, contención, agrupación y relaciones puramente estructurales. Deja que la intención explícita del usuario anule esta política.
• Preserva estilos de animación no relacionados durante una edición local, a menos que se solicite normalización de animación. Si el movimiento oscurece la jerarquía, haz que los flujos semánticos de menor prioridad sean estáticos durante el control de calidad renderizado en lugar de cambiar su topología.
• Trata la animación del conector como un efecto visual, nunca como enrutamiento o evitación de colisiones.
• Usa la CLI incluida solo para inspeccionar, consultar, parchear, validar, verificar diseño/topología, orquestar exportación de Escritorio/Web, HTML complementario, CRUD de páginas, listado de versiones, publicar y restaurar. No crea, diseña ni implementa un renderizador; render delega en Draw.io Desktop, web-svg-bridge delega una página seleccionada en Draw.io Web oficial, y la vista previa HTML delega en el visor remoto oficial.
• Trata <base>-vNNN como una versión de entrega lógica compartida por sus imágenes y HTML, no cada escritura interna. El versionado nativo permanece interno a menos que se solicite la entrega de la fuente. Por defecto, un cambio aprobado por el usuario consume como máximo una nueva versión hermana.
• Mantén cada --page-index público de la CLI basado en cero, coincidiendo con el index devuelto por inspect. Prefiere IDs de página estables para trabajo multipágina.
• Limita cada documento a 15 páginas. La CLI rechaza documentos existentes más grandes y adiciones más allá de este límite con PAGE_COUNT_LIMIT; nunca trunques páginas para satisfacerlo.
• No habilites esta Skill junto con la Skill oficial drawio@drawio; esta Skill ya tiene la misma ruta de creación nativa Mermaid/XML.

Elige la presentación

Separa el tipo de diagrama de la herramienta de creación. Elige según lo que el lector necesita entender: progresión, responsabilidades, interacciones, estados, estructura, despliegue, movimiento de datos o comparación. Un diagrama proporcionado, formato explícito o edición local solicitada limita esa elección. Cuando el usuario la deja abierta, toma la decisión de forma autónoma, explícala brevemente cuando sea útil y procede; no hagas que el usuario seleccione de un catálogo. Lee diagram-selection.md para la guía de pregunta a forma y las compensaciones.

Aplica el tratamiento visual predeterminado o la excepción explícita de la tarea en todas las páginas y revisiones. No agregues una página complementaria de texto plano como sustituto de una explicación basada en objetos.

Luego elige objetos y notación apropiados para esa presentación. Las ilustraciones concretas pueden explicar cargas útiles y transformaciones, mientras que los símbolos formales UML, ER y otros establecidos deben conservar sus convenciones semánticas. No trates cada cuadro de clase, estado o esquema etiquetado como un defecto de flujo con mucho texto.

Elige el flujo de trabajo

Solicitud	Flujo de trabajo
Explicar un proceso, pipeline, carril, ciclo de vida o flujo de arquitectura	Evidencia/propiedad → narración visual → construcciones de objetos/estados → XML nativo directo → control de calidad del renderizador oficial
Crear un diagrama estructural formal o un diagrama explícitamente de caja mínima	Preservar notación/contenido → Mermaid si conserva la representación prevista y Desktop está disponible; de lo contrario, XML nativo
Crear con formas/estilos/posiciones personalizados	XML nativo directo → .drawio
Crear desde PDF o texto	Leer fuente → extraer estructura compatible → elegir representación usando los mismos valores predeterminados → XML nativo o Mermaid adecuado
Reconstruir desde una imagen	Inspeccionar a resolución original → celdas nativas editables → comparación de vista previa opcional
Verificar conflictos visuales	check-layout → render de Escritorio → inspeccionar imagen → pequeño parche → rerenderizar; recurrir a HTML del Visor
Verificar un flujo de negocio	check-topology con inicios, terminales y bordes requeridos conocidos
Ver sin Escritorio	preview → .html complementario con recuento/nombres de página visibles usando el visor remoto oficial
Exportar SVG sin Escritorio	Preferir una sesión de bucle invertido web_svg_session.py; conservar web-svg-bridge → commit-web-svg para recuperación manual
Exportar o aplicar un diseño solicitado	Crear .drawio primero → CLI de Draw.io Desktop
Editar, destino desconocido	inspect → query → patch
Editar, ID de página y celda conocidos	query → patch
Editar, resultado CLI de confianza fresco ya tiene revisión y destino	patch
Agregar, renombrar o eliminar una página	inspect → page add/rename/delete
Listar o restaurar una versión de archivo	versions o versions → inspect old → restore
Publicar un archivo de trabajo completo	inspect working → publish
Ver una o más celdas conocidas	query
Verificar un archivo de forma independiente	validate

Lee references/authoring.md para creación, vista previa, detección de Escritorio, diseño y exportación. Lee references/web-svg-export.md solo cuando Desktop no esté disponible y se deban exportar SVGs solicitados explícitamente a través de Draw.io Web oficial. Lee references/layout-authoring.md al crear un diagrama abarrotado, mantener la consistencia visual entre páginas, interpretar check-layout o realizar control de calidad visual renderizado. Lee references/topology.md cuando una ruta de proceso, ciclo de vida o solicitud deba estar conectada. Lee references/source-to-diagram.md cuando la fuente sea PDF, texto o una imagen. Lee references/drawio-xml.md solo para autoría XML directa. Lee references/patch-contract.md antes de construir un parche. Lee references/versioning.md para comandos de página e historial inmutable.

Planifica una entrega lógica

• Antes de escribir, mapea cada cambio solicitado a su página/celda, salidas de decisión requeridas, restricciones de inicio/terminal/borde críticas, efectos secundarios o rutas de error, terminología y todas las páginas afectadas.
• Para documentos nuevos de varias páginas, define roles visuales locales al documento antes de crear y reutiliza las bases de página, tipografía, estilos de componentes repetidos y estilo de relaciones en todas las páginas. Al agregar o editar contenido, hereda la convención del documento existente dentro del ámbito solicitado. Sigue consistencia visual del documento para la selección de roles, excepciones intencionales y aceptación entre páginas.
• Para una edición atómica que no necesita corrección topológica, de diseño o visual posterior, escribe directamente a una nueva versión nativa interna.
• Para ediciones de varias páginas o cualquier tarea que probablemente necesite corrección de control de calidad, crea un directorio temporal propiedad del Agente y escribe working-01.drawio, working-02.drawio, etc. Completa todas las ediciones y comprobaciones solicitadas allí; publish es opcional para una instantánea final interna o entrega nativa solicitada explícitamente.
• Genera el HTML de entrega y los PNG por página a partir de la misma instantánea nativa final verificada; no se requiere un entregable .drawio publicado. Para HTML orientado al usuario, incrusta una representación verificada de cada página con preview --fallback-png (repite en orden de página). Verifica el HTML entregado con el Visor remoto bloqueado, incluso a lo ancho estrecho. Una representación en línea exitosa por sí sola no verifica la vista previa del destinatario. Si no hay un renderizador oficial disponible, etiqueta el HTML como solo en línea y revela la limitación. Las vistas previas temporales son artefactos de control de calidad, no entregables.
• Después de verificar imágenes y HTML autocontenidos, elimina solo los archivos de control de calidad desechables creados por esta tarea; conserva la instantánea nativa final internamente para ediciones posteriores. Nunca limpies versiones formales existentes sin autorización explícita del usuario.

Crear

1. Lee references/authoring.md y elige la representación antes de elegir una sintaxis. Para un nuevo flujo explicativo, usa el valor predeterminado de objetos primero y XML nativo directo; la disponibilidad de Desktop cambia la exportación, no el requisito visual. Usa Mermaid solo cuando conserve la semántica/representación elegida, como un diagrama estructural formal o explícitamente de caja mínima. Detecta Desktop para conversión/exportación.
2. Elige una base descriptiva en minúsculas con guiones, reserva <base>-v001 para la entrega inicial de imagen/HTML y mantén su instantánea .drawio interna.