Comment utiliser la skill Impeccable ?

La promesse

Ce que fait vraiment Impeccable, et ce qu’il ne fait pas

Concrètement, Impeccable est une skill unique pour les outils de code assistés par IA : Claude Code, Cursor, Codex, Gemini CLI, Copilot. Une fois posée, elle débloque vingt-trois commandes qu’on appelle dans le chat de son agent. Elle est gratuite et son code est public sur GitHub, ce qui explique en partie son adoption fulgurante.

Mais sa thèse est plus intéressante que sa liste de fonctions. Si toutes les UI générées finissent par se ressembler, dit Impeccable, c’est que les modèles n’ont pas de mots pour dire ce qui doit ressortir et ce qui doit s’effacer. Faute de vocabulaire, ils retombent sur les mêmes valeurs par défaut. La skill ne réécrit donc pas le talent du modèle : elle lui prête un lexique de designer, et elle vous donne les mêmes commandes, pour que vous arrêtiez tous les deux de deviner.

Une skill ne rend pas le modèle meilleur designer. Elle dégage seulement les réflexes qui font ressembler sa sortie à du généré.

Cette nuance n’est pas un détail marketing. Elle déplace la valeur. Un générateur « magique » vous installerait dans le siège passager. Impeccable fait l’inverse : il vous remet au volant et vous tend un tableau de bord. Le résultat dépend toujours de la personne qui dit « plus sobre ici » ou « cette animation ne sert à rien ». Et pour le dire, il faut savoir ce que ces mots veulent dire.

On touche là à quelque chose qui dépasse l’outil. Le design n’a jamais été ce qui se voit, mais ce qui se décide. Impeccable ne change pas la règle : il rend juste la décision plus rapide à exprimer.

Prise en main

Installer et donner le contexte : l’étape qu’on ne saute pas

L’installation tient en une ligne, à lancer depuis la racine du projet :

npx impeccable install

La commande détecte votre outil et écrit les fichiers de skill au bon endroit (.claude/skills/, .cursor/skills/, selon le cas). Sur Claude Code, il existe aussi un chemin dédié via le plugin : /plugin marketplace add pbakaus/impeccable, puis installation depuis le menu /plugin. Rechargez l’outil, tapez /, et /impeccable doit apparaître dans l’autocomplétion.

Vient ensuite l’étape que tout le monde a envie de zapper, et qu’il ne faut surtout pas zapper :

/impeccable init

Pourquoi c’est l’étape capitale ? Parce que sans contexte, Impeccable retombe sur des patterns de SaaS génériques, exactement le slop qu’on voulait fuir. init lance un court entretien et écrit PRODUCT.md à la racine du projet, le fichier qui porte la stratégie : pour qui, quelle voix de marque, quelles contre-références (ce que le produit ne doit surtout pas évoquer). À la fin de l’entretien, il propose de lancer document, qui inspecte votre code et écrit DESIGN.md, le pendant visuel : couleurs et typographies, jusqu’à l’inventaire des composants, au format DESIGN.md de Google Stitch, donc lisible par d’autres outils. Une fois les deux fichiers en place, chaque commande les relit avant de produire quoi que ce soit.

Une question structure tout le reste : votre surface est-elle brand ou product ? Une landing page et un dashboard ne jouent pas avec les mêmes règles. En mode brand, le design est le livrable : une typo qui s’affirme et un héros en pleine image. En mode product, le design sert la tâche : densité maîtrisée et composants réutilisables. Impeccable propose un registre en analysant votre code, puis vous demande de le confirmer, et chaque commande s’y adapte ensuite.

Le piège de l’entretien, c’est de répondre en adjectifs. « Moderne et épuré » ne dit rien : tout le monde le revendique. La doc invite à nommer des choses réelles, un public précis plutôt que « les utilisateurs », des références qui existent plutôt que des qualificatifs. C’est un travail de cadrage que tout designer reconnaîtra : il ressemble furieusement à un début de brief.

Le vocabulaire

Les 23 commandes : un vocabulaire pour diriger

Une fois le contexte posé, on travaille en une seule grammaire : /impeccable <commande> <cible>. Par exemple /impeccable polish la page de tarifs, ou /impeccable audit le tunnel de paiement. Tapez /impeccable seul pour voir la liste entière.

Plutôt que de retenir les vingt-trois noms, mieux vaut les regrouper par moment d’usage :

• Démarrer. craft enchaîne la mise en forme puis la construction d’une fonctionnalité entière, et shape pose une direction de marque.
• Ajuster. Quand la modification a un nom, on appelle la discipline directement : typeset pour la typo, colorize pour la couleur, layout pour la mise en page, animate pour le mouvement. Pour pousser un design trop sage, bolder ; pour calmer une page qui crie, quieter.
• Fiabiliser avant d’expédier. polish corrige par petites retouches ciblées (alignement, espacement, états au survol…) sans tout réécrire, critique lance une revue de design notée, et audit passe l’implémentation au crible avant la mise en ligne (accessibilité, performance, responsive…).
• Entretenir. document met à jour le DESIGN.md quand le système a bougé.

Quand le défaut est plus facile à montrer qu’à nommer, il y a le Live Mode (encore en bêta) : /impeccable live pose un sélecteur sur votre serveur de dev. Vous pointez un élément, vous écrivez ou dessinez ce que vous voulez, et la skill propose trois variantes de qualité production. Vous en acceptez une, elle est écrite directement dans le fichier source, comme une modification ordinaire que vous pouvez relire et annuler.

Le cas Neo Mirai, documenté sur le site, montre la boucle complète sur un projet de marque fictif. Un agent a d’abord généré une maquette haute fidélité par image, puis craft a transformé cette image en code livré, avant les ajustements responsive et le polissage en navigateur. Ce qui frappe dans cet exemple, c’est que l’outil ne part jamais d’un prompt vague : il code vers une cible concrète, validée à l’œil.

Voilà le point que je trouve le plus juste. bolder, quieter : ces mots ne servent à rien si vous ne savez pas déjà reconnaître qu’une interface est trop sage ou trop chargée. Le vocabulaire accélère la décision, il ne la prend pas. Impeccable est un partenaire qui parle votre langue, à condition que vous parliez la sienne.

Les écueils

Les pièges qui ruinent le résultat

Le tâtonnement fait partie du jeu, et la doc d’Impeccable est elle-même honnête sur ce qui rate. Quatre erreurs reviennent.

La première : faire tourner Impeccable en même temps qu’une autre skill de design, comme la frontend-design d’Anthropic. Impeccable se présente comme un remplacement : son propre sous-titre se définit comme un « upgrade » de la skill d’Anthropic. Mieux vaut donc en activer une seule, plutôt que d’empiler deux skills de design concurrentes. La deuxième : sauter init. Les commandes fonctionnent sans contexte, mais elles retombent sur le générique, et tout l’intérêt s’évapore. La doc le signale d’ailleurs comme le premier problème courant : « aucun contexte de design trouvé ». La troisième : épingler toutes les commandes avec pin, ce qui re-encombre le menu que la consolidation avait nettoyé. On épingle les deux ou trois qu’on utilise tous les jours, pas plus.

La quatrième est la plus subtile. Impeccable n’est pas un correcteur automatique qui valide ou rejette : c’est un partenaire qui a un avis. Si vous lui opposez une raison, il travaille avec vous. Si vous ignorez son opinion sans argument, la qualité baisse au lieu de monter. Le traiter comme un linter, c’est passer à côté de ce qu’il est.

Il reste un outil à part, beaucoup plus terre à terre. Plutôt que de juger le goût, il traque une liste fixe de quarante-quatre tics connus, ceux qui reviennent en boucle dans les designs générés. Il ne mobilise aucune IA et ne donne aucun avis : il fait tourner une vérification automatique, toujours identique. On peut la lancer sur un dossier de code (la commande npx impeccable detect s’en charge) pour qu’elle pointe ces tics avant la mise en ligne, et on peut même brancher ce contrôle pour qu’il bloque une page tant qu’elle n’est pas nettoyée. La même vérification existe aussi en extension Chrome, et on peut la dégainer sur n’importe quelle page déjà publiée, y compris celle d’un concurrent. Elle relève de la détection mécanique, pas du jugement de designer.

Conclusion

On installe souvent Impeccable en espérant qu’il fasse le design à notre place. On repart en comprenant l’inverse : c’est l’outil anti-slop qui réclame le plus un regard de designer. Il efface les réflexes qui sentent le généré et il accélère l’aller-retour entre l’intention et l’écran. Mais l’intention, le « pourquoi ce choix plutôt qu’un autre », reste à vous. La skill range les outils ; elle ne décide pas à quoi ils servent.

✦ Reste une question que cet outil pose en creux, et qui dépasse Impeccable : à mesure que l’IA gagne le vocabulaire du design, qu’est-ce qui distingue encore celui qui sait nommer une décision de celui qui sait la prendre ? Le meilleur moyen de le sentir, c’est d’ouvrir un de vos projets et de lancer un /impeccable polish sur une page que vous croyiez finie.

FAQ

Sources

• Impeccable, site officiel, page d’accueil (impeccable.style) : « 1 skill, 23 commands », la section « Desloppification », le détecteur à 44 règles, le Live Mode et le cas Neo Mirai. Consulté en juin 2026.
• Impeccable, tutoriel « Getting started » (impeccable.style/tutorials/getting-started) : installation, déroulé de init, écriture de PRODUCT.md, proposition de document pour DESIGN.md, registre brand/product. Consulté en juin 2026.
• Paul Bakaus, créateur d’Impeccable, dépôt public (github.com/pbakaus/impeccable).
• Google Stitch, format DESIGN.md, référencé par Impeccable pour la portabilité du système visuel (stitch.withgoogle.com).