Skill de relecture d'icônes pour Claude Code : contrôle au 24 px, planches et tracés corrigés essayés

Ce kit s’adresse aux designers, aux développeurs front et aux petites équipes qui dessinent ou entretiennent un jeu d’icônes ligne en SVG et travaillent dans Claude Code. Il ajoute un skill, /icon-review, et un agent relecteur, icon-review-critic, qui relisent votre jeu comme le ferait un directeur artistique exigeant : mesures de la spécification (grille, trait, zone utile, rayons), planches au vrai 16, 24 et 48 px en clair et en sombre, verdict par icône et, pour chaque icône à reprendre, un tracé SVG corrigé. Sa règle centrale : essayer avant de prescrire. Une consigne de reprise que personne n’a dessinée (« agrandir la dent de la clé ») échoue souvent : elle contredit la spécification, ou la forme obtenue se lit comme un autre objet une fois rendue à 24 px. L’agent dessine donc lui-même la correction, la rend aux mêmes tailles, la mesure, la compare aux icônes voisines, et ne vous rend que le tracé qui a passé ces épreuves. Vos consignes de reprise arrivent ainsi sous forme de tracés exacts, prêts à copier. C’est la version générique de la relecture que l’auteur applique à ses propres packs d’icônes.

• 1 skill, icon-review (commande /icon-review), avec 3 modes :
  • review : première relecture complète d’un dossier d’icônes (mode par défaut) ;
  • recheck : deuxième passage, sur les seules icônes reprises ;
  • setup : installation du rasteriseur, puis arrêt. Le skill lit vos réglages, lance les mesures et les planches, confie la relecture à l’agent, puis vérifie ce qu’il rend avant de vous le présenter. Il prévoit aussi un contrôle ciblé après application des corrections et une règle d’escalade quand une icône résiste.
• 1 agent, icon-review-critic :
  • une grille de lecture en 8 points, appliquée à chaque icône : sujet reconnu, confusion, trait, grille, jours entre deux tracés, cohérence de famille, détail porteur, détail gratuit ;
  • une liste de symboles courants qui se confondent souvent à petite taille ;
  • des corrections essayées avant d’être écrites : rendues, mesurées et comparées à leurs voisines ;
  • un verdict par icône : « passe », « à reprendre » ou « passe avec réserve » quand les essais permis sont épuisés.
• 3 gabarits installés avec le skill : le rapport de relecture (review.md), les 12 critères de recette (acceptance-criteria.md) et les réglages par défaut (icon-review.json).
• 1 script, icon-tools.mjs, avec 5 commandes :
  • setup : installe le rasteriseur dans le dossier de cache du kit, hors du package.json de votre projet ;
  • defaults : affiche les réglages par défaut, sans rien écrire ;
  • measure : contrôles de la spécification, boîte d’encre, centre et poids d’encre de chaque icône ;
  • sheet : planches au vrai 16, 24 et 48 px, en clair et en sombre ;
  • compare : icônes côte à côte, chacune aux 3 tailles.
• 2 langues à la structure identique, fr/ et en/ : vous installez une seule langue par projet.
• Un guide d’installation par langue (INSTALL.fr.md, INSTALL.en.md) : prérequis, installation dans un projet ou pour tous vos projets, vérification, réglages, premier usage pas à pas, dépôt public, mise à jour et désinstallation. Le fichier CHANGELOG.md suit les versions.
• Un exemple en 24 fichiers (example/), décrit plus bas.

Ce que montre l’exemple

Le dossier example/ contient 6 icônes inventées pour la démonstration et leur relecture réelle par le kit. Deux d’entre elles ont été ratées exprès : une clé dont la dent disparaît à petite taille et qui se lit comme une loupe, et un dossier hors de la grille, dont l’encre sort de la zone utile. Le relecteur n’a pas été prévenu de ces défauts : il a trouvé les deux sans indice, les a rendus « à reprendre », et les 2 icônes reprises ont chacune leur tracé corrigé. Les autres icônes passent.

L’exemple contient le rapport (review.md), les mesures, les planches, la comparaison avant et après, les SVG corrigés et le dossier d’essais de l’agent, avec chaque dessin tenté. Rien n’y a été écrit ni retouché à la main. L’exemple a été produit en anglais.

Une précision, que le README de l’exemple donne aussi : le skill n’a pas tourné de bout en bout pour cet exemple. Ses étapes de mesure, de planches et de comparaison ont été lancées une à une avec le script du kit, et la fiche de l’agent icon-review-critic a servi de consigne à un agent séparé, avec le brief que le skill lui aurait écrit. L’exemple montre donc ce que rend l’agent relecteur, pas l’enchaînement complet lancé par /icon-review.

• Markdown : le skill, l’agent, les gabarits et les guides. La fiche de l’agent porte un en-tête (name, description, tools, model) lu par Claude Code.
• JavaScript : le script de rendu et de mesure, pour Node 18.17 ou plus.
• JSON : les réglages. Ils sont facultatifs : sans fichier, la spécification par défaut s’applique. Si votre jeu en suit une autre (taille de grille, épaisseur du trait, zone utile, rayon, pas des coordonnées, tailles des planches), vous la décrivez dans .claude/icon-review.json, qu’une mise à jour du kit n’écrase pas.
• SVG : les icônes de l’exemple, et le format que le kit relit.
• PNG : les planches de l’exemple.

Prérequis :

• Claude Code, avec un abonnement ou une clé qui donne accès aux modèles ; l’agent est réglé sur Opus, et le guide décrit le repli inherit si votre abonnement n’y donne pas accès ;
• Node.js 18.17 ou plus, et npm ;
• un accès réseau au premier lancement de setup, qui installe le rasteriseur sharp (licence Apache-2.0, jamais livré dans le zip) : lancez /icon-review setup une fois dans chaque projet où vous relisez des icônes ;
• des icônes ligne en SVG, une par fichier, dans un même dossier.

Les commandes d’installation s’écrivent dans un terminal : macOS, Linux, ou Windows avec WSL ou Git Bash. L’installation consiste à copier un dossier dans le .claude/ de votre projet, ou dans celui de votre dossier personnel pour tous vos projets.

Ce qui a été testé, et ce qui ne l’a pas été

Testé avant la mise en ligne : l’installation dans un dépôt vierge, dans les 2 langues, dans un projet et pour tous les projets ; le chargement de l’agent et du skill par Claude Code ; les commandes setup, measure, sheet et compare du script ; la relecture de l’exemple par l’agent du kit.

Non testé, et dépendant de votre environnement : l’enchaînement complet lancé par /icon-review, le déclenchement du skill par une phrase libre, la disponibilité d’Opus sur votre abonnement, les demandes de permission de vos réglages, et un très grand jeu d’icônes, dont les planches passent alors sur plusieurs pages.

Ce que le kit ne fait pas :

• il ne dessine pas un jeu d’icônes de zéro : il relit et corrige un jeu existant ;
• il ne remplace pas vos fichiers sans votre demande : les corrections sont écrites à part, vous les appliquez ou non ;
• il ne juge que des icônes ligne en SVG ; des icônes pleines ou en couleur demandent une autre spécification et un regard que la grille de lecture ne couvre qu’en partie ;
• il ne vérifie pas les droits d’un tracé repris d’ailleurs ;
• il n’envoie rien en ligne : seul setup télécharge le rasteriseur ;
• il ne remplace pas votre œil : une icône qui résiste après les essais permis vous revient « passe avec réserve », avec les essais listés.

Le kit est offert : il suffit de créer un compte gratuit sur Beryl Design pour télécharger l’archive. Il est livré sous licence commerciale : vous pouvez l’utiliser pour vos propres jeux d’icônes et pour ceux de vos clients, et garder tous les rapports et tracés corrigés qu’il produit pour vous. Vous ne pouvez pas revendre ni redistribuer le kit ou ses fichiers, même gratuitement. Si votre dépôt est public, installez le kit pour tous vos projets, ou ajoutez ses dossiers au .gitignore comme l’indique le guide d’installation.

• Sur la méthode qui a donné ce kit : produire une série d’icônes cohérentes avec l’IA, méthode et rejets.
• Sur la façon de brancher un agent d’IA à vos outils de design : le guide des agents et du protocole MCP.

1.0.0 (12 novembre 2026) : première version.

Claude Code est une marque de son éditeur ; ce kit n’est ni affilié ni approuvé.