xonika9/agent-skills

Diagramas

Diseñe, cree, revise y convierta diagramas manteniendo el argumento visual y la fuente nativa independientemente correctos.

El contrato de incorporación legible por máquina enumera los requisitos externos previos.

Resolver dos decisiones

Primero elija la vista que exprese la relación: diagrama de flujo, secuencia, estado, arquitectura, modelo de datos, jerarquía, línea de tiempo, comparación u otra vista compatible. Luego elija el formato de entrega. No permita que un formato de archivo familiar determine el tipo de diagrama.

Un formato explícito gana cuando puede expresar la estructura requerida. Si crea una limitación material, explique la limitación y ofrezca una alternativa sin cambiar silenciosamente el entregable.

Use esta matriz cuando el formato esté abierto:

Restricción	Excalidraw	Mermaid	draw.io
Control manual de coordenadas	Fuerte	Débil; el diseño es automático	Fuerte
Edición visual colaborativa	Fuerte en Excalidraw	Depende del anfitrión	Fuerte en diagrams.net
Diff de texto y revisión de código	Débil	Fuerte	Moderada con XML sin comprimir
Diseño automático	Manual primero	Fuerte	Disponible, pero la geometría manual sigue siendo explícita
Composición espacial libre	Fuerte	Limitada	Fuerte
Páginas, capas, contenedores, bibliotecas de formas	Limitada	Limitada y dependiente del renderizador	Fuerte
Renderizado directo en Markdown/chat	Raro	Fuerte cuando es compatible	Raro
Capacidad de edición nativa después de la transferencia	.excalidraw	Fuente Mermaid en un editor compatible	.drawio XML
Validación y renderizado confiables	Necesita verificador más renderizador fiel	Necesita analizador de destino más renderizador	Necesita verificaciones XML más editor/exportador compatible

Prefiera el formato cuyo editor nativo, validador y renderizador estén disponibles en el entorno de entrega. Si ninguno puede proporcionar una prueba visual, produzca la fuente nativa solicitada solo cuando aún sea útil y etiquete el resultado como DEGRADED.

Sea dueño del argumento visual

Establezca una pregunta, audiencia, ventana gráfica de entrega, punto de entrada y dirección de lectura dominante. Preserve hechos e identificadores exactos mientras acorta las etiquetas explicativas. Modele nodos semánticos, límites y relaciones antes que la sintaxis o las coordenadas.

Lea el método de diseño compartido antes de crear o revisar materialmente un diagrama. Es dueño de la topología, jerarquía, densidad, agrupación, límites, enrutamiento, uso semántico de forma/color/línea, criterios de división y aceptación visual.

Use un adaptador de formato

• Para .excalidraw JSON nativo, lea el adaptador de Excalidraw. Ejecute su verificador incluido e inspeccione un renderizado fiel.
• Para fuente Mermaid o un bloque Mermaid en el chat, lea el adaptador de Mermaid. Analice y renderice con el destino real o una herramienta compatible existente.
• Para .drawio XML nativo, lea el adaptador de draw.io. Valide la estructura XML, ábralo o expórtelo con una herramienta diagrams.net compatible e inspeccione el resultado.

Los adaptadores de formato son dueños de la serialización, escape, identificadores, enlaces, geometría, temas, páginas, capas y limitaciones específicas del renderizador. No copie su mecánica volátil en este núcleo.

Preserve la fuente nativa

Para un nuevo entregable de ruta nombrada, la ruta solicitada se vuelve canónica cuando se escribe por primera vez. Para una revisión, la fuente existente permanece canónica mientras los cambios residen en un candidato. Los editores y renderizadores consumen esos artefactos; una exportación a otro lugar nunca reemplaza la fuente canónica implícitamente.

Un candidato de revisión reemplaza la fuente existente solo cuando cumple con la puerta de finalización. De lo contrario, informe DEGRADED, deje la fuente existente sin cambios e identifique al candidato como inacabado.

Convertir y revisar

A través de las conversiones, preserve la identidad semántica: significado del nodo, dirección de la relación, secuencia, contención, límites, cardinalidad y tokens técnicos exactos. Preserve páginas, capas e identidad del contenedor cuando tanto la fuente como el destino los admitan. Indique pérdidas como cambios de diseño automático, bibliotecas de formas no compatibles o estilo aplanado; nunca prometa paridad de píxeles.

Para trabajos de solo revisión, inspeccione e informe sin reescribir. Verifique la estructura nativa por separado de la composición renderizada: un análisis exitoso no prueba la legibilidad, y una imagen plausible no prueba la editabilidad.

Límite de activación

Este skill es dueño de las llamadas explícitas x9-diagrams, la selección de formato, la conversión entre formatos, el método visual compartido y la verificación combinada estructural y visual. Una solicitud limitada a la sintaxis común de Mermaid puede permanecer con un skill especializado mermaid-diagrams instalado. Este skill permanece autocontenido para usuarios que no tienen ese skill de terceros.

Cuando la propiedad de la activación sea ambigua, use x9-diagrams solo si la tarea necesita su contrato de decisión o verificación más amplio. No invoque ambos skills simplemente porque Mermaid aparezca en la solicitud.

Puerta de finalización

Haga coincidir la evidencia de finalización con la acción solicitada:

• Selección de formato: nombre la vista y el formato de entrega, conecte la elección con las restricciones del usuario, indique limitaciones materiales e identifique si hay disponible un validador, renderizador o editor compatible.
• Creación o revisión material: la vista elegida responde a la pregunta planteada; la fuente nativa se analiza o abre y permanece editable; el agente no activó un selector de archivos o directorios nativo que no pudiera completar por sí mismo; el diseño posterior a la carga específico del formato es estable cuando corresponda; un renderizador o editor compatible produjo la vista real a partir de la fuente canónica final después de su última mutación material; y esa vista fue inspeccionada en su modo de entrega declarado en cuanto a legibilidad, jerarquía, cruces, recortes y estructura engañosa.
• Conversión: cumpla con la evidencia de creación y confirme que la semántica importante sobrevivió; indique cualquier pérdida en diseño, estilo, páginas, capas, contenedores o notación.
• Solo revisión: distinga los hallazgos de estructura nativa de los hallazgos de composición renderizada y cite la evidencia inspeccionada sin reescribir el artefacto.

Si no se puede obtener alguna evidencia requerida para la acción activa, informe DEGRADED con la verificación, validador, renderizador, editor o artefacto fuente faltante exacto. Las pruebas de regresión del verificador de Excalidraw residen en scripts/test_check_scene.py.