CommunityImagegithub.com

image-to-svg

Recréez fidèlement une image matricielle (affiche, illustration, horizon, illustration de type logo, infographie, art en silhouettes) sous forme de SVG propre, éditable et prêt à imprimer, construit à partir de géométrie construite plutôt que par auto-traçage.

Qu'est-ce que image-to-svg ?

Cette compétence transforme une image matricielle (PNG, JPG) en un SVG de haute qualité, éditable et prêt à imprimer, en reconstruisant la géométrie à partir de primitives mesurées plutôt qu'en utilisant l'auto-traçage. Elle est idéale pour les structures artificielles comme les bâtiments, monuments ou machines, où la symétrie, les lignes droites et la perspective sont cruciales. L'agent suit un workflow structuré en plusieurs phases : analyse de la composition, mesure précise via des scripts, construction géométrique avec des primitives SVG, typographie et couleurs quantitatives, puis vérification par comparaison, symétrie et validation. Le résultat est un SVG avec des couches nommées, du texte éditable, une mise en page centrée et une cohérence visuelle bien supérieure à un tracé automatique.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/davidpastorvicente/image-to-svg-skill/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

Image → SVG (construit, éditable, prêt à imprimer)

Transformez une référence matricielle en un SVG qu'un designer aurait dessiné à la main : lignes droites là où les choses sont droites, vrais cercles et arcs, vraie symétrie, éléments répétés cohérents, perspective correcte, une mise en page centrée cohérente, du texte éditable, des calques pertinents — et visuellement fidèle à l'original.

La leçon principale derrière cette compétence : l'auto-traçage d'une matricielle vous donne les défauts de la matricielle sous forme vectorielle (bords ondulés, dômes asymétriques, bosses, micropores, fenêtres "identiques" légèrement différentes). Les utilisateurs le remarquent immédiatement. Le traçage est acceptable pour une première passe de mesure ou pour des formes vraiment organiques, mais les structures artificielles doivent être reconstruites à partir de primitives mesurées.

Flux de travail

Travaillez par phases et obtenez la confirmation de l'utilisateur aux points de contrôle marqués ✋. Communiquez dans la langue de l'utilisateur ; gardez les rapports courts et liez aux fichiers.

1. Réception ✋

Demandez uniquement ce qui modifie le résultat (ignorez ce que l'utilisateur a déjà dit) :

  • Reproduction fidèle vs. fidèle avec nettoyage (par défaut : fidèle, affiner les irrégularités).
  • Arrière-plan : aucun/transparent (courant pour impression sur blanc), couleur unie ou texture.
  • Texte : <text> éditable (nécessite la police installée) vs. chemins vectorisés.
  • Utilisation prévue et taille (taille d'impression → largeur/hauteur de la page en mm ; conservez le rapport d'aspect de la source, ex. 2:3 → 30×45 cm).

2. Obtenez la meilleure référence

Utilisez la copie de la plus haute qualité disponible (un PNG sur disque est meilleur qu'une pièce jointe JPEG dans le chat — demandez à l'utilisateur s'il existe un fichier original). Copiez-la dans le projet (reference/original.png) et ne modifiez jamais l'original de l'utilisateur. Si seule une pièce jointe du chat existe, elle peut être récupérable depuis le stockage de session du harnais ; demandez avant de fouiller dans les bases de données de l'application.

3. Analysez et proposez ✋

Avant de dessiner quoi que ce soit, examinez des agrandissements recadrés et décrivez à l'utilisateur :

  • la composition générale et la grille (marges, alternance, alignement) ;
  • chaque figure : ce qu'elle est, ses parties, les parties symétriques, les éléments répétés (fenêtres, colonnes, cabines), la perspective (façades en retrait) ;
  • les candidats typographiques ; les couleurs ;
  • les classes d'équivalence et la grille : les objets ayant le même rôle et devant être identiques (formes d'arrière-plan, rôles de texte, barres d'accent, séparateurs, règles appariées, blocs répétés), les marges communes, les éléments centrés et le rythme vertical. La référence est souvent incohérente ici (rayons 154/128/144, trois tailles de titre) ; proposez d'unifier et ne demandez que là où une différence pourrait être intentionnelle. Voir references/layout.md. Proposez ensuite la structure des objets (calques/groupes, noms). Regroupez chaque illustration comme un groupe de type dossier (ex. "Silhouette architecturale") avec ses composants comme enfants distincts nommés. Attendez la confirmation.

4. Mesurez

Mesurez, ne faites pas au jugé. Utilisez scripts/measure.py (recadrages en grille, profils supérieurs, ouvertures, ajustements de lignes/cercles, échantillonnage de couleurs) et consultez references/measuring.md pour les techniques. Enregistrez les nombres par composant : coordonnées du contour, axes de symétrie, encadrements de fenêtres, centres/rayons de cercles.

5. Construisez la géométrie

Construisez chaque objet à partir de primitives avec scripts/svgkit.py (polygones avec enroulement automatique, fenêtres cintrées, arcs en perspective, dômes, ellipses, pointes, miroir, un Part qui collecte les solides/ouvertures/découpes). Lisez references/construction.md — il contient les règles qui font la différence : bords droits, symétrie par miroir autour d'un axe mesuré, éléments répétés identiques, perspective via des lignes de fuite, fusion de parties qui vont ensemble, remplissage de micropores, suppression de bosses, éviter les coutures.

Écrivez la construction comme un script (ex. build_svg.py + architecture.py) pour que chaque modification soit une réexécution, pas une édition manuelle du XML.

5b. Système de mise en page

Placez tout sur une seule grille définie comme constantes (marges symétriques autour du centre de la page, un rayon par classe de forme d'arrière-plan, un style par rôle de texte, un rythme vertical par bloc répété, règles égales/miroir). Alignez le texte en utilisant son encre réelle avec inkscape --query-all, puis centrez l'ensemble de l'œuvre sur la page et intégrez la translation dans les coordonnées. Lisez references/layout.md.

6. Typographie et couleur

Faites correspondre les polices quantitativement avec scripts/font_match.py ; conservez le texte éditable avec un x + un espacement des lettres partagé par chaque texte de même rôle, étalonné à partir des largeurs d'encre de référence. Échantillonnez les couleurs à partir de zones intérieures planes (médiane, pas de pixels uniques). Détails dans references/typography-and-colour.md.

7. Vérifiez, section par section

Après chaque construction :

  1. Rendez avec Inkscape (scripts/compare.py le fait) et comparez chaque section côte à côte avec la référence plus une superposition de différences rouge/bleu.
  2. Vérifiez les figures symétriques avec scripts/symmetry.py (miroir autour de l'axe ; le résidu doit être ~0.1 % — le reste est de l'anticrénelage ou des détails intentionnellement asymétriques comme des aiguilles d'horloge).
  3. Inspectez à la résolution d'impression (recadrage 300 dpi) pour les coutures, les filets, les espaces, les bosses résiduelles.
  4. Auditez la cohérence de la mise en page avec scripts/consistency.py (rayons égaux, styles de texte par rôle, barres, largeurs de règles, marges, rythme vertical, espacement des sections, relations de paires de couleurs, centrage). Chaque constatation est soit corrigée, soit confirmée comme intentionnelle.
  5. Validez le fichier avec scripts/validate.py (pas d'images matricielles/filtres, identifiants uniques, url(#…) résolubles, objets texte présents, taille de page). Regardez les images vous-même avant de rapporter. Les scores de chevauchement sont des diagnostics, pas un objectif — une construction raffinée différera légitimement d'une source floue et irrégulière.

8. Livrez et itérez

Rapportez brièvement : ce qui a été construit, les écarts intentionnels par rapport à la référence (ex. rendu symétrique, unification du nombre de fenêtres), dépendance de police, liens vers le SVG, un PNG d'aperçu et des images de comparaison. Attendez-vous à des retours ciblés ("ce dôme n'est pas symétrique", "faites suivre la perspective aux fenêtres", "faites correspondre cette tête de grue") — mesurez à nouveau la zone spécifique à fort zoom, reconstruisez et montrez un recadrage avant/après à côté de la référence. Lorsqu'une demande est ambiguë (ex. quel modèle de perspective), rendez les options sous forme de diagramme rapide et laissez l'utilisateur choisir au lieu de deviner. Montrez des alternatives (polices, couleurs, espacement) sous forme de feuilles de comparaison : original | actuel | option. Les modifications de contenu (nouvelles coordonnées, noms) conservent les styles figés et sont des faits vérifiés — voir references/typography-and-colour.md.

Notes d'environnement

  • Dépendances Python (utilisez un venv jetable, ex. uv venv dans le répertoire temporaire) : pillow numpy scipy opencv-python-headless fonttools lxml.
  • L'interface CLI d'Inkscape effectue le rendu de manière fiable : inkscape in.svg --export-type=png --export-filename=out.png --export-width=4096 --export-background=white --export-background-opacity=1. Les visionneuses d'images peuvent mettre en cache — écrivez de nouveaux noms de fichiers pour les aperçus successifs.
  • Potrace est inclus dans Inkscape (libpotrace) ; scripts/contour.py l'encapsule pour les formes organiques ou un premier tracé de mesure.

Fichiers

  • references/construction.md — règles de géométrie pour les bâtiments/structures, perspective, symétrie, remplissage/trous/coutures SVG. Lisez avant de construire.
  • references/measuring.md — comment extraire des nombres fiables de la matricielle.
  • references/layout.md — classes d'équivalence, grille/marges, rythme vertical, alignement de l'encre, espacement des lettres partagé, centrage de l'œuvre.
  • references/typography-and-colour.md — correspondance de polices, texte éditable, couleur.
  • references/svg-structure.md — calques/groupes pour Inkscape, découpes d'arrière-plan, configuration d'impression, liste de contrôle de livraison.
  • scripts/svgkit.py — primitives géométriques et Part (importez-le depuis votre script de construction).
  • scripts/measure.py — CLI : grid, profile, holes, color, fit-circle, fit-line.
  • scripts/font_match.py — classe les polices installées/candidates par rapport à un recadrage de texte.
  • scripts/compare.py — rendu + côte à côte + superposition par région.
  • scripts/symmetry.py — résidu de symétrie miroir par figure.
  • scripts/consistency.py — audit de mise en page : objets égaux, alignement, marges, rythme, centrage.
  • scripts/validate.py — vérifications structurelles du SVG final.
  • scripts/contour.py — contour optimisé basé sur potrace pour les formes organiques.

Skills associés