Escribiendo un README o un documento de traspaso, siempre acabas añadiendo un diagrama estructural junto al texto. Dibujarlo no es la parte difícil. Lo difícil es que empieza a quedarse obsoleto en el momento en que lo terminas: dos módulos se refactorizan, aparece una cola de mensajes, y el diagrama sigue mostrando la forma del mes pasado — así que la siguiente persona que confíe en él aprende el sistema equivocado.

Archify es una skill opcional de Hermes dirigida justo a ese problema. Le das una pequeña spec JSON tipada (o pegas el Mermaid que ya tenías) y produce un diagrama HTML interactivo autocontenido — después de pasarle una validación.

Qué hace en realidad

Piensa en archify como algo que trata un diagrama como un artefacto gobernado por un esquema, no como una imagen:

• cinco tipos de diagrama: architecture, workflow, sequence, dataflow y lifecycle (máquina de estados);
• la salida es HTML autocontenido: temas oscuro y claro, pan y zoom, búsqueda, trazado de relaciones, movimiento de trazas opcional y exportación a PNG / JPEG / WebP / SVG / WebM;
• la entrada puede ser requisitos en lenguaje natural, o Mermaid copiado de otro sitio (flowchart, sequenceDiagram, stateDiagram);
• cuando el diagrama tiene que reflejar código real, puede leer evidencia del repositorio en lugar de trabajar solo con tu descripción.

La diferencia importante es el último paso: cada candidato pasa por un recibo de validate / deliver con nueve comprobaciones. «¿Está bien este diagrama?» pasa a ser algo que puedes comprobar, no algo que miras a ojo.

Cómo instalarla

hermes skills install official/creative/archify

Es una skill oficial opcional — no forma parte de una instalación por defecto. Vive en optional-skills/creative/archify, está escrita por tt-a1i, con licencia MIT, versión 2.17.0.

Un detalle de diseño que conviene conocer: en el lado de Hermes esto es una entrada de catálogo mantenida upstream. La skill en sí vive en tt-a1i/archify (la CLI de Node, los esquemas, los renderers, los ejemplos y las referencias están todos allí), e instalarla trae el árbol actual en vivo desde ese repositorio, en cuarentena y escaneado como cualquier instalación desde el hub. La ventaja es directa: la copia que instalas no puede quedarse obsoleta.

Hay exactamente un requisito previo: Node.js 18+ en el PATH. La instalación trae unos 200 archivos (~8 MB, sobre todo tests y ejemplos upstream) y la descarga está fijada a un único SHA de árbol. Confirma el resultado con:

node bin/archify.mjs doctor

No hace falta npm install dentro del paquete de la skill.

Cinco tipos, un mismo flujo

Para ti el flujo es siempre el mismo: describe lo que quieres y obtienes un diagrama HTML más un recibo de validación.

Unas pocas decisiones ahorran tiempo en la práctica:

• «de qué está hecho el sistema y cómo se conectan las partes» → architecture;
• «en qué orden atraviesa una petición estos pasos» → workflow o sequence (el primero para flujo con ramificaciones, el segundo para idas y vueltas entre participantes);
• «de dónde vienen los datos, qué les pasa y dónde acaban» → dataflow;
• «qué estados tiene este objeto y qué eventos lo mueven» → lifecycle.

Si ya tienes Mermaid — muchas notas de reunión y muchos issues lo tienen — pegarlo y dejar que archify lo convierta en una versión interactiva es mejor que volver a describir la cosa desde cero.

Cómo se reparte el trabajo con la skill integrada

Hermes incluye una skill architecture-diagram: cero dependencias, y el fallback junto a archify (las dos comparten el mismo linaje de Cocoon AI).

La elección es sencilla:

• un diagrama, sin instalar Node, sin necesidad de interactividad ni exportación → la skill integrada;
• un recibo de validación, conversión de Mermaid, tipos sequence/lifecycle o exportaciones más allá de un único archivo HTML → archify.

Dos cosas a tener en cuenta

1. Su comprobación de actualizaciones solo imprime un aviso. El paso upstream de «update awareness» ejecuta scripts/check-update.mjs, que lee un manifiesto de release desde GitHub y solo imprime un aviso — nunca descarga ni instala nada. Si en tu entorno no quieres llamadas salientes, sáltatelo.
2. Leer tu código tiene un requisito de contexto. Cuando le pides a archify que fundamente un diagrama en evidencia del repositorio, lee lo que hay en tu directorio de trabajo actual — así que invocarlo desde la raíz del repositorio es mucho más útil que desde una carpeta temporal vacía.

La versión corta

El argumento de venta no es «el agente puede dibujar» — eso dejó de ser novedad hace tiempo. Es que archify trata un diagrama como algo con esquema, validación y recibo: cinco tipos que se corresponden con cinco intenciones claras, entrada que puede ser JSON tipado o Mermaid existente, salida que es HTML interactivo con varios formatos de exportación, y una entrada de catálogo mantenida upstream para que tu copia nunca quede obsoleta.

Si estás buscando skills opcionales, el resumen de skills opcionales ofrece una vista más amplia. Para visualización en general, mira el post de la oficina 3D y el hub de skills del desktop. Toda la superficie de comandos para instalar, confiar y gestionar skills está en la referencia de hermes skills.