diagram-design: por qué tus diagramas parecen plantilla

Hay un tipo de diagrama que todos reconocemos sin leerlo: cajas con esquinas redondeadas, flechas en todas direcciones, varios colores pastel y una sombra suave debajo de cada cosa. No está mal hecho. Simplemente parece que no lo hizo nadie. Ese diagrama es el que Cathryn Lavery recibía cada vez que le pedía uno a Claude. En lugar de resignarse, escribió una skill para Claude Code que hoy pasa de 38.000 estrellas en GitHub. Se llama diagram-design, tiene licencia MIT y no es de Anthropic: es un proyecto suyo. Lo que me interesa no es la skill en sí. Es lo que su existencia dice sobre cómo le pedimos las cosas a la IA.

De dónde sale diagram-design

La autora lo cuenta en el README del repositorio, sin rodeos. Cada vez que necesitaba un diagrama (un esquema de arquitectura, un diagrama de flujo, una pirámide de prioridades) se lo pedía a Claude y recibía, en sus palabras, «a generic rounded-box thing that looked nothing like the rest of the site». Algo genérico de cajas redondeadas que no se parecía en nada al resto de su web. Sus dos salidas eran malas: pelear 30 minutos con Figma o quedarse sin diagrama. De ahí sale la frase que lo explica todo: «So I built a Claude Code skill for it». Y la promesa con la que abre el proyecto: «Editorial diagrams your designer won't hate». Diagramas editoriales que tu diseñador no va a odiar.

Las reglas que dejó escritas

Lo interesante de diagram-design no es que dibuje. Claude ya dibujaba. Lo interesante es que la skill convierte un gusto en reglas explícitas. Algunas, traducidas del repositorio:

• «La jugada de más calidad suele ser borrar.» Cada nodo tiene que ganarse su lugar.
• El color de acento se reserva para las 1 o 2 cosas que el lector debe mirar primero. Usarlo en 5 nodos borra la señal.
• Densidad objetivo: 4 sobre 10. Lo bastante completo para ser técnicamente correcto, no tan denso que necesite una guía.
• Si pasa de 9 nodos, probablemente son dos diagramas.
• Y la declaración de estilo del proyecto: «Self-contained HTML + SVG. No shadows. No Mermaid slop.»

Ninguna de estas reglas necesita un modelo más potente. Necesita que alguien las escriba.

Por qué un diagrama editorial convence más que uno de plantilla

Un diagrama con cara de plantilla comunica algo antes de que nadie lea una sola etiqueta: que se hizo rápido y sin decidir nada. Si todo tiene el mismo peso visual, quien mira tiene que adivinar qué importa. Y casi nunca se toma ese trabajo. Un diagrama editorial hace lo contrario. Tiene pocas piezas, una sola cosa resaltada y espacio alrededor. Te dice dónde mirar. Eso es justo lo que hace una buena propuesta comercial, una buena diapositiva para inversionistas o una buena documentación: decide por el lector. Por eso el diagrama genérico de PowerPoint resta aunque el contenido sea bueno. No es un problema estético. Es que la forma contradice al fondo: dice «esto no está pensado» justo cuando quieres demostrar que sí lo está.

El pedido es la palanca, no la herramienta

Esta es la lectura que me llevo, y va más allá de los diagramas. Claude no dibujaba genérico por torpe. Dibujaba genérico porque el pedido no traía criterio. «Hazme un diagrama de mi arquitectura» no dice cuántos nodos, qué resaltar, qué sobra ni con qué estilo. Ante un pedido sin criterio, un modelo responde con lo más común. Y lo más común es la caja redondeada. Lo que hizo Cathryn Lavery fue meter el criterio dentro del pedido de forma permanente. La skill carga esas reglas cada vez, así que el resultado ya no depende de acordarse de escribirlas. Es el mismo patrón que se repite en todo lo que funciona con IA: quien escribe su criterio una vez obtiene resultados consistentes; quien lo improvisa cada vez obtiene lo común cada vez.

Lo que conviene saber antes de instalarla

Tres cosas, dichas claro:

• No es oficial. Es un plugin de una desarrolladora independiente, publicado con licencia MIT. Como con cualquier código de terceros, conviene leer el repositorio antes de instalarlo.
• En Claude Code la actualización automática viene apagada para los marketplaces de terceros. Si quieres recibir las mejoras, hay que activarla a mano desde /plugin.
• No decide por ti qué quieres contar. La skill ordena y limpia, pero la regla de borrar solo funciona si tú tienes claro qué es lo esencial.

Si lo que buscas es instalarla y hacer tu primer diagrama, en maquina-ia.com dejé la guía paso a paso. Aquí me quedo con la idea de fondo: la próxima vez que un resultado de la IA te parezca genérico, antes de cambiar de herramienta, revisa qué criterio le diste.