Oil UI
Guide agent · Claude Code

Design UI avec Claude Code : installation d'Oil UI, prompts et revue visuelle

Claude Code excelle pour lire la structure d'un dépôt, découper un travail en plusieurs étapes et lancer des sous-agents. Sans cadrage design, toutefois, des prompts comme « crée une page d'atterrissage moderne » produisent encore souvent des dégradés violets, des cartes imbriquées et des badges KPI inventés. Installer Oil UI dote Claude Code d'un workflow de design structuré : analyser la catégorie, comparer des directions distinctes côte à côte et vérifier la page rendue sur de vrais viewports.

Points clés à retenir

À retenir 1

Exécutez npx skills add oil-oil/oil-ui pour installer gratuitement le skill open source dans Claude Code sans enfermer votre projet dans une bibliothèque de composants précise.

À retenir 2

Commencez votre prompt par le produit, le public, la tâche principale, le contenu réel et le viewport cible (comme 1440×900 ou 390×844) plutôt que par de vagues adjectifs de style.

À retenir 3

Pour de nouvelles pages ou refontes, demandez à Claude Code de générer un tableau comparatif HTML avec 3 à 4 directions distinctes avant d'écrire les états de production.

À retenir 4

Utilisez les sous-agents Claude Code pour une revue visuelle à l'aveugle sans contexte à 100 % et 200 % de zoom afin de corriger espacements, contrastes et hiérarchie avant livraison.

Oil UIPROMusée Qingya · Lumière & Vase

Aider les visiteurs à découvrir les dates, les salles et les pièces de Lumière & Vase, puis à réserver une visite.

Vases en céladon au bord d’un étang au crépuscule
MUSÉE QINGYAEXPOSITION D’AUTOMNE

Lumière
& Vase.

2026.11.14 — 2027.02.28Salle 02
SélectionnéCliquer pour afficher seul · taille réelle
01

Crépuscule sur l’eau

Laisser le crépuscule emplir le cadre. Garder les vases au premier plan et le titre serif dans un coin calme.

Musée QingyaLumière & Vase · Automne

JOURNALMATINAL

Céladon et lin sous une lumière filtrée par les saules

Lumière sur l’eau.
Lumière sur l’argile.

Une exposition dédiée aux vases du quotidien et à la lumière naturelle.

11.14 — 02.28Salle 02
SélectionnéCliquer pour afficher seul · taille réelle
02

Journal du matin

Ouvrir un journal d’exposition : une grille de presse réunit lumière du matin, vases et informations de visite.

Musée Qingya

Brume du matin.
Lumière calme.

Service à thé en céladon près d’une fenêtre embuée
11.14 — 02.28Salle 02
SélectionnéCliquer pour afficher seul · taille réelle
03

Fenêtre embuée

Inscrire la peinture dans une fenêtre ouverte sur papier. Le céladon et l’eau pâle trouvent de l’air.

Installer gratuitement le Skill open source Oil UI pour Claude Code
npx skills add oil-oil/oil-ui

Ou envoyez ceci directement à Claude Code : « Installe ce skill pour moi : exécute npx skills add oil-oil/oil-ui ».

Pourquoi Claude Code gagne à utiliser un Skill de design dédié

Lorsque vous demandez à Claude Code une « interface SaaS propre et moderne » sans autre méthode, le modèle se rabat sur les moyennes statistiques de ses données d'entraînement : un titre centré surmonté d'une pastille, trois cartes de même largeur dessous, et des mini-courbes décoratives ou des compteurs « +24 % » dans un coin. Le code compile, mais l'interface semble interchangeable avec n'importe quelle autre démo d'IA.

Oil UI change l'ordre du travail. Au lieu de passer directement du prompt au balisage final, Claude Code étudie ce qui rend la catégorie de produit lisible, réunit des directions visuelles distinctes sur un même tableau comparatif et inspecte le rendu réel dans le navigateur avant de considérer la tâche terminée.

Prompt en un coup vs Claude Code avec Oil UI Skill
ÉtapePrompt direct dans Claude CodeWorkflow Claude Code + Oil UI
Point de départRevient par défaut à des grilles de cartes SaaS génériques et des palettes passe-partoutPart de la catégorie produit, de la tâche utilisateur et du contenu réel
Choix de directionUn seul résultat ; oblige à tout reprompter de zéro si ça ne convient pasPage de comparaison intégrée en 1440px ou 390px
Données et textesInvente souvent de faux pourcentages et des badges de remplissageConstruit la hiérarchie autour de champs métier réels et supprime le bruit
Contrôle qualitéS'arrête dès que le code compileLance un sous-agent à l'aveugle pour critiquer la page entière et les recadrages à 200 %

Configuration en trois étapes

Vous pouvez installer Oil UI globalement pour votre compte utilisateur ou localement dans un dépôt afin que toute l'équipe partage le même workflow.

  1. Lancer l'installateur de skill et sélectionner Claude Code

    Exécutez la commande ci-dessous dans votre terminal et suivez l'invite interactive pour choisir Claude Code et la portée d'installation souhaitée.

    npx skills add oil-oil/oil-ui
  2. Vérifier qu'un navigateur local peut rendre et capturer les pages

    La revue visuelle repose sur de vraies captures plutôt que sur des suppositions à la lecture du code source. Assurez-vous que Playwright ou votre outil d'automatisation local peut ouvrir le serveur de dev en 1440×900 (bureau) et 390×844 (mobile).

  3. Passer à Oil UI Pro lorsque vous avez besoin du workflow complet

    Si vous avez acheté Oil UI Pro, installez-le via la CLI. Une fois Pro installé, vous n'avez plus besoin de garder le skill open source en parallèle.

    npx github:oil-oil/oil-cli install oil-ui-pro

Comment rédiger des prompts UI pertinents pour Claude Code

Observez les réalisations créées avec Claude dans la galerie — comme Margins (liseuse sur tablette par Claude Opus 5.5), Echo (assistant vocal par Claude Opus 5.5), Pickup (application VTC par Claude Sonnet 5.5) et Pinch Checkout (module de paiement par Claude Sonnet 5.5). Chaque prompt indique qui est l'utilisateur, quelle interaction porte la page et quels états doivent fonctionner.

Énoncer l'utilisateur et la tâche en langage clair
Au lieu de demander une « app de mobilité élégante », précisez « un parcours VTC en 390×844 couvrant la confirmation du point de prise en charge, l'arrivée du chauffeur en direct et le changement de destination en cours de trajet ».
Nommer l'interaction centrale
Indiquez à Claude Code quel contrôle ou quelle transition compte le plus : le calcul en direct du prix lors de l'application d'un code promo, le tiroir d'annotations dans un lecteur de longs articles ou la réponse de la forme d'onde dans un assistant vocal.
Définir les viewports et les états concrets
Listez les dimensions exactes de viewport et les trois ou quatre états à rendre afin que l'agent puisse vérifier chaque état dans un vrai navigateur.
Modèle de prompt UI réutilisable pour Claude Code
Utilise Oil UI pour concevoir l'interface de [type de produit, ex. : un module de paiement pour une librairie indépendante].
- Public et tâche principale : [ex. : des lecteurs qui vérifient leur panier, choisissent entre retrait en boutique et livraison, appliquent un code de réduction et finalisent le paiement]
- Interaction centrale et états : Concentre-toi sur [interaction principale]. Couvre [État 1 : formulaire par défaut], [État 2 : recalcul en direct de la livraison et de la remise], et [État 3 : erreur de validation de carte en ligne et récupération].
- Contraintes : Conserve notre stack technique actuelle. Cible 1440×900 sur bureau et un affichage responsive jusqu'à 390px de large.
Propose d'abord des directions de design distinctes pour les comparer avant d'affiner la direction retenue.

Remplacez les champs entre crochets par les détails réels de votre domaine et collez dans Claude Code.

Mener des revues par sous-agent à l'aveugle sur de vraies captures

Un agent qui vient d'écrire 600 lignes de CSS remarque rarement que deux libellés se chevauchent ou qu'un texte secondaire manque de contraste. Oil UI résout ce biais en demandant à l'agent principal de capturer la page réelle et de confier ces images à un nouveau sous-agent Claude Code n'ayant aucune connaissance de l'implémentation.

Le relecteur inspecte les captures pleine page à 100 %, les recadrages à 200 % sur les contrôles denses, ainsi que des images floutées qui révèlent les mises en page déséquilibrées vers le haut ou monotones. L'agent principal corrige les défauts signalés avant de vous présenter le résultat.

Exemples fonctionnels et prompts de la galerie

Parcourir la collection →
Oil UI Pro

Quand passer du skill gratuit à Oil UI Pro

Le skill gratuit amène une toute nouvelle page de la feuille blanche à un design affirmé. Passez à Oil UI Pro ($19.99 en paiement unique) lorsque vous utilisez Claude Code pour rénover des applications en production, construire des espaces de travail bureau denses ou exécuter jusqu'à 3 cycles optionnels de finition à l'aveugle avec comptage des clics.

Découvrir Oil UI Pro →
Copier le prompt d'installation Pro
npx github:oil-oil/oil-cli install oil-ui-pro

Questions fréquentes

Oil UI enferme-t-il Claude Code dans React, Tailwind ou une bibliothèque UI précise ?

Non. Oil UI fournit des méthodes de design, des critères de mise en page et des étapes de vérification visuelle. Claude Code écrit le balisage et les styles dans votre stack existante, qu'il s'agisse de Next.js, Vue, Svelte, HTML/CSS pur ou d'un design system interne.

Comment Claude Opus et Claude Sonnet se comparent-ils avec Oil UI ?

Opus prend généralement de meilleures décisions sur l'échelle typographique, le rythme et la hiérarchie éditoriale sur des pages entières. Sonnet est plus rapide et convient très bien aux modules ciblés, à la complétion d'états et au déploiement d'une direction déjà établie.

Puis-je fournir une capture de référence à Claude Code pour la reproduire ou l'adapter ?

Oui. Indiquez le chemin de l'image et précisez si vous voulez une reproduction fidèle au pixel près ou simplement emprunter son atmosphère typographique et ses espacements pour votre propre contenu produit. Oil UI intègre des workflows dédiés aux deux cas.

Comment savoir si Claude Code applique bien Oil UI ?

Incluez « Utilise Oil UI » dans votre prompt. Au lieu de générer aussitôt un gabarit sans style, Claude Code va cadrer la tâche utilisateur, proposer des directions visuelles distinctes ou ouvrir un tableau comparatif, puis inspecter des captures rendues avant de terminer.

Guides associés

Guide de design UI avec Codex ↗Comparaison de directions côte à côte ↗Revue à l'aveugle sur écran réel ↗