show-me-the-build, una skill que explica el código que generó tu agente
El proyecto se instala con npx y genera un HTML autocontenido que reconstruye la arquitectura paso a paso, con explicaciones sacadas del propio código o de la documentación de infraestructura.
Hay un patrón que se repite en hackatones y equipos que programan con agentes: la demo funciona, pero a la hora de explicar qué hay debajo nadie tiene una respuesta clara. show-me-the-build es una skill para Claude Code, Cursor, Codex u otros agentes que recorre un repositorio o un despliegue en la nube y produce una presentación HTML que se monta sola.
Se instala con un único comando: npx skills@latest add sanidhya-build/skills --skill=show-me-the-build. También se puede pedir al propio agente que la instale en su carpeta global de skills. Luego basta con escribir /show-me-the-build en el agente. El resultado es un archivo HTML autocontenido, sin servidor ni paso de compilación: se copia, se abre y se presenta.
Un diagrama que se construye en orden
La diferencia con las herramientas que generan un diagrama estático está en cómo aparece. Los recursos o módulos se van añadiendo uno a uno, en el orden en que se crearon, y las conexiones entre ellos se dibujan en vivo. Al hacer clic en cualquier caja se abre un panel con una frase que justifica su existencia. No es un texto genérico del tipo «reduce el acoplamiento»: la explicación sale del código o de los documentos de infraestructura que el agente haya podido leer.
Para qué situaciones está pensado
El autor lo orienta a dos escenarios. El primero, competiciones y hackatones: después de horas generando una aplicación con un agente, hace falta contar la arquitectura en treinta segundos a alguien que no ha visto el proceso. El segundo, heredar una aplicación generada por IA, propia o de otra persona, donde ya no está claro qué está conectado con qué.
El proyecto se publica como skill y tiene ejemplos y código en sitio del proyecto.
La utilidad real depende de que el repositorio y la documentación de infraestructura tengan suficiente información. En un proyecto recién creado, con módulos y despliegues recientes, el orden de construcción es fácil de reconstruir. En un sistema grande y antiguo, donde parte del conocimiento está solo en la cabeza de quien lo montó, la presentación automática será tan buena como los datos que encuentre. Eso no quita que la idea ataque un problema cotidiano: cada vez hay más código generado con agentes y menos personas capaces de explicar cómo funciona.
