Impeccable langage design agents IA : le dépôt pbakaus/impeccable se décrit comme « le langage de design qui améliore le design de votre harnais d’IA ». Concrètement, c’est un skill (une instruction réutilisable pour un agent de code) accompagné de 24 commandes, d’un détecteur de 61 règles pour repérer les défauts typiques du frontend généré par IA, et d’un mode d’itération dans le navigateur. Le dépôt compte environ 84 600 étoiles à la fin d’octobre 2026.
Pourquoi en parler sur un blog d’exploitation ? Parce qu’un skill qui installe des hooks, télécharge un binaire et propose de la télémétrie est un composant de votre chaîne de livraison. Cet article suit le README et la documentation du projet : ce qu’il fait, comment l’installer, ce qu’il écrit sur votre disque, et comment mesurer ce qu’il détecte. Pour un autre skill de la série, voir le skill d’audit de sécurité Cloudflare.
Précision d’honnêteté : span.observer n’a pas installé Impeccable. Les commandes viennent du README, et la capture vient du site du projet.
Impeccable langage design agents IA : ce que dit le dépôt
- Auteur et licence : le README indique que le projet a été créé par Paul Bakaus ; licence Apache 2.0 (fichier LICENSE).
- Chiffres relus le 22 octobre 2026 : environ 84 600 étoiles, environ 5 100 forks, 2 517 commits. La page du dépôt n’affiche aucune release.
- Contenu annoncé : 1 skill, 24 commandes (
craft,shape,critique,audit,polish,harden,animate,live…), 61 règles déterministes de détection, et des commandes LLM de critique. - Origine : le README dit que le projet est parti du skill
frontend-designd’Anthropic ; il n’est pas présenté comme un produit de cette société. - Outils pris en charge : Cursor, Claude Code, GitHub Copilot, Gemini CLI, Codex CLI, Grok Build, OpenCode et une dizaine d’autres, selon la liste du README.
Le principe du README : tous les modèles ont appris sur les mêmes gabarits de SaaS, d’où les mêmes défauts (Inter partout, dégradés violet-bleu, cartes dans des cartes). Le skill donne un vocabulaire commun à l’agent, et le détecteur vérifie le résultat sans modèle ni clé d’API.
Visite : ce que le détecteur cherche
Le site du projet illustre chaque défaut par une page d’exemple. Voici celle des dégradés violets : une page volontairement typique, avec une marque fictive, que le projet range parmi les motifs à éviter.

La documentation du détecteur montre un constat réel sur un petit fichier CSS (règle gradient-text, ligne 3) et les commandes de scan.

Installation pas à pas
Étape 1 — L’installeur recommandé
Depuis la racine de votre projet :
npx impeccable install
/impeccable init
L’installeur détecte vos outils (par exemple ~/.claude ou un dossier .cursor du projet), demande si l’installation vise le projet ou le poste, puis pose le skill. Les options --providers=claude,cursor et --scope=project|global évitent les questions en script. Pour mettre à jour : npx impeccable update. Dans l’agent, /impeccable init écrit un fichier PRODUCT.md qui décrit public, usage et contraintes.
Étape 2 — Alternatives du README
- Sous-module Git :
git submodule add https://github.com/pbakaus/impeccable .impeccable, puisnpx impeccable link --source=.impeccable --providers=claude,cursor. - Claude Code :
/plugin marketplace add pbakaus/impeccable, puis installation depuis/plugin. - Copie manuelle depuis
dist/, ou ZIP du site officiel.
Étape 3 — Le détecteur seul, sans agent
npx impeccable detect src/
npx impeccable detect http://localhost:3000
npx impeccable detect --json src/
npx impeccable detect --github src/
Le README précise les codes de sortie : 0 sans constat, 2 avec constats, 1 si une cible n’a pas pu être analysée. L’option --github produit des annotations pour GitHub Actions (au plus 10 de chaque type par étape et 50 par job, selon le README). C’est la partie la plus utile pour une équipe SRE : un contrôle en intégration continue, sans modèle.
Ce que l’outil écrit et envoie
- Hooks : sur Claude Code, Copilot, Codex, Cursor et Grok Build, l’installeur ajoute un manifeste de hooks qui lance le détecteur après chaque édition de fichier d’interface. Le README prévient que, sous Claude Code, ces hooks s’exécutent indépendamment de l’approbation des outils : le premier événement peut télécharger et mettre en cache le moteur dans
~/.impeccable/bin/. Relisez les hooks avant un run sans surveillance. - Dossier
.impeccable/: captures, état du mode live et caches. Le README donne un bloc.gitignoreà copier et liste les fichiers à versionner (config.json,design.json,surfaces/*.md). - Télémétrie : le skill appelle l’API du site impeccable.style pour tirer une « main » de mondes visuels ; sauf opposition, un enregistrement anonyme du choix est envoyé. Le README dit que ni le nom du projet, ni les fichiers, ni le code, ni
PRODUCT.mdne partent. Pour la couper :npx impeccable telemetry off, ouDO_NOT_TRACK=1, ouIMPECCABLE_NO_TELEMETRY=1. - Mode live : il édite un dépôt local via un serveur de développement ; l’appliquer à un site de production n’est pas pris en charge. L’application de modifications de texte exécute le script optionnel
impeccable:manual-edit-validatede votrepackage.jsondans un shell : relisez-le dans un dépôt inconnu.
Observer Impeccable
Impeccable n’est pas un service : il n’y a ni traces ni métriques à exporter, et le README n’en décrit pas. Ce qu’on peut mesurer :
- Constats du détecteur : la sortie
--jsonou les annotations--githubdonnent un nombre de constats par règle. Suivez-le au fil des pull requests, comme un indicateur de qualité, sans en faire un objectif absolu : le README rappelle qu’un scan propre n’est pas une preuve de qualité visuelle ou d’accessibilité. - Exécution des hooks : le paramètre
hook.auditLogde.impeccable/config.json(ou la variableIMPECCABLE_HOOK_LOG) écrit une ligne NDJSON par appel de hook. Branchez ce fichier sur votre collecteur de journaux. - Coût en tokens : les commandes de critique passent par le modèle de votre agent. Pour l’attribuer, suivez la supervision d’un agent de code.
Limites et points ouverts
- Le projet change vite (24 commandes, une quinzaine d’outils pris en charge) : relisez la documentation avant chaque mise à jour.
- Le détecteur applique des règles de goût : « pas d’Inter », « pas de dégradé violet » restent des choix de design à discuter, pas des erreurs absolues. Les exceptions se déclarent dans la configuration.
- Une partie du flux (tirage de mondes visuels) passe par le serveur du projet ; sans réseau, le README ne dit pas ce qui se passe. Testez-le avant de dépendre de ce mode.
- Compatibilité : la page du dépôt n’affichait aucune release à la date de relecture.
Bonnes pratiques
- Essayez d’abord le détecteur seul en CI, puis seulement le skill dans l’agent.
- Désactivez la télémétrie sur les postes soumis à une politique de données, et versionnez la décision dans
.impeccable/config.json. - Mettez les skills de vos agents sous revue comme du code ; voir aussi le répertoire officiel de plugins Claude Code.
- Ne déclarez pas d’exception globale pour faire taire une règle : préférez la renonciation ciblée dans le fichier.
Questions fréquentes
Impeccable fonctionne-t-il sans clé d’API ?
Le détecteur oui : le README dit que la CLI et l’extension de navigateur exécutent les règles déterministes sans modèle ni clé. Les commandes de design passent par l’agent que vous utilisez déjà.
Faut-il Node.js ?
Seulement pour npx. Le skill embarque un lanceur qui exécute un binaire autonome, téléchargé une fois dans ~/.impeccable/bin/ s’il n’est pas livré avec.
Est-ce lié à Anthropic ou à Cursor ?
Le README ne le présente comme un produit ni d’Anthropic ni de Cursor : il dit être parti du skill frontend-design d’Anthropic et prend en charge de nombreux outils, dont ces deux-là.
Conclusion
Impeccable donne un langage commun pour demander mieux qu’un frontend « générique » à un agent, et un détecteur qui s’intègre à la CI. Son bon usage tient à trois réglages : détecteur d’abord, télémétrie décidée, hooks relus. Sources : dépôt pbakaus/impeccable et documentation du détecteur.
span.observer est un blog indépendant de la communauté, non affilié à Dynatrace LLC ni aux projets cités. Les marques citées appartiennent à leurs propriétaires. Les outils évoluent vite : vérifiez les commandes et options dans leur documentation officielle.