Impeccable n'est ni ArtCraft ni un produit ou un composant de la suite ArtCraft ; cette page est un guide indépendant, et les informations officielles se trouvent sur impeccable.style et github.com/pbakaus/impeccable.
Impeccable : le vocabulaire de design de votre agent de codage
Impeccable est un skill de design et un outil en ligne de commande open source qui donne à votre agent de codage un vocabulaire commun pour critiquer, ajuster et polir des interfaces. Il a été créé par Paul Bakaus, à partir du skill frontend-design d'Anthropic, et publié sous licence Apache-2.0. Cette page est un guide indépendant, pas la documentation officielle.
- 24 commandes : critique, polish, audit, typeset, distill, etc.
- Un détecteur de 62 règles déterministes, sans LLM ni clé d'API
- Compatible avec Claude Code, Cursor, Codex CLI, Copilot et 19 agents au total
Site officielDépôt GitHubDocumentation
Dernière mise à jour: · English
Qu'est-ce qu'Impeccable ?
Impeccable est un skill qui s'installe dans votre agent de codage et lui apporte un vocabulaire de design, accompagné d'une CLI autonome. Il n'ouvre pas un canevas : il transforme le design en actions exécutables par l'agent, de la critique à la typographie en passant par le nettoyage et la robustesse. Le projet est né du skill frontend-design d'Anthropic et reste publié sous Apache-2.0.
Il s'attaque au goût par défaut des agents : Inter partout, dégradés violet-bleu, cartes imbriquées, texte gris sur fond coloré, petite tuile d'icône arrondie au-dessus de chaque titre. Un détecteur de 62 règles déterministes signale ces tics pendant l'édition, sans LLM ni clé d'API.
Il est le plus efficace sur des interfaces qui existent déjà : on désigne une page ou un composant, puis on itère. Il sait aussi produire de nouvelles pages, mais le projet reconnaît lui-même que ce mode est plus difficile. À noter : Impeccable est un projet open source indépendant, pas un produit ArtCraft et encore moins un élément de sa suite.
Installation et initialisation
Lancez la commande depuis la racine du projet. npx exige Node 18.19 ou une version ultérieure. L'installateur détecte vos outils, demande si l'installation doit être locale au projet ou globale, et propose le hook de design lorsque l'outil le permet. Acceptez-le.
Rechargez ensuite votre outil, puis exécutez /impeccable init ($impeccable init sur Codex). Pour un script, passez --providers=claude,codex,cursor et --scope=project|global. Une installation existante se met à jour avec npx impeccable update.
npx impeccable install- Vérifiez que Node 18.19+ est disponible et placez-vous à la racine du projet.
- Lancez npx impeccable install, choisissez la portée projet ou globale, et activez le hook de design si votre outil le prend en charge.
- Rechargez l'outil de codage, puis exécutez /impeccable init ($impeccable init sur Codex) pour écrire PRODUCT.md.
- Pour figer le système visuel, lancez /impeccable document et créez DESIGN.md ; ensuite, gardez l'installation à jour avec npx impeccable update.
Commandes essentielles
Impeccable compte 24 commandes. On les appelle sous la forme « commande + cible », par exemple /impeccable critique the pricing cards ; sur Codex, remplacez la barre oblique par $. Taper /impeccable seul affiche la liste. Voici les sept plus utiles.
| Commande | Ce qu'elle fait | Quand l'utiliser |
|---|---|---|
/impeccable init | Lit le code, ne pose que les questions auxquelles il ne peut pas répondre et écrit PRODUCT.md. | Une fois au démarrage du projet, pour donner du contexte aux commandes suivantes. |
/impeccable critique | Produit une revue UX notée selon des heuristiques d'utilisabilité et classe les corrections par priorité. | Avant une refonte, ou pour identifier où un parcours bloque. |
/impeccable polish | Effectue la dernière passe avant la mise en ligne. | Quand les fonctionnalités sont figées et que le lancement approche. |
/impeccable audit | Rédige un rapport technique sur l'accessibilité, les performances, les thèmes, le responsive et l'intégrité de l'implémentation, avec des constats P0 à P3. | Avant une release, ou pour traiter une dette d'implémentation. |
/impeccable typeset | Corrige les polices, la hiérarchie, les tailles et les espacements. | Quand la typographie semble molle ou que la hiérarchie se perd. |
/impeccable distill | Retire ce dont la page n'a pas besoin. | Quand la page est surchargée et que le propos se dilue. |
/impeccable hooks status|on|off | Affiche, active ou désactive le hook de design, qui analyse les fichiers d'interface modifiés par l'agent. | Pour vérifier que le contrôle automatique fonctionne ou le suspendre ponctuellement. |
Méthode de travail conseillée
Le contexte d'abord, l'écran ensuite. init ne demande que ce qu'il ne peut pas déduire : à qui s'adresse le produit, ce qu'il doit permettre, quelles contraintes s'appliquent. Les réponses vont dans PRODUCT.md, que toutes les commandes suivantes lisent. Si un système visuel existe déjà, lancez document pour consigner les règles de marque dans DESIGN.md et éviter que l'agent change de style en cours de route.
Plus la cible est étroite, meilleur est le résultat. Plutôt que « refais toute la page », essayez « critique les cartes de tarifs ». Les commandes récurrentes peuvent être épinglées avec /impeccable pin audit, ce qui crée le raccourci /audit ; avant de livrer, terminez par audit puis polish.
- Exécutez /impeccable init une fois par projet et relisez le PRODUCT.md produit.
- S'il existe déjà une charte, lancez /impeccable document et résumez polices, couleurs et composants dans DESIGN.md.
- Itérez section par section : /impeccable critique the pricing cards, puis bolder, quieter, distill ou typeset pour ajuster la direction.
- Avant publication, enchaînez /impeccable audit et /impeccable polish, et épinglez vos commandes habituelles avec pin.
Agents compatibles
La liste officielle est large : Claude Code, Cursor, Codex CLI, GitHub Copilot, Devin, Replit Agent, Gemini CLI, Grok Build, OpenCode, Google Antigravity, Kiro, Trae, Rovo Dev, Qoder, Mistral Vibe, Pi, Hermes Agent, DeepSeek Harness et Veto. L'installation diffère selon l'outil ; la liste complète figure dans la documentation officielle.
Claude Code, Copilot et Grok disposent de plugins ; le hook de design est pris en charge par Claude Code, Cursor, Codex, GitHub Copilot, Grok Build et Hermes Agent. Sur Codex, il faut approuver le hook du projet dans /hooks ; sur Grok Build, lancer /hooks-trust ; sur Hermes, activer le plugin.
Sans Node, vous pouvez copier le dossier du skill à la main. Pour n'utiliser que le détecteur, npx impeccable detect se passe d'agent. Le mode live fonctionne avec Vite, Next, SvelteKit, Astro, Nuxt et du HTML simple, mais ne modifie qu'une copie locale du projet.
Impeccable face à ArtCraft MCP
Les deux noms se ressemblent parce qu'ils servent à faire produire des choses à un agent, mais ils n'agissent pas au même niveau. Impeccable travaille sur le code source de l'interface ; ArtCraft MCP est le MCP/CLI officiel par application de storytold, qui pilote les Crafting Apps locales comme PhotoCraft. Ce n'est pas non plus l'API par abonnement de la communauté qui porte le nom artcraft-mcp.
| Critère | Impeccable | ArtCraft MCP |
|---|---|---|
| Sur quoi il agit | Le code front-end du dépôt : composants, JSX/TSX, CSS et structure des pages. | Les Crafting Apps locales (PhotoCraft, etc.) et leurs flux d'images et de vidéos. |
| Ce qu'il produit | Des conseils de design, des modifications de code, des rapports critique/audit et les fichiers PRODUCT.md et DESIGN.md. | Des images ou des vidéos, et des opérations automatisées dans ces applications. |
| Quand le choisir | Pour construire, évaluer ou polir une interface front-end. | Pour générer ou traiter des images et des vidéos en série et automatiser le travail dans ces apps. |
| Sont-ils complémentaires ? | Oui : Impeccable pour l'interface, ArtCraft MCP pour la production d'assets. | Oui, mais uniquement pour les médias : il ne fait pas de revue de design d'interface et ne remplace pas Impeccable. |
Guide ArtCraft MCPCrafting Apps
Périmètre et sécurité
Impeccable est un skill de design front-end et une CLI, pas une application de design ni un générateur d'images. Le mode live ne modifie qu'une copie locale ; ne l'injectez pas dans un site déployé et n'assouplissez pas la CSP de production pour le faire fonctionner.
Les hooks s'exécutent en dehors de l'approbation du modèle. Dans Claude Code, un hook de commande installé peut tourner même si vous refusez les commandes du modèle, et la première édition peut télécharger le moteur. Examinez les hooks avant une exécution sans surveillance, ou désactivez-les avec --settings '{"disableAllHooks": true}'.
La télémétrie enregistre anonymement quelles directions visuelles ont été proposées et laquelle a été choisie ; elle n'envoie ni le nom du projet, ni les fichiers, ni le code, ni PRODUCT.md. Pour la couper : npx impeccable telemetry off, DO_NOT_TRACK=1 ou "telemetry": false dans .impeccable/config.json. Côté détecteur, le code de sortie 2 signale des constats et 1 une cible impossible à analyser.
Guides associés
Questions fréquentes
Qu'est-ce qu'Impeccable, et est-ce un produit ArtCraft ?
Impeccable est un skill de design et une CLI pour agents de codage, créé par Paul Bakaus, avec 24 commandes et un détecteur de 62 règles sous licence Apache-2.0. Ce n'est pas un produit ArtCraft et il n'appartient pas à sa suite. Cette page est un guide indépendant ; les sources officielles sont impeccable.style et github.com/pbakaus/impeccable.
Comment l'installer ?
Depuis la racine du projet, exécutez npx impeccable install, puis rechargez votre outil. Lancez ensuite /impeccable init, ou $impeccable init sur Codex, pour créer PRODUCT.md. npx demande Node 18.19 ou plus, et npx impeccable update rafraîchit une installation existante ; le détail est sur impeccable.style/docs.
Quelle différence entre critique et audit ?
critique est une revue UX notée fondée sur des heuristiques d'utilisabilité : elle indique quoi corriger en premier. audit produit un rapport technique sur l'accessibilité, les performances, les thèmes, le responsive et l'intégrité de l'implémentation, avec des constats classés de P0 à P3. Le premier juge l'expérience, le second inspecte l'ingénierie, et les deux s'enchaînent souvent.
Faut-il une clé d'API ?
Non pour le détecteur : ses 62 règles sont déterministes et n'appellent aucun LLM ni aucune clé. Le skill lui-même fonctionne dans votre agent, sans clé de modèle supplémentaire. La télémétrie peut être désactivée avec npx impeccable telemetry off ou DO_NOT_TRACK=1.
Avec quels agents est-il compatible ?
Claude Code, Cursor, Codex CLI, GitHub Copilot, Devin, Replit Agent, Gemini CLI, Grok Build, OpenCode, Google Antigravity, Kiro, Trae, Rovo Dev, Qoder, Mistral Vibe, Pi, Hermes Agent, DeepSeek Harness et Veto. L'installation et la prise en charge des hooks varient selon l'outil ; la liste à jour se trouve sur impeccable.style/docs.
Impeccable ou ArtCraft MCP : que choisir ?
Tout dépend de ce que vous voulez modifier. Impeccable agit sur le code de l'interface et renvoie des conseils, des modifications et des revues. ArtCraft MCP pilote des applications locales comme PhotoCraft pour produire des images et des vidéos et automatiser leurs flux. Les deux peuvent coexister, mais ArtCraft MCP n'est pas un outil de revue de design et ne remplace pas Impeccable.
Mention d'indépendance
Impeccable est un projet open source indépendant créé par Paul Bakaus. Il n'a aucun lien avec ArtCraft, n'est pas un produit ArtCraft et ne fait partie ni de sa suite ni de ses composants officiels. Cette page est rédigée par un tiers pour un public francophone ; pour les commandes, les prérequis et les nouveautés, la référence reste le site officiel impeccable.style et le dépôt github.com/pbakaus/impeccable. ArtCraft MCP est une autre intégration officielle, centrée sur les Crafting Apps, qui répond à un besoin différent.
Sources
Every fact on this page comes from the pages below, checked on 3 November 2026.