¿Qué es fireworks-tech-graph?
fireworks-tech-graph es una Agent Skill, un SKILL.md más scripts de Python, que permite a Claude Code o Codex dibujar diagramas técnicos a partir de una descripción en inglés o chino llano. El agente clasifica la petición, escribe una descripción JSON versionada del diagrama, y el generador incluido traza las flechas y genera SVG, un PNG de 1.920 píxeles, una página HTML interactiva sin conexión o un GIF animado.
Cubre 14 tipos de diagrama, incluido el conjunto UML (clases, secuencia, máquina de estados, despliegue y otros) y los diagramas ER, además de patrones listos para sistemas de IA como RAG, configuraciones multiagente, flujos de llamadas a herramientas y memoria al estilo de Mem0. Hay 12 estilos visuales, 11 controlados por el generador y uno escrito libremente por el modelo, e iconos para más de 40 productos.
Tiene licencia MIT, está escrito sobre todo en Python y es obra de Brad Zhang (yizhiyanhua-ai). La versión 1.2.0 salió el 17 de julio de 2026; el último cambio de código llegó el 5 de septiembre y el repositorio tenía unas 11.800 estrellas en la última comprobación.
¿Merece la pena fireworks-tech-graph?
fireworks-tech-graph merece instalarse por un motivo: no se fía del primer dibujo del modelo. La skill hace que el agente escriba una descripción intermedia validada por un esquema, un planificador determinista traza las aristas y el resultado tiene que pasar comprobaciones estructurales (XML, marcadores, superposiciones, cruces) antes de que el agente vuelva a leer el PNG y haga como máximo dos correcciones concretas. El contrato de la galería exige cero cruces, no más de dos codos por arista y al menos 40 píxeles entre nodos. Cuando el agente no puede leer imágenes, informa de `visual_review: skipped` en lugar de dar la prueba por superada.
El resultado está pensado para presentaciones, artículos de blog y revisiones de diseño, no para documentación viva. Los diagramas salen como SVG y PNG, que se ven mucho mejor que Mermaid pero no se pueden comparar con diff ni editar como texto en un pull request. El estilo 9 produce revisiones de contenedores C4 y los estilos del 10 al 12 cubren despliegues multirregión, topologías de eventos y paneles de golden signals, que se acercan más a lo que dibujan de verdad los equipos de plataforma. Dos de los estilos imitan el aspecto de la casa de Claude y de OpenAI, lo que está bien para presentaciones internas y es discutible en una página pública.
La instalación tiene asperezas. El README advierte de que un `npx skills add` del repositorio sin más puede coger el SKILL.md equivocado, así que hay que indicar la ruta anidada, y el paquete de npm (1.0.4) va por detrás de la versión de GitHub. La exportación a PNG necesita cairosvg o rsvg-convert, y los GIF necesitan FFmpeg, Chrome y Puppeteer instalados junto a cada copia de la skill.
El mantenimiento es de una sola persona. Hay 12 colaboradores, un issue abierto, y el único commit desde el 5 de septiembre es una edición del README sobre patrocinadores; el README también anuncia la consultoría de pago del autor. Frente a Anatomy, que construye una figura explicativa interactiva a lo largo de una sesión larga, esta skill es más rápida y más convencional: cajas, flechas y calles, bien hechas.
Dónde se gana su sitio
Un staff engineer que prepara una revisión de diseño
Dibujar la arquitectura de pago propuesta sin pasar una tarde en draw.io
Pide a Claude Code un diagrama de contenedores C4 en el estilo 9 con los servicios y protocolos nombrados; la skill genera SVG y PNG e informa de los resultados de la validación. El coste es una sesión de agente; editar significa volver a pedirlo en lugar de arrastrar cajas.
Una developer advocate en una empresa de infraestructura de IA
Ilustrar un pipeline de RAG o multiagente para un artículo de lanzamiento
Usa el patrón integrado de RAG o multiagente con iconos de productos y exporta un PNG de 1.920 píxeles más un GIF animado para redes sociales. La vía del GIF necesita FFmpeg y Puppeteer instalados antes.
Un responsable de SRE que documenta un sistema dirigido por eventos
Mostrar topics, consumidores y colas de mensajes fallidos en una sola imagen
El estilo 11 dibuja los topics como raíles y los procesadores como estaciones, con una DLQ declarada; la exportación HTML sin conexión permite a los lectores desplazarse y hacer zoom sin alojar nada.
Antes de decidirte
- Puesta en marcha
- `npx -y skills@1.5.17 add yizhiyanhua-ai/fireworks-tech-graph/skills/fireworks-tech-graph --agent codex claude-code -g -y --copy`, o un git clone en ~/.claude/skills o ~/.agents/skills. Necesita Python 3.9+ y cairosvg; `fireworks.py doctor` comprueba las dependencias opcionales del GIF.
- Integraciones
- Claude Code y Codex mediante el formato Agent Skills; una CLI unificada (render, validate, check, export-html, animate) que también funciona sin agente; genera con cairosvg, rsvg-convert o Chrome sin interfaz.
- Datos y privacidad
- El README no describe ningún servicio alojado: la generación y las comprobaciones se ejecutan en local, y la descripción que escribes solo va al modelo que usa tu agente. Licencia MIT, así que el uso comercial no tiene restricciones.
- Coste a escala
- Gratuito. El coste son los tokens del agente, incluidas hasta dos pasadas de corrección y una relectura de imagen por diagrama; no se publican cifras de tokens por diagrama.
- Límites
- No hay código fuente de diagramas en texto para flujos de docs-as-code; el estilo 8 lo escribe libremente el modelo y se salta el generador; rsvg-convert puede perder CSS, así que los PNG quedan mejor con cairosvg.
Lo bueno
- Validador y relectura del PNG antes de dar un diagrama por terminado
- 14 tipos de diagrama, incluidos UML completo y ER
- Patrones de sistemas de IA (RAG, multiagente, llamadas a herramientas) integrados
- Salidas en SVG, PNG, HTML sin conexión y GIF
Lo malo
- Salida en imagen, no texto que puedas comparar con diff en un pull request
- Requiere la ruta de instalación anidada; el paquete de npm va por detrás
- La exportación a GIF necesita FFmpeg, Chrome y Puppeteer
- Un solo mantenedor; pocos cambios de código desde septiembre
Ideal para
Ingenieros y redactores técnicos que necesitan diagramas de arquitectura cuidados para presentaciones, artículos y revisiones de diseño desde Claude Code o Codex.
Alternativas a fireworks-tech-graph
fireworks-tech-graph: preguntas frecuentes
- ¿Merece la pena fireworks-tech-graph?
- Una skill de diagramas que comprueba su propia geometría antes de entregar, ideal para presentaciones y artículos, aunque Mermaid sigue ganando en los diagramas que viven en la documentación. Le damos un 3.9 sobre 5.
- ¿Cuánto cuesta fireworks-tech-graph?
- Gratuito y de código abierto (MIT). Funciona con la suscripción de agente o la API que ya uses.
- ¿Qué inconvenientes tiene fireworks-tech-graph?
- Salida en imagen, no texto que puedas comparar con diff en un pull request; requiere la ruta de instalación anidada; el paquete de npm va por detrás; la exportación a GIF necesita FFmpeg, Chrome y Puppeteer; un solo mantenedor; pocos cambios de código desde septiembre.
- ¿Para quién es fireworks-tech-graph?
- Ingenieros y redactores técnicos que necesitan diagramas de arquitectura cuidados para presentaciones, artículos y revisiones de diseño desde Claude Code o Codex.
- ¿Cuánto cuesta fireworks-tech-graph para un equipo o en producción?
- Gratuito. El coste son los tokens del agente, incluidas hasta dos pasadas de corrección y una relectura de imagen por diagrama; no se publican cifras de tokens por diagrama.
- ¿Es fireworks-tech-graph seguro para los datos de la empresa?
- El README no describe ningún servicio alojado: la generación y las comprobaciones se ejecutan en local, y la descripción que escribes solo va al modelo que usa tu agente. Licencia MIT, así que el uso comercial no tiene restricciones.
- ¿Cuáles son las mejores alternativas a fireworks-tech-graph?
- Las alternativas más cercanas que hemos analizado son Anatomy, Anthropic Skills y Impeccable.
Respuestas comprobadas el 26 oct 2026.