Impeccable skill Claude : installation, commandes et test

Impeccable part d’un constat simple : les agents de code produisent des interfaces correctes mais interchangeables, faute de vocabulaire de design. Le skill leur en donne un, avec des commandes pour diriger le travail et un détecteur pour vérifier le résultat. Ce guide couvre l’installation dans Claude Code, les commandes utiles, un protocole de test et les limites.

Ce qu’est Impeccable

Impeccable est un skill unique, appelé avec la commande /impeccable suivie d’une sous-commande et d’une cible. Il apporte à l’agent des principes de design, des règles contre les défauts fréquents des interfaces générées par IA, et vingt-quatre commandes, de la conception à la finition. Un détecteur en ligne de commande complète l’ensemble.

Exemples de règles qu’il applique, selon sa documentation :

• éviter les polices surutilisées (Arial, Inter, polices système par défaut) ;
• pas de texte gris sur fond coloré ;
• pas de noir ou de gris purs, toujours légèrement teintés ;
• ne pas tout enfermer dans des cartes, encore moins des cartes dans des cartes ;
• pas d’animations à rebond ou élastiques.

Qui le publie, licence et compatibilité

Impeccable est créé par Paul Bakaus et publié sur GitHub dans le dépôt pbakaus/impeccable, sous licence Apache 2.0. Le dépôt comptait plus de 80 000 étoiles au 15 octobre 2026. Le skill ne se limite pas à Claude : son README liste plus de quinze agents de code compatibles, dont Cursor, Codex CLI et Gemini CLI.

Installer Impeccable dans Claude Code

Impeccable propose plusieurs méthodes d’installation, qui aboutissent au même skill. Le plugin est le plus simple dans Claude Code ; la commande npx impeccable install est la méthode que le README recommande. La copie manuelle depuis le dépôt sert si vous voulez figer une version précise du skill ou l’adapter à vos règles.

Méthode 1 : le plugin Claude Code

1. Ajoutez la marketplace d’Impeccable :

   /plugin marketplace add pbakaus/impeccable
   

2. Tapez /plugin, ouvrez l’onglet Discover et installez Impeccable.

3. Choisissez la portée, puis tapez /reload-plugins si Claude Code le demande.

Méthode 2 : l’installateur en ligne de commande

À la racine de votre projet, dans un terminal :

npx impeccable install

Rechargez ensuite Claude Code. Le site officiel propose aussi npx skills add pbakaus/impeccable, via la CLI de Vercel Labs.

Méthode 3 : copie depuis le dépôt

Après avoir cloné le dépôt, copiez la version Claude Code dans votre projet, ou dans vos réglages personnels pour tous vos projets :

cp -r dist/claude-code/.claude votre-projet/
cp -r dist/claude-code/.claude/* ~/.claude/

Pour vérifier l’installation, tapez /impeccable dans Claude Code : la commande doit apparaître dans l’autocomplétion.

Premier lancement : /impeccable init

Avant de demander quoi que ce soit, donnez à Impeccable le contexte de votre produit. La commande init examine le projet, ne vous pose que les questions qui manquent et enregistre les réponses dans un fichier PRODUCT.md : public visé, objectif, contraintes. Les autres commandes s’appuient ensuite sur ce fichier, d’une session à l’autre.

/impeccable init

Sur un projet qui a déjà une identité visuelle, ajoutez /impeccable document : il génère un fichier DESIGN.md qui décrit le système visuel existant, pour que l’agent le respecte. Le site officiel propose aussi /impeccable hooks on pour lancer des vérifications automatiques ; Claude Code vous demandera d’approuver ces hooks.

Les commandes utiles

Les vingt-quatre commandes couvrent tout le cycle : concevoir, critiquer, corriger, finir. Inutile de les apprendre toutes : une demi-douzaine suffit pour la plupart des projets courants, et /impeccable pin transforme vos favorites en raccourcis : /impeccable pin audit crée la commande /audit.

La syntaxe générale est /impeccable <commande> <cible>, par exemple :

/impeccable critique src/pages/index.astro
/impeccable polish le formulaire d'inscription

Vous pouvez aussi formuler la demande en langage naturel :

Utilise Impeccable pour auditer la page de tarifs : accessibilité, contraste, comportement sur mobile. Classe les problèmes par gravité et attends ma validation avant de corriger.

Avec Impeccable, fais une critique de design de la page d'accueil, puis propose trois améliorations prioritaires qui respectent le fichier DESIGN.md existant.

Le détecteur en ligne de commande

Le détecteur d’Impeccable analyse un dossier ou une adresse web et signale les défauts de design typiques des interfaces générées par IA. Il applique 59 règles déterministes, sans modèle d’IA ni clé d’API : le même code donne toujours le même résultat. C’est l’outil idéal pour mesurer un avant/après de façon objective.

npx impeccable detect src/
npx impeccable detect https://example.com
npx impeccable detect --json .

L’option --json produit une sortie exploitable dans une intégration continue, par exemple pour refuser une mise en ligne si de nouveaux défauts apparaissent.

Tester Impeccable sur votre interface

Le détecteur permet un test chiffré sur votre propre projet, plutôt qu’une impression visuelle. Mesurez l’état de départ, appliquez les commandes, puis mesurez à nouveau. Complétez avec une comparaison visuelle, car le détecteur ne juge pas l’adéquation du design à votre marque ni à votre public.

1. Lancez npx impeccable detect src/ et notez le nombre de défauts signalés.
2. Lancez /impeccable init, puis /impeccable audit sur la page choisie.
3. Appliquez les corrections avec /impeccable polish.
4. Relancez le détecteur et comparez les deux rapports.
5. Comparez aussi les captures d’écran avant et après, sur ordinateur et sur mobile.

Limites à connaître

Impeccable est puissant mais exigeant. Ses règles reflètent des choix de design tranchés, sa liste de commandes demande un temps d’apprentissage, et le projet évolue vite. Mieux vaut le savoir avant de l’adopter sur un projet en production ou de l’imposer à toute une équipe.

• Des règles tranchées : il déconseille par exemple la police Inter, que votre charte impose peut-être. Votre fichier DESIGN.md doit primer.
• Une courbe d’apprentissage : vingt-quatre commandes, dont certaines se recoupent.
• Un projet très actif : les commandes et leur comportement changent d’une version à l’autre ; relisez le changelog avant une mise à jour.
• Des hooks à approuver : les vérifications automatiques exécutent des commandes sur votre machine.
• Pas d’installation documentée dans l’application Claude : il vise les agents de code.
• Il ne remplace pas des tests avec de vrais utilisateurs.

Pour qui ?

Impeccable sert surtout ceux qui reprennent ou font évoluer une interface existante et veulent des outils de contrôle, pas seulement des consignes. Développeurs, intégrateurs et équipes produit y trouvent un cadre commun ; un débutant qui crée sa première page sera mieux servi par un skill plus simple, sans commandes à retenir.

Frontend-design ou Impeccable ?

Les deux skills visent le même problème, des interfaces génériques, avec deux approches. Frontend-design agit en arrière-plan avec un jeu de consignes, sans rien à apprendre. Impeccable demande plus d’implication mais apporte des commandes, un contexte projet persistant et une vérification mesurable. Ils sont gratuits et peuvent s’essayer l’un après l’autre.

Notre guide détaillé du skill frontend-design explique son installation et son activation. Pour la vue d’ensemble, voyez le guide des skills Claude. Et pour le référencement des pages que vous créez, le Skill SEO pour Claude Code arrive bientôt dans la boutique.