CommunityImagegithub.com

schemdraw

Génère des schémas et graphiques scientifiques modifiables avec traçabilité des sources : extrait des entités et relations, produit des SVG superposés avec texte sélectionnable, cartographie la légende/les couleurs aux données sources, exporte en PDF+PNG à la résolution d'un journal, et valide la traçabilité des éléments.

Qu'est-ce que schemdraw ?

schemdraw est un outil spécialisé dans la création de figures scientifiques editables et traçables, conçu pour les agents IA comme Claude Code ou Cursor. Il prend en entrée un fichier de cas contenant du matériel scientifique, des listes d'entités/relations optionnelles, et des données de graphique. Le pipeline exécute quatre phases : extraction des entités et relations à partir du texte (en détectant des motifs comme 'active', 'inhibe', 'contient'), dessin d'un SVG superposé avec des flèches colorées et du texte sélectionnable, export vectoriel (PDF) et raster (PNG) via LibreOffice et PyMuPDF, puis validation automatique de l'intégrité des données, de la cohérence des légendes et de l'existence des fichiers exportés. L'accent est mis sur la traçabilité : toute entité ou relation doit avoir une provenance (citation textuelle) et la légende du graphique doit correspondre exactement aux données sources. En cas d'absence de LibreOffice, l'export est marqué comme 'partiel' sans échec silencieux. Le résultat final inclut des fichiers SVG, PDF, PNG, ainsi que des rapports de validation et d'export.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/iakRulan/schemdraw/tree/HEAD

Installed? Explore more Image skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · 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

schemdraw — Schémas Scientifiques Modifiables avec Traçabilité des Sources

Chemin du script : Cette compétence est installée dans /skills/weekly-skill/, le chemin absolu du script est /skills/weekly-skill/scripts/ (le répertoire de travail est /app/work, ne pas utiliser de chemins relatifs).

Produisez une figure qui est correcte, modifiable et conforme à l'exportation : chaque entité/relation est traçable jusqu'au matériel source, la légende correspond aux données, le texte reste sélectionnable, et les exportations respectent la résolution cible. Le mode d'échec que cette compétence vise à prévenir : une jolie image avec des relations d'entités erronées, des noms de gènes ou des concentrations inventés, une légende en désaccord avec les données, et une sortie uniquement bitmap qui ne peut pas être modifiée.

Méthode en une ligne : extraire les entités/relations du matériel → les disposer en SVG superposé (groupé, texte sélectionnable, direction des flèches selon le type de relation) → construire le graphique à partir des mêmes données sources avec une légende/carte de couleurs explicite → exporter PDF+PNG → valider la traçabilité et le contrat d'exportation.

Quand l'utiliser

  • Entrée : un fichier de cas (par défaut /input/case.json) contenant le matériel scientifique, des listes optionnelles d'entités/relations, des données de graphique et des spécifications d'exportation.
  • Sortie : dans /app/output — figure.svg, chart.svg, figure.pdf, figure.png, entities.json, export_report.json, validation.json, result.json.
  • Le SVG est la source modifiable ; PDF/PNG sont les exportations.

Pipeline (à exécuter dans l'ordre)

Phase 1 — Extraction et dessin

python3 /skills/weekly-skill/scripts/schem.py --case /input/case.json --work /app/work
  • Lit chaque matériel (texte/Markdown), fusionne les entités/relations fournies avec les relations extraites à partir de motifs : X active|promeut|renforce Y, X inhibe|supprime|bloque Y, X -> Y, X --| Y, X se lie|interagit avec Y, X contient|inclut Y.
  • Chaque relation porte une provenance (text-pattern + la citation source) ou provient de la liste fournie.
  • Écrit entities.json et un figure.svg superposé : <g id="arrows"> avec data-source/data-target/data-type, <g id="nodes"> avec un groupe par entité et des libellés <text>. La couleur/le pointillé des flèches encode le type de relation (vert = activation, rouge = inhibition, pointillé = contenance).
  • Si le cas contient des données de graphique, écrit chart.svg dont les barres portent data-label/data-value et dont la légende utilise le même index de palette que les barres.

Phase 2 — Exportation

python3 /skills/weekly-skill/scripts/export.py --work /app/work --dpi 300

LibreOffice en mode sans tête convertit SVG → PDF (vectoriel, texte sélectionnable) ; PyMuPDF rastérise le PDF → PNG à la résolution demandée. Écrit export_report.json. Si LibreOffice est manquant, le rapport l'indique et le statut devient partial — jamais un échec silencieux.

Phase 3 — Validation

python3 /skills/weekly-skill/scripts/validate.py --case /input/case.json --work /app/work

Vérifications :

  1. chaque extrémité de relation est une entité déclarée (pas de flèches pendantes) ;
  2. chaque relation a une provenance ou une citation source ;
  3. les étiquettes et les valeurs de la légende du graphique correspondent exactement aux données sources ;
  4. le SVG a du <text> (sélectionnable) et ≥2 couches ;
  5. les exportations PDF et PNG existent et le PNG n'est pas anormalement petit.

Phase 4 — Copie des livrables

mkdir -p /app/output
cp /app/work/figure.svg /app/work/chart.svg /app/work/figure.pdf /app/work/figure.png \
   /app/work/entities.json /app/work/export_report.json /app/work/result.json /app/output/
# validation.json est écrit par validate.py ; le copier aussi s'il est présent

Règles impératives

  1. Les entités proviennent du matériel. Pas de noms de gènes, concentrations ou points temporels inventés ; tout ce que le modèle ajoute doit être sourcé et marqué.
  2. La direction des relations est une donnée. A active B est dessiné A → B, jamais inversé ; le type de flèche suit le type de relation.
  3. Cohérence légende ⇄ données. Les étiquettes et couleurs de la légende proviennent du même tableau que les barres ; modifier les données modifie la légende.
  4. Source modifiable + exportation conforme. Toujours livrer le SVG (modifiable) et le PDF/PNG (exportation) ensemble.
  5. L'exportation est vérifiée, pas supposée. La résolution, l'incorporation des polices et l'existence des fichiers sont enregistrées ; un échec d'exportation est signalé.

Gestion des exceptions

SituationComportement
Pas de matériel / videliste d'entités vide ; SVG toujours écrit avec un titre
Extrémité de relation inconnueconservée dans entities (ajoutée à partir du motif) et dessinée
Données de graphique manquanteschart.svg ignoré ; entities.json.chart_svg = null
LibreOffice manquantPDF/PNG manquants, export_report.status = partial, limitation enregistrée
Pas de relationsSVG avec nœuds uniquement ; la validation note 0 relations

Auto-vérification

python3 /skills/weekly-skill/scripts/validate.py --case /input/case.json --work /app/work
python3 -c "import json;e=json.load(open('/app/work/entities.json'));print(len(e['entities']), len(e['relations']), e['relation_counts'])"

valid: true est requis ; le modèle doit remplir toute entité/relation que l'extracteur déterministe aurait manquée, toujours avec une source.

Skills associés