CommunityRédaction et éditiongithub.com

Spotlight-Revenue/drawio-diagrammer-skill

Générez des diagrammes draw.io esthétiquement beaux avec une boucle de révision visuelle obligatoire — votre agent construit des diagrammes qui ont réellement l'air corrects.

Qu'est-ce que drawio-diagrammer-skill ?

Cette compétence permet à un agent IA (comme Claude Code ou Cursor) de créer des diagrammes draw.io professionnels et esthétiques, allant des organigrammes et ERD aux diagrammes d'architecture et UML. Elle impose un processus de révision visuelle systématique : après chaque export, l'agent exporte le diagramme en PNG et l’inspecte visuellement pour corriger tout problème de mise en page ou de style. La compétence inclut des références détaillées pour les types de diagrammes (flowchart, ERD, architecture, classe, séquence) et des normes de style strictes (espacement, alignement, largeur des panneaux). Le flux de travail standard comprend la détection du type, la planification, l'application de styles universels, l'écriture XML, l'export PNG avec une boucle de révision, puis la livraison au format demandé. Elle supporte macOS (export direct) et Linux/headless (via xvfb-run).

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add Spotlight-Revenue/drawio-diagrammer-skill

Installed? Explore more Rédaction et édition skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Compétence Draw.io Diagramme

Quand utiliser cette compétence

  • L'utilisateur demande un organigramme, un schéma de processus ou un diagramme de flux de travail
  • L'utilisateur demande un ERD, un diagramme de base de données ou un modèle de relations entre entités
  • L'utilisateur demande un diagramme d'architecture, de système ou de composants
  • L'utilisateur demande un diagramme de classes, de séquence ou UML
  • L'utilisateur dit "draw.io", "diagramme", "organigramme", "visualise ce processus"
  • L'utilisateur demande de mettre à jour, corriger ou étendre un fichier .drawio existant

OBLIGATOIRE — À lire avant de générer quoi que ce soit

  1. Détecter d'abord le type de diagramme — voir les références diagram-types/ avant d'écrire du XML
  2. Appliquer les normes de style universelles — voir references/box-style-standards.md
  3. Toutes les positions sont codées en dur — il n'existe pas de mise en page automatique dans le XML de draw.io
  4. Exécuter la boucle de révision visuelle après chaque export — voir references/visual-review-protocol.md
  5. Ne jamais déclarer terminé sans une passe visuelle — exporter en PNG, le lire, le corriger, répéter

Détection du type de diagramme

L'utilisateur dit...Fichier de référence
"organigramme", "processus", "étapes", "flux de travail", "procédure"references/diagram-types/flowchart.md
"ERD", "base de données", "tables", "entités", "clé étrangère"references/diagram-types/erd.md
"architecture", "système", "composants", "services"references/diagram-types/layout.md
"classe", "UML", "héritage", "méthodes", "attributs"references/diagram-types/class.md
"séquence", "interaction", "ligne de vie", "appels d'acteur"references/diagram-types/sequence.md

Flux de travail standard de génération

Étape 1 — Charger la référence du type

Lire le fichier references/diagram-types/ approprié avant d'écrire du XML.

Étape 2 — Planifier tous les éléments

Lister chaque nœud, connexion et section avant de coder. Ne pas improviser la mise en page en cours de construction.

Étape 3 — Appliquer le style universel des boîtes

Chaque nœud doit inclure les attributs d'espacement universels de references/box-style-standards.md.

Étape 4 — Créer le dossier de sortie et écrire le XML

mkdir -p ./diagrams

Enregistrer dans :

./diagrams/<nom-diagramme>.drawio

Liste de vérification avant enregistrement :

  • Tous les éléments mxCell ont des identifiants numériques séquentiels uniques
  • L'espacement universel des boîtes est appliqué à chaque style de nœud : spacingLeft=12;spacingRight=12;spacingTop=10;spacingBottom=10;verticalAlign=top;
  • Les flèches utilisent un routage enchaîné, pas de fan-out d'une seule source vers plusieurs cibles
  • Écart minimum de 15 à 20 pixels entre deux boîtes (vérifier le bas de la liste des sous-éléments par rapport au haut de la section suivante)
  • Hauteurs calculées avec la formule dans box-style-standards.md (×16 px par ligne à fontSize=10)
  • Les panneaux de texte large (notes, descriptions) font 530 px de large ou plus — pas 460 px ou moins
  • Pas de \n littéral dans les attributs value — utiliser &#xa; pour les sauts de ligne
  • verticalAlign=top sur toutes les boîtes de contenu multiligne

Étape 5 — Exporter en PNG et exécuter la boucle de révision visuelle

/Applications/draw.io.app/Contents/MacOS/draw.io --export --format png --output ./diagrams/<nom>.png --scale 2 --border 30 ./diagrams/<nom>.drawio

Suivre ensuite le protocole complet dans references/visual-review-protocol.md.

Étape 6 — Livrer

Envoyer d'abord le PNG à l'utilisateur. Pour les grands diagrammes, envoyer des captures d'écran de sections (haut, milieu, bas) avant l'image complète.

Puis demander les formats supplémentaires souhaités :

Le diagramme est prêt. Quel format souhaitez-vous ?

1 — Image PNG (prête à visualiser)
2 — Fichier .drawio (éditable dans draw.io)
3 — SVG (vecteur évolutif)
4 — PDF
5 — Tout ce qui précède

Répondez avec le(s) numéro(s) de votre choix.

Pour une livraison par Drive ou des chemins de sortie personnalisés, suivre references/workflow-sop.md.


Référence CLI

# macOS — Exporter PNG (standard)
/Applications/draw.io.app/Contents/MacOS/draw.io --export --format png --output <sortie.png> --scale 2 --border 30 <fichier.drawio>

# macOS — Exporter PNG haute résolution
/Applications/draw.io.app/Contents/MacOS/draw.io --export --format png --output <sortie.png> --scale 3 --border 30 <fichier.drawio>

# macOS — Exporter SVG
/Applications/draw.io.app/Contents/MacOS/draw.io --export --format svg --output <sortie.svg> <fichier.drawio>

# macOS — Exporter PDF
/Applications/draw.io.app/Contents/MacOS/draw.io --export --format pdf --output <sortie.pdf> <fichier.drawio>

# Linux / headless — Exporter PNG
xvfb-run -a drawio --export --format png --output <sortie.png> --scale 2 --border 30 <fichier.drawio>

# Linux / headless — Exporter SVG
xvfb-run -a drawio --export --format svg --output <sortie.svg> <fichier.drawio>

Skills associés