Qu’est-ce que fireworks-tech-graph ?
fireworks-tech-graph est un Agent Skill, un SKILL.md plus des scripts Python, qui laisse Claude Code ou Codex dessiner des diagrammes techniques à partir d'une description en anglais ou chinois simple. L'agent classifie la demande, écrit une description JSON versionnée du diagramme, et le générateur fourni route les flèches et rend du SVG, un PNG de 1 920 pixels, une page HTML interactive hors ligne ou un GIF animé.
Il couvre 14 types de diagramme, dont l'ensemble UML (classe, séquence, machine à états, déploiement et d'autres) et les diagrammes ER, plus des patterns prêts pour les systèmes IA comme le RAG, les configurations multi-agents, les flux d'appel d'outils et la mémoire façon Mem0. Il y a 12 styles visuels, 11 pilotés par le générateur et un écrit librement par le modèle, et des icônes pour plus de 40 produits.
Il est sous licence MIT, écrit principalement en Python, par Brad Zhang (yizhiyanhua-ai). La version 1.2.0 est sortie le 17 juillet 2026 ; le dernier changement de code a atterri le 5 septembre et le dépôt avait environ 11 800 étoiles à la dernière vérification.
fireworks-tech-graph vaut-il le coup ?
fireworks-tech-graph vaut la peine d'être installé pour une raison : il ne fait pas confiance au premier dessin du modèle. Le skill fait écrire à l'agent une description intermédiaire validée par schéma, un planificateur déterministe route les arêtes, et le résultat doit passer des vérifications structurelles (XML, marqueurs, chevauchements, croisements) avant que l'agent ne relise le PNG et ne fasse au plus deux correctifs ciblés. Le contrat de vitrine demande zéro croisement, pas plus de deux coudes par arête et au moins 40 pixels entre les nœuds. Quand l'agent ne peut pas lire les images, il rapporte `visual_review: skipped` au lieu de revendiquer un succès.
La sortie vise les diapositives, les billets de blog et les revues de conception, pas la documentation vivante. Les diagrammes sortent en SVG et PNG, qui ont bien meilleure allure que Mermaid mais ne peuvent pas être differ ou édités comme du texte dans une pull request. Le style 9 produit des revues de conteneurs C4 et les styles 10 à 12 couvrent les déploiements multi-régions, les topologies d'événements et les tableaux de bord de signaux dorés, ce qui est plus proche de ce que les équipes plateforme dessinent réellement. Deux des styles imitent le look maison de Claude et d'OpenAI, ce qui est bien pour les présentations internes et discutable sur une page publique.
L'installation a des aspérités. Le README avertit qu'un simple `npx skills add` du dépôt peut prendre le mauvais SKILL.md, si bien que vous devez donner le chemin imbriqué, et le paquet npm (1.0.4) est en retard sur la version GitHub. L'export PNG a besoin de cairosvg ou rsvg-convert, et les GIF ont besoin de FFmpeg, Chrome et Puppeteer installés à côté de chaque copie du skill.
La maintenance est celle d'une seule personne. Il y a 12 contributeurs, une issue ouverte, et le seul commit depuis le 5 septembre est une édition de sponsor du README ; le README annonce aussi le conseil payant de l'auteur. Comparé à Anatomy, qui construit une seule figure explicative interactive sur une longue session, ce skill est plus rapide et plus conventionnel : des boîtes, des flèches et des couloirs, faits proprement.
Là où il fait la différence
Un ingénieur staff qui prépare une revue de conception
Dessiner l'architecture de checkout proposée sans un après-midi dans draw.io
Demandez à Claude Code un diagramme de conteneurs C4 dans le style 9 avec des services et des protocoles nommés ; le skill rend du SVG et du PNG et rapporte les résultats de validation. Le coût est une session d'agent ; les éditions signifient reformuler plutôt que glisser des boîtes.
Un développeur-ambassadeur dans une entreprise d'infrastructure IA
Illustrer un pipeline RAG ou multi-agents pour un billet de blog de lancement
Utilisez le pattern RAG ou multi-agents intégré avec des icônes de produit et exportez un PNG de 1 920 pixels plus un GIF animé pour les publications sociales. Le chemin GIF a besoin de FFmpeg et Puppeteer installés d'abord.
Un responsable SRE qui documente un système piloté par événements
Montrer les topics, les consommateurs et les files de lettres mortes en une seule image
Le style 11 dessine les topics comme des rails et les processeurs comme des stations, avec une DLQ déclarée ; l'export HTML hors ligne donne aux lecteurs le pan et le zoom sans rien héberger.
Avant de vous engager
- Mise en route
- `npx -y skills@1.5.17 add yizhiyanhua-ai/fireworks-tech-graph/skills/fireworks-tech-graph --agent codex claude-code -g -y --copy`, ou un git clone dans ~/.claude/skills ou ~/.agents/skills. A besoin de Python 3.9+ et de cairosvg ; `fireworks.py doctor` vérifie les dépendances GIF optionnelles.
- Intégrations
- Claude Code et Codex via le format Agent Skills ; un CLI unifié (render, validate, check, export-html, animate) qui fonctionne aussi sans agent ; rend avec cairosvg, rsvg-convert ou Chrome headless.
- Données et confidentialité
- Le README ne décrit aucun service hébergé : le rendu et les vérifications tournent localement, et la description que vous tapez ne va qu'au modèle que votre agent utilise. Licence MIT, si bien que l'usage commercial est sans restriction.
- Coût à grande échelle
- Gratuit. Le coût est les tokens d'agent, dont jusqu'à deux passes de correction et une relecture d'image par diagramme ; aucun chiffre de tokens par diagramme n'est publié.
- Limites
- Pas de source de diagramme en texte pour les workflows docs-as-code ; le style 8 est écrit librement par le modèle et saute le générateur ; rsvg-convert peut abandonner le CSS, si bien que les PNG ont la meilleure allure avec cairosvg.
Les points forts
- Validateur et relecture du PNG avant qu'un diagramme ne compte comme fait
- 14 types de diagramme dont UML complet et ER
- Patterns de systèmes IA (RAG, multi-agents, appels d'outils) intégrés
- Sorties SVG, PNG, HTML hors ligne et GIF
Les points faibles
- Sortie en image, pas en texte que vous pouvez differ dans une pull request
- Chemin d'installation imbriqué requis ; le paquet npm est en retard
- L'export GIF a besoin de FFmpeg, Chrome et Puppeteer
- Mainteneur unique ; peu de changements de code depuis septembre
Idéal pour
Les ingénieurs et rédacteurs techniques qui ont besoin de diagrammes d'architecture soignés pour des diapositives, des billets et des revues de conception depuis l'intérieur de Claude Code ou Codex.
Alternatives à fireworks-tech-graph
fireworks-tech-graph : questions fréquentes
- fireworks-tech-graph vaut-il le coup ?
- Un skill de diagramme qui vérifie sa propre géométrie avant de livrer, idéal pour les diapositives et les billets, même si Mermaid gagne encore pour les diagrammes qui vivent dans la documentation. Nous lui donnons 3.9 sur 5.
- Combien coûte fireworks-tech-graph ?
- Gratuit et open source (MIT). Tourne sur l'abonnement ou l'API d'agent que vous utilisez déjà.
- Quels sont les inconvénients de fireworks-tech-graph ?
- Sortie en image, pas en texte que vous pouvez differ dans une pull request; chemin d'installation imbriqué requis ; le paquet npm est en retard; l'export GIF a besoin de FFmpeg, Chrome et Puppeteer; mainteneur unique ; peu de changements de code depuis septembre.
- À qui s’adresse fireworks-tech-graph ?
- Les ingénieurs et rédacteurs techniques qui ont besoin de diagrammes d'architecture soignés pour des diapositives, des billets et des revues de conception depuis l'intérieur de Claude Code ou Codex.
- Combien coûte fireworks-tech-graph pour une équipe ou en production ?
- Gratuit. Le coût est les tokens d'agent, dont jusqu'à deux passes de correction et une relecture d'image par diagramme ; aucun chiffre de tokens par diagramme n'est publié.
- fireworks-tech-graph est-il sûr pour les données de l’entreprise ?
- Le README ne décrit aucun service hébergé : le rendu et les vérifications tournent localement, et la description que vous tapez ne va qu'au modèle que votre agent utilise. Licence MIT, si bien que l'usage commercial est sans restriction.
- Quelles sont les meilleures alternatives à fireworks-tech-graph ?
- Les alternatives les plus proches que nous avons testées sont Anatomy, Anthropic Skills et Impeccable.
Réponses vérifiées le 26 oct. 2026.