Les commandes à connaître pour Impeccable, la skill de design de Paul Bakaus pour Claude Code, Codex, Cursor… Elle donne à l’agent un vocabulaire de design commun (polish, audit, bolder…) et un détecteur automatique de 61 défauts typiques des interfaces générées par IA.

Installation

# À la racine du projet (détecte Claude Code, Codex, Cursor… et installe le hook de design)
npx impeccable install
npx impeccable update          # mettre à jour
 
# Ou via la marketplace Claude Code
/plugin marketplace add pbakaus/impeccable    # puis installer depuis /plugin

Puis, dans l’agent, une fois par projet : /impeccable init. Il pose quelques questions et écrit PRODUCT.md (public, objectif, contraintes, ton), que toutes les autres commandes utilisent.

Sur Codex : ouvrir /hooks après l’installation pour approuver le hook, et appeler la skill avec $impeccable.

Les 24 commandes

Toutes passent par /impeccable <commande> [cible], ex. /impeccable audit le header.

Démarrer et structurer

CommandeCe qu’elle fait
initRecueille le contexte produit et écrit PRODUCT.md. À lancer en premier.
shapePlanifie l’UX/UI avant d’écrire du code.
craftEnchaînement complet : cadrage puis construction avec itérations visuelles.
documentGénère un DESIGN.md à partir du code existant.
extractExtrait composants et tokens réutilisables vers le design system.

Diagnostiquer

CommandeCe qu’elle fait
critiqueRevue UX : hiérarchie, clarté, impact émotionnel.
auditContrôles techniques : accessibilité, performance, responsive.

Corriger et ajuster

CommandeCe qu’elle fait
polishDernière passe avant mise en ligne, alignement sur le design system.
bolder / quieterRend un design plus affirmé / plus sobre.
distillRetire le superflu.
layoutCorrige mise en page, espacements, rythme.
typesetCorrige polices, hiérarchie et tailles de texte.
colorizeIntroduit la couleur de façon stratégique.
animateAjoute des animations utiles.
clarifyAméliore les textes d’interface peu clairs.
hardenGestion d’erreurs, i18n, débordements de texte, cas limites.
onboardPremier lancement, états vides, parcours d’activation.
adaptAdapte à d’autres appareils.
optimizeAméliore les performances.
delight / overdriveAjoute des touches de plaisir / des effets techniques spectaculaires.

Itérer dans le navigateur

CommandeCe qu’elle fait
liveMode variantes : itérer sur des éléments directement dans le navigateur.
generateGénère des variantes d’un élément nommé.

Raccourci : /impeccable pin audit crée une commande /audit autonome.

Détecteur en ligne de commande (sans IA ni clé API)

CommandeCe qu’elle fait
npx impeccable detect src/Analyse un dossier (ou un fichier HTML).
npx impeccable detect https://example.comAnalyse une page en ligne (Chrome requis).
npx impeccable detect --json .Sortie JSON pour la CI (code 2 = défauts trouvés).
npx impeccable ignores add-value overused-font Inter --reason "Police de marque"Autorise une exception justifiée.

Workflow conseillé

  1. /impeccable init (une seule fois)
  2. /impeccable shape pour une nouvelle page, ou /impeccable audit + /impeccable critique sur l’existant
  3. Commandes ciblées selon les problèmes : layout, typeset, bolder, harden…
  4. /impeccable polish avant de livrer

Conseils d’utilisation

  • Toujours cibler : /impeccable polish le formulaire de paiement donne de meilleurs résultats qu’un polish sur toute l’application.
  • Diagnostiquer avant de corriger : audit et critique d’abord, les corrections ensuite.
  • Les défauts traqués : police Inter partout, dégradés violet-bleu, cartes imbriquées, texte gris sur fond coloré, noir pur, animations « rebond ».
  • Ajouter la détection à la CI avec detect --json, pour attraper ces défauts à chaque PR.
  • Ne pas committer les fichiers temporaires de .impeccable/ (captures, sessions) : ajouter le bloc .gitignore fourni dans le README. Garder en revanche config.json, design.json et les rapports de critique.
  • Complémentaire de GStack : gstack utilise le détecteur d’Impeccable dans ses revues de design s’il est installé.

Sources