mirror of
https://github.com/nextlevelbuilder/ui-ux-pro-max-skill.git
synced 2026-11-19 00:30:30 +00:00
Map products had no matching product type: "GIS dashboard web map" routed to Analytics Dashboard, "geospatial analytics platform" to Podcast Platform, and "satellite imagery earth observation viewer" returned nothing, so --design-system fell back to a landing-page pattern for a map tool. Add two product types with matching rows in products.csv, colors.csv and ui-reasoning.csv (No 193-194): - GIS / Web Map Dashboard: map-first layout with layer panel and linked list, muted basemap, one UI accent, colorblind-safe data ramps. - Earth Observation / Satellite Imagery Viewer: imagery-first layout, neutral dark-grey chrome so imagery colors read true, date timeline, before/after compare, perceptual index ramps. Reasoning rows require map attribution, a legend and a text alternative, and list rainbow ramps, hidden attribution, glass panels over the map and raw-count choropleths as anti-patterns, in line with the Maps rows in ux-guidelines.csv. Color tokens pass the existing contrast contract. Provenance records cover both reasoning rows. The product, palette and reasoning sets grow from 192 to 194, so the row-count contract in validate_data.py, test_data_contracts.py and the published counts move to 194. Neighbouring product queries (analytics dashboard, delivery tracking, public transit, drone fleet, podcast platform) keep their product type; relevance metrics are unchanged. Co-authored-by: Khanhle19 <201531944+Khanhle19@users.noreply.github.com>
762 lines
46 KiB
Markdown
762 lines
46 KiB
Markdown
# [UI UX Pro Max](https://uupm.cc)
|
|
|
|
<p align="center">
|
|
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.az.md">🇦🇿 Azərbaycanca</a> |
|
|
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.id.md">🇮🇩 Bahasa Indonesia</a> |
|
|
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.ja.md">🇯🇵 日本語</a> |
|
|
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.ko.md">🇰🇷 한국어</a> |
|
|
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.vi.md">🇻🇳 Tiếng Việt</a> |
|
|
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.zh.md">🇨🇳 简体中文</a> |
|
|
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.md">🇺🇸 English</a> |
|
|
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.fr.md">🇫🇷 Français</a> |
|
|
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/README.fa.md">🇮🇷 فارسی</a> |
|
|
</p>
|
|
|
|
<p align="center">
|
|
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/releases"><img src="https://img.shields.io/github/v/release/nextlevelbuilder/ui-ux-pro-max-skill?style=for-the-badge&color=blue" alt="Version GitHub"></a>
|
|
<img src="https://img.shields.io/badge/reasoning_rules-194-green?style=for-the-badge" alt="194 règles de raisonnement">
|
|
<img src="https://img.shields.io/badge/UI_styles-80_searchable-purple?style=for-the-badge" alt="80 styles d'interface consultables">
|
|
<img src="https://img.shields.io/badge/python-3.x-yellow?style=for-the-badge&logo=python&logoColor=white" alt="Python 3.x">
|
|
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/LICENSE"><img src="https://img.shields.io/github/license/nextlevelbuilder/ui-ux-pro-max-skill?style=for-the-badge&color=green" alt="Licence"></a>
|
|
</p>
|
|
|
|
<p align="center">
|
|
<a href="https://www.npmjs.com/package/ui-ux-pro-max-cli"><img src="https://img.shields.io/npm/v/ui-ux-pro-max-cli?style=flat-square&logo=npm&label=CLI" alt="npm"></a>
|
|
<a href="https://www.npmjs.com/package/ui-ux-pro-max-cli"><img src="https://img.shields.io/npm/dm/ui-ux-pro-max-cli?style=flat-square&label=downloads" alt="téléchargements npm"></a>
|
|
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/stargazers"><img src="https://img.shields.io/github/stars/nextlevelbuilder/ui-ux-pro-max-skill?style=flat-square&logo=github" alt="Étoiles GitHub"></a>
|
|
<a href="https://paypal.me/uiuxpromax"><img src="https://img.shields.io/badge/PayPal-Support%20Development-00457C?style=flat-square&logo=paypal&logoColor=white" alt="PayPal"></a>
|
|
</p>
|
|
|
|
Un skill d'IA qui apporte une intelligence de design pour créer des interfaces UI/UX professionnelles sur de multiples plateformes et frameworks.
|
|
|
|
<p align="center">
|
|
<a href="https://uupm.cc">
|
|
<img src="screenshots/website.png" alt="UI UX Pro Max" width="800">
|
|
</a>
|
|
</p>
|
|
|
|
<p align="center">
|
|
<b>Si ce projet vous est utile, pensez à le soutenir :</b><br><br>
|
|
<a href="https://paypal.me/uiuxpromax"><img src="https://img.shields.io/badge/PayPal-Donate-00457C?style=for-the-badge&logo=paypal&logoColor=white" alt="Faire un don via PayPal"></a>
|
|
</p>
|
|
|
|
<p align="center">
|
|
<i>Autres projets</i><br>
|
|
<a href="https://nextlevelbuilder.io">NextLevelBuilder.io</a> | <a href="https://goclaw.sh">GoClaw.sh</a> | <a href="https://agentkit.best">AgentKit.best</a> | <a href="https://tose.sh">TOSE.sh</a>
|
|
</p>
|
|
|
|
---
|
|
|
|
<p align="center">
|
|
<span>Découvrez notre nouveau skill :</span>
|
|
<br/>
|
|
<a href="https://github.com/viettranx/3dviz-pro-max" target="_blank">
|
|
<picture>
|
|
<source media="(prefers-color-scheme: dark)" srcset="https://cdn.nextlevelbuilder.io/skills/3dviz/wordmark-dark.svg">
|
|
<img src="https://cdn.nextlevelbuilder.io/skills/3dviz/wordmark.svg" alt="3Dviz Pro Max" height="56">
|
|
</picture>
|
|
</a>
|
|
</p>
|
|
|
|
<p align="center"><b>Transformez une idée en une scène 3D qui mérite d'être explorée.</b></p>
|
|
|
|
<p align="center">
|
|
<img src="https://cdn.nextlevelbuilder.io/skills/3dviz/harness-village.gif" width="800" alt="Harness Village : un village fantastique avec navigation de caméra et créatures animées">
|
|
</p>
|
|
|
|
<p align="center">
|
|
<sub><b>Source d'inspiration visuelle, pas un benchmark.</b> Projet fourni par l'auteur et enregistré <i>avant</i> l'existence de ce skill ; son interface contient du vietnamien. Il s'agit d'images d'archives, et non d'une démo en anglais ni d'un test d'exécution du skill — voir la <a href="https://github.com/viettranx/3dviz-pro-max/blob/main/docs/demos/README.md">provenance des médias</a>.</sub>
|
|
</p>
|
|
|
|
<p align="center">
|
|
🤌 Site web : <a href="https://3dviz.dev/" target="_blank">https://3dviz.dev/</a>
|
|
</p>
|
|
|
|
---
|
|
|
|
## Nouveautés de la v2.0
|
|
|
|
### Génération intelligente de design system
|
|
|
|
La fonctionnalité phare de la v2.0 est le **Générateur de design system** : un moteur de raisonnement propulsé par l'IA qui analyse les besoins de votre projet et génère en quelques secondes un design system complet et sur mesure.
|
|
|
|
```
|
|
+----------------------------------------------------------------------------------------+
|
|
| CIBLE : Serenity Spa - DESIGN SYSTEM RECOMMANDÉ |
|
|
+----------------------------------------------------------------------------------------+
|
|
| |
|
|
| PATTERN : Hero centré + preuve sociale |
|
|
| Conversion : axée sur l'émotion, avec éléments de confiance |
|
|
| CTA : au-dessus de la ligne de flottaison, répété après les témoignages |
|
|
| Sections : |
|
|
| 1. Hero |
|
|
| 2. Services |
|
|
| 3. Témoignages |
|
|
| 4. Réservation |
|
|
| 5. Contact |
|
|
| |
|
|
| STYLE : Soft UI Evolution |
|
|
| Mots-clés : ombres douces, profondeur subtile, apaisant, premium, formes organiques|
|
|
| Idéal pour : bien-être, beauté, marques lifestyle, services premium |
|
|
| Performance : cost:low | Accessibilité : risk:conditional ; vérifier les exigences |
|
|
| |
|
|
| COULEURS : |
|
|
| Primaire : #E8B4B8 (rose doux) |
|
|
| Secondaire : #A8D5BA (vert sauge) |
|
|
| CTA : #D4AF37 (or) |
|
|
| Arrière-plan : #FFF5F5 (blanc chaud) |
|
|
| Texte : #2D3436 (anthracite) |
|
|
| Notes : palette apaisante avec touches dorées pour un rendu luxueux |
|
|
| |
|
|
| TYPOGRAPHIE : Cormorant Garamond / Montserrat |
|
|
| Ambiance : élégante, apaisante, sophistiquée |
|
|
| Idéal pour : marques de luxe, bien-être, beauté, éditorial |
|
|
| Google Fonts : https://fonts.google.com/share?selection.family=... |
|
|
| |
|
|
| EFFETS CLÉS : |
|
|
| Ombres douces + transitions adaptées au contexte + survols délicats |
|
|
| |
|
|
| À ÉVITER (anti-patterns) : |
|
|
| Néons vifs + animations brusques + mode sombre + dégradés IA violet/rose |
|
|
| |
|
|
| CHECK-LIST AVANT LIVRAISON : |
|
|
| [ ] Pas d'emojis comme icônes (utiliser des SVG : Heroicons/Lucide) |
|
|
| [ ] cursor-pointer sur tous les éléments cliquables |
|
|
| [ ] Timing des interactions selon plateforme, composant et préférences utilisateur |
|
|
| [ ] Mode clair : contraste du texte d'au moins 4.5:1 |
|
|
| [ ] États de focus visibles pour la navigation au clavier |
|
|
| [ ] prefers-reduced-motion respecté |
|
|
| [ ] Textes, chips et badges se réorganisent sans troncature ni libellé cassé |
|
|
| [ ] Responsive : 375px, 768px, 1024px, 1440px |
|
|
| |
|
|
+----------------------------------------------------------------------------------------+
|
|
```
|
|
|
|
### Comment fonctionne la génération de design system
|
|
|
|
```
|
|
┌─────────────────────────────────────────────────────────────────┐
|
|
│ 1. DEMANDE DE L'UTILISATEUR │
|
|
│ « Crée une landing page pour mon spa de beauté » │
|
|
└─────────────────────────────────────────────────────────────────┘
|
|
│
|
|
▼
|
|
┌─────────────────────────────────────────────────────────────────┐
|
|
│ 2. RECHERCHE MULTI-DOMAINES (5 recherches en parallèle) │
|
|
│ • Correspondance du type de produit (194 catégories) │
|
|
│ • Recommandations de style (80 consultables ; 51 actifs) │
|
|
│ • Sélection de palette de couleurs (194 palettes) │
|
|
│ • Patterns de landing page (34 patterns) │
|
|
│ • Associations typographiques (74 combinaisons de polices) │
|
|
└─────────────────────────────────────────────────────────────────┘
|
|
│
|
|
▼
|
|
┌─────────────────────────────────────────────────────────────────┐
|
|
│ 3. MOTEUR DE RAISONNEMENT │
|
|
│ • Associer produit → règles de catégorie UI │
|
|
│ • Appliquer les priorités de style (classement BM25) │
|
|
│ • Filtrer les anti-patterns propres au secteur │
|
|
│ • Traiter les règles de décision (conditions JSON) │
|
|
└─────────────────────────────────────────────────────────────────┘
|
|
│
|
|
▼
|
|
┌─────────────────────────────────────────────────────────────────┐
|
|
│ 4. DESIGN SYSTEM COMPLET EN SORTIE │
|
|
│ Pattern + Style + Couleurs + Typographie + Effets │
|
|
│ + Anti-patterns à éviter + Check-list avant livraison │
|
|
└─────────────────────────────────────────────────────────────────┘
|
|
```
|
|
|
|
### 194 règles de raisonnement spécifiques à chaque secteur
|
|
|
|
Le moteur de raisonnement comprend des règles spécialisées pour :
|
|
|
|
| Catégorie | Exemples |
|
|
|----------|----------|
|
|
| **Tech & SaaS** | SaaS, Micro SaaS, service B2B, outil de développement / IDE, plateforme IA/chatbot, plateforme de cybersécurité |
|
|
| **Finance** | Fintech/crypto, banque, assurance, suivi des finances personnelles, outil de factures et de facturation |
|
|
| **Santé** | Clinique médicale, pharmacie, dentaire, vétérinaire, santé mentale, rappel de médicaments |
|
|
| **E-commerce** | Généraliste, luxe, marketplace (P2P), box par abonnement, livraison de repas |
|
|
| **Services** | Beauté/spa, restaurant, hôtel, juridique, services à domicile, réservation et prise de rendez-vous |
|
|
| **Créatif** | Portfolio, agence, photographie, jeux vidéo, streaming musical, éditeur photo/vidéo |
|
|
| **Lifestyle** | Suivi d'habitudes, recettes et cuisine, méditation, météo, journal intime, suivi de l'humeur |
|
|
| **Technologies émergentes** | Web3/NFT, informatique spatiale, informatique quantique, flotte de drones autonomes |
|
|
|
|
Chaque règle comprend :
|
|
- **Pattern recommandé** - Structure de la landing page
|
|
- **Priorité de style** - Styles d'interface les plus adaptés
|
|
- **Ambiance colorimétrique** - Palettes adaptées au secteur
|
|
- **Ambiance typographique** - Personnalité des polices
|
|
- **Effets clés** - Animations et interactions
|
|
- **Anti-patterns** - Ce qu'il ne faut PAS faire (p. ex. « dégradés IA violet/rose » pour une banque)
|
|
|
|
## Fonctionnalités
|
|
|
|
- **80 styles d'interface consultables (51 actifs)** - Glassmorphism, Claymorphism, Minimalisme, Brutalisme, Neumorphism, Bento Grid, mode sombre, AI-Native UI, et bien d'autres
|
|
- **194 palettes de couleurs** - Palettes sectorielles alignées 1:1 sur les 194 types de produits
|
|
- **74 associations de polices** - Combinaisons typographiques sélectionnées, avec imports Google Fonts
|
|
- **25 types de graphiques** - Recommandations pour tableaux de bord et analytique
|
|
- **22 stacks techniques** - React, Next.js, Astro, Vue, Nuxt.js, Nuxt UI, Svelte, SwiftUI, React Native, Flutter, HTML+Tailwind, shadcn/ui, Jetpack Compose, Angular, Laravel, Three.js, JavaFX, WPF, WinUI 3, UWP, Avalonia, Uno Platform
|
|
- **130 recommandations UX** - Bonnes pratiques, anti-patterns, règles d'accessibilité, mise en page de texte robuste, libellés compacts et interactions annulables. Voir [Raccourcis Entrée compatibles IME](docs/ime-composition.md).
|
|
- **194 règles de raisonnement** - Génération de design system spécifique à chaque secteur (NOUVEAU en v2.0)
|
|
|
|
### Texte robuste et interface compacte
|
|
|
|
Les recommandations couvrent désormais les défaillances courantes en production concernant les titres, les chaînes longues, les chips, les badges et les micro-interactions interrompues :
|
|
|
|
- L'équilibrage du retour à la ligne des titres est une amélioration progressive, et non une garantie qu'un mot précis restera sur la dernière ligne. Les designs doivent fonctionner avec un retour à la ligne naturel, quels que soient la largeur, la police et la langue.
|
|
- Le texte essentiel doit se réorganiser sans être tronqué sur les écrans étroits, avec le zoom du navigateur, l'agrandissement du texte et les espacements personnalisés par l'utilisateur. Les URL et identifiants longs peuvent passer à la ligne en toute sécurité.
|
|
- Les collections de chips et de tags doivent passer à la ligne ou utiliser un bouton `+n` fonctionnel pour afficher le reste. Un libellé compact doit rester entier lorsque c'est possible ; une troncature inévitable nécessite un moyen accessible d'afficher la valeur complète, au clavier, à la souris et au toucher.
|
|
- Le sens d'un badge ne peut pas reposer uniquement sur la couleur. Les chips interactives nécessitent une sémantique native, un focus visible et un état exposé programmatiquement ; les compteurs dynamiques ont besoin d'un contexte explicite.
|
|
- Des interactions rapides peuvent interrompre une animation, mais l'état sémantique final, le focus et le contenu doivent rester corrects. Le timing est choisi selon la plateforme et le composant, en respectant les préférences de réduction des animations.
|
|
|
|
### Taxonomie des styles
|
|
|
|
Le catalogue contient **80 styles consultables**, reposant sur des identifiants stables et des alias :
|
|
|
|
| Statut | Nombre | Comportement de recherche |
|
|
|--------|------:|-----------------|
|
|
| Actif | 51 | Inclus dans les recommandations normales et affiché par défaut dans la galerie |
|
|
| Complémentaire | 29 | Renvoyé en cas de demande exacte ou explicite de variante/système ; disponible via le filtre de statut de la galerie |
|
|
| Obsolète | 9 | Exclu du classement normal ; les anciens noms redirigent vers un style canonique ou un pattern de landing page |
|
|
|
|
L'ensemble actif couvre 43 familles visuelles générales, 2 styles propres au mobile, 4 systèmes de design officiels de plateformes, 1 matériau de plateforme et 1 style analytique de base. Les systèmes officiels actuels comprennent Fluent 2, Shopify Polaris, Adobe Spectrum et Apple Native Experience ; Liquid Glass est défini comme un matériau de la plateforme Apple, Material 3 Expressive reste une variante mobile de Material, et Spectrum 2 est complémentaire. Les structures de landing page sont regroupées dans un jeu de données distinct de 34 patterns, plutôt que d'entrer en concurrence avec les styles visuels dans le classement BM25.
|
|
|
|
Voir [`styles.csv`](src/ui-ux-pro-max/data/styles.csv) pour la taxonomie complète et les métadonnées de provenance.
|
|
|
|
## 💎 Comparaison des versions Basic et Premium
|
|
|
|
De nombreux utilisateurs nous interrogent sur les différences entre la version open source et la version premium. Voici un comparatif détaillé pour vous aider à choisir celle qui correspond à votre façon de travailler.
|
|
|
|
### 🟢 Version Basic (ce dépôt)
|
|
* **Entièrement open source :** Idéale pour les développeurs indépendants, les amateurs et les projets classiques.
|
|
* **Intelligence UI/UX de base :** Accès complet aux 80 styles d'interface consultables (51 actifs), aux 194 types de produits, aux palettes de couleurs et aux associations de polices sélectionnées.
|
|
* **Recommandations intelligentes :** Moteur de recherche BM25 intégré pour des correspondances de design très précises.
|
|
* **Prise en charge multiplateforme :** Recommandations spécifiques à 22 frameworks majeurs (React, Vue, Tailwind, iOS, Android, etc.).
|
|
* **Génération de design system :** Générez instantanément des règles d'interface, des patterns et une logique sur mesure via la CLI.
|
|
|
|
### 🟡 Version Premium
|
|
* **Compétences étendues en design de marque :** Va au-delà de l'UI/UX avec la génération d'identité de marque, la création de logos, les programmes d'identité visuelle (CIP), les bannières, les diapositives de présentation et des icônes sur mesure.
|
|
* **Création avancée de ressources :** Intégration poussée avec la génération d'images par IA pour créer de véritables ressources visuelles, et pas seulement des placeholders.
|
|
* **Architecture entreprise :** Une architecture de design tokens plus complète et évolutive, conçue pour les déploiements dans de grandes équipes.
|
|
* **Support prioritaire :** Assistance technique dédiée pour les équipes et les professionnels qui ont besoin d'un workflow de design complet et ininterrompu.
|
|
|
|
👉 *Pour en savoir plus sur le passage à la version Premium, rendez-vous sur [uupm.cc](https://uupm.cc).*
|
|
|
|
## Installation
|
|
|
|
### Via la Claude Marketplace (Claude Code)
|
|
|
|
Installez-le directement dans Claude Code en deux commandes :
|
|
|
|
```
|
|
/plugin marketplace add nextlevelbuilder/ui-ux-pro-max-skill
|
|
/plugin install ui-ux-pro-max@ui-ux-pro-max-skill
|
|
```
|
|
|
|
### Via la CLI (recommandé)
|
|
|
|
```bash
|
|
# Installer la CLI globalement
|
|
npm install -g ui-ux-pro-max-cli
|
|
|
|
# Aller dans votre projet
|
|
cd /path/to/your/project
|
|
|
|
# Installer pour votre assistant IA
|
|
uipro init --ai claude # Claude Code
|
|
uipro init --ai cursor # Cursor
|
|
uipro init --ai windsurf # Windsurf
|
|
uipro init --ai antigravity # Antigravity
|
|
uipro init --ai copilot # GitHub Copilot
|
|
uipro init --ai kiro # Kiro
|
|
uipro init --ai codex # Codex CLI
|
|
uipro init --ai qoder # Qoder
|
|
uipro init --ai roocode # Roo Code
|
|
uipro init --ai gemini # Gemini CLI
|
|
uipro init --ai trae # Trae
|
|
uipro init --ai opencode # OpenCode
|
|
uipro init --ai continue # Continue
|
|
uipro init --ai codebuddy # CodeBuddy
|
|
uipro init --ai droid # Droid (Factory)
|
|
uipro init --ai kilocode # KiloCode
|
|
uipro init --ai warp # Warp
|
|
uipro init --ai augment # Augment
|
|
uipro init --ai codewhale # CodeWhale
|
|
uipro init --ai zcode # ZCode
|
|
uipro init --ai kimi # Kimi Code
|
|
uipro init --ai amazonq # Amazon Q Developer
|
|
uipro init --ai openclaw # OpenClaw (.agents/skills/)
|
|
uipro init --ai autoclaw # AutoClaw (skills/ ou ~/.openclaw-autoclaw/skills)
|
|
uipro init --ai universal # Universel / Agent Standard (.agents/skills/)
|
|
uipro init --ai all # Tous les assistants
|
|
```
|
|
|
|
Le paquet npm s'appelle `ui-ux-pro-max-cli` ; il installe toujours la commande `uipro`. Les anciennes versions de `uipro-cli` sont obsolètes et ne doivent pas être utilisées pour les ressources actuelles.
|
|
|
|
### Installation globale (disponible pour tous les projets)
|
|
|
|
```bash
|
|
uipro init --ai claude --global # Installe dans ~/.claude/skills/
|
|
uipro init --ai cursor --global # Installe dans ~/.cursor/skills/
|
|
uipro init --ai zcode --global # Installe dans ~/.zcode/skills/
|
|
uipro init --ai kimi --global # Installe dans ~/.kimi-code/skills/
|
|
uipro init --ai universal --global # Installe dans ~/.agents/skills/
|
|
```
|
|
|
|
### Autres commandes de la CLI
|
|
|
|
```bash
|
|
uipro versions # Lister les versions disponibles
|
|
uipro update # Actualiser les fichiers du skill depuis le paquet CLI installé
|
|
uipro update --global # Actualiser les fichiers globaux du skill depuis le paquet CLI installé
|
|
uipro init --offline # Option de compatibilité ; installe les templates intégrés
|
|
uipro init --dry-run # Prévisualiser l'installation sans écrire de fichiers
|
|
uipro uninstall # Supprimer le skill (détection automatique de la plateforme)
|
|
uipro uninstall --ai claude # Supprimer pour une plateforme précise
|
|
uipro uninstall --global # Supprimer l'installation globale
|
|
```
|
|
|
|
## Prérequis
|
|
|
|
Python 3.x est requis pour le script de recherche (bibliothèque standard uniquement : les scripts n'installent rien et n'effectuent aucun appel réseau).
|
|
|
|
Vérifiez si Python est installé :
|
|
|
|
```bash
|
|
python3 --version
|
|
```
|
|
|
|
S'il est absent, installez-le vous-même depuis [python.org](https://www.python.org/downloads/) ou avec le gestionnaire de paquets de votre système (Homebrew, apt, winget). Ces étapes d'installation s'adressent à **vous, l'utilisateur humain** : les agents IA qui utilisent ce skill ne doivent jamais installer de logiciel sur votre machine ; ils ont pour consigne de vous le demander.
|
|
|
|
## Utilisation
|
|
|
|
### Mode Skill (activation automatique)
|
|
|
|
**Pris en charge :** Claude Code, Cursor, Windsurf, Antigravity, Codex CLI, Continue, Gemini CLI, OpenCode, Qoder, CodeBuddy, Droid (Factory), KiloCode, Warp, Augment, CodeWhale, ZCode, Kimi Code, Amazon Q Developer, OpenClaw, GitHub Copilot
|
|
|
|
Le skill s'active automatiquement lorsque vous demandez un travail d'UI/UX. Discutez simplement de façon naturelle :
|
|
|
|
```
|
|
Crée une landing page pour mon produit SaaS
|
|
```
|
|
|
|
> **Trae** : passez d'abord en mode **SOLO**. Le skill s'activera pour les demandes d'UI/UX.
|
|
|
|
### Mode Workflow (commande slash)
|
|
|
|
**Pris en charge :** Kiro, Roo Code, KiloCode
|
|
|
|
Utilisez la commande slash pour invoquer le skill :
|
|
|
|
```
|
|
/ui-ux-pro-max Crée une landing page pour mon produit SaaS
|
|
```
|
|
|
|
### Exemples de prompts
|
|
|
|
```
|
|
Crée une landing page pour mon produit SaaS
|
|
|
|
Crée un tableau de bord d'analytique pour le secteur de la santé
|
|
|
|
Conçois un site portfolio avec mode sombre
|
|
|
|
Réalise l'interface d'une application mobile d'e-commerce
|
|
|
|
Crée une application bancaire fintech avec un thème sombre
|
|
```
|
|
|
|
### Appliquer un thème à une application existante
|
|
|
|
Après avoir [installé le skill](#installation), ouvrez votre application dans votre assistant IA et utilisez un prompt comme celui-ci. En mode Workflow, préfixez-le avec `/ui-ux-pro-max`.
|
|
|
|
```text
|
|
Utilise le skill ui-ux-pro-max pour changer le thème de mon application React existante.
|
|
Style cible : Minimalism & Swiss Style.
|
|
Commence par examiner les versions du framework et de la bibliothèque de styles, les routes,
|
|
les composants, les styles et les tokens de thème existants. Conserve la structure actuelle
|
|
des composants, leur comportement et la logique métier.
|
|
Réutilise et mets à jour les tokens sémantiques existants pour les couleurs, la typographie,
|
|
les espacements, les rayons, les ombres et les états d'interaction ; ajoute les tokens manquants
|
|
plutôt que de créer un système de thème parallèle. Remplace les styles codés en dur un composant
|
|
à la fois.
|
|
Vérifie le contraste, le focus clavier, les mises en page responsive et tous les modes clair/sombre
|
|
pris en charge. Résume les fichiers modifiés et les styles codés en dur restants.
|
|
```
|
|
|
|
Remplacez `Minimalism & Swiss Style` par le [style du catalogue](src/ui-ux-pro-max/data/styles.csv) ou la direction visuelle de votre choix. Les résultats de recherche fournissent des recommandations de design ; ils ne réécrivent pas automatiquement votre application.
|
|
|
|
**Check-list de migration de thème :**
|
|
|
|
- **Auditer :** repérez les valeurs codées en dur liées au thème dans les feuilles de style, les styles inline et les classes utilitaires comme `bg-blue-600` ou `text-[#1e293b]`.
|
|
- **Associer :** réutilisez des rôles sémantiques tels que `background`, `surface`, `foreground`, `primary`, `border` et `ring` dans le système de styles existant de l'application. Ajoutez les rôles manquants en suivant les conventions de la version installée de sa bibliothèque.
|
|
- **Migrer :** remplacez les valeurs codées en dur par des références aux tokens, par petits lots de composants. Modifier uniquement les tokens n'aura aucun effet sur les styles qui ne les utilisent pas.
|
|
- **Vérifier :** contrôlez le contraste du texte et de l'interface, les états de survol/focus/désactivé, les mises en page responsive et chaque thème pris en charge après chaque lot.
|
|
|
|
### Comment ça marche
|
|
|
|
1. **Vous demandez** - Formulez n'importe quelle tâche d'UI/UX (créer, concevoir, implémenter, relire, corriger, améliorer)
|
|
2. **Génération du design system** - L'IA génère automatiquement un design system complet grâce au moteur de raisonnement
|
|
3. **Recommandations intelligentes** - En fonction de votre type de produit et de vos besoins, il trouve les styles, couleurs et typographies les plus adaptés
|
|
4. **Génération du code** - Implémente l'interface avec les bonnes couleurs, polices, espacements et bonnes pratiques
|
|
5. **Vérifications avant livraison** - Contrôle le résultat par rapport aux anti-patterns UI/UX courants
|
|
|
|
### Stacks prises en charge
|
|
|
|
Le skill fournit des recommandations spécifiques pour :
|
|
|
|
| Catégorie | Stacks |
|
|
|----------|--------|
|
|
| **Web (HTML)** | HTML + Tailwind (par défaut) |
|
|
| **Écosystème React** | React, Next.js, shadcn/ui |
|
|
| **Écosystème Vue** | Vue, Nuxt.js, Nuxt UI |
|
|
| **Angular** | Angular |
|
|
| **PHP** | Laravel (Blade, Livewire, Inertia.js) |
|
|
| **Autre (Web)** | Svelte, Astro, Three.js |
|
|
| **Desktop** | JavaFX, WPF, WinUI 3, Avalonia, Uno Platform, UWP |
|
|
| **iOS** | SwiftUI |
|
|
| **Android** | Jetpack Compose |
|
|
| **Multiplateforme** | React Native, Flutter |
|
|
|
|
Il suffit de mentionner la stack de votre choix dans le prompt, ou de laisser la valeur par défaut, HTML + Tailwind.
|
|
|
|
## Exemples
|
|
|
|
### Avant/après : tableau de bord d'exploitation
|
|
|
|
Un tableau de bord d'exploitation sobre ([avant](https://skill-fixture-before.theroost.dev)) restylé uniquement à partir du design system généré pour lui par UI UX Pro Max ([après](https://ui-ux-pro-max-after.theroost.dev)), via `search.py "internal operations dashboard" --design-system --density 8 --motion 3 --variance 4`.
|
|
|
|
*Exemple illustratif proposé par la communauté ; il ne s'agit ni d'une démo officielle, ni d'un benchmark, ni d'un test d'exécution du skill.*
|
|
|
|
## Commande Design System (avancé)
|
|
|
|
Pour accéder directement au générateur de design system :
|
|
|
|
> Remarque : si vous avez installé le skill via Continue, remplacez `.claude/skills/` par `.continue/skills/` dans les commandes ci-dessous. Pour Droid (Factory), utilisez `.factory/skills/`. Pour ZCode, utilisez `.zcode/skills/`. Pour Amazon Q Developer, utilisez `.amazonq/skills/` (Amazon Q ne charge automatiquement que la règle située dans `.amazonq/rules/ui-ux-pro-max.md` ; les données et scripts de `.amazonq/skills/` sont des fichiers référencés par cette règle).
|
|
|
|
```bash
|
|
# Générer un design system avec une sortie ASCII
|
|
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness" --design-system -p "Serenity Spa"
|
|
|
|
# Générer avec une sortie Markdown
|
|
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "fintech banking" --design-system -f markdown
|
|
|
|
# Recherche par domaine
|
|
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "glassmorphism" --domain style
|
|
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "elegant serif" --domain typography
|
|
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "dashboard" --domain chart
|
|
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "error summary validation" --domain ux
|
|
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "decorative icon aria hidden" --domain icons
|
|
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "icon button accessible label" --domain icons
|
|
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "orphan heading line balance" --domain ux
|
|
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "badge chip label wraps to second line" --domain ux
|
|
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "rapid chip animation interrupted" --domain ux
|
|
|
|
# Interfaces RTL / arabe, hébreu, persan (domaines style et product)
|
|
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "dashboard" --domain style --rtl=full
|
|
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "fintech" --domain product --rtl=partial
|
|
|
|
# Recommandations spécifiques à une stack
|
|
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "form validation" --stack react
|
|
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "responsive layout" --stack html-tailwind
|
|
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "chip badge overflow nowrap" --stack html-tailwind
|
|
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "tableview binding" --stack javafx
|
|
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "atlantafx primer enterprise theme" --stack javafx
|
|
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "enterprise tableview density permission" --stack javafx
|
|
```
|
|
|
|
La recherche pour les stacks web tient compte des versions. Les requêtes sans mention d'une version majeure antérieure renvoient les recommandations actuelles et actives. Les termes explicitement anciens ou les versions majeures antérieures (par exemple `Svelte 4` ou `Next.js 15`) ne renvoient que des lignes historiques sélectionnées, étiquetées par `Status` et `Applies To` ; lorsqu'aucune recommandation historique correspondante n'existe, la recherche ne renvoie aucun résultat plutôt que de mélanger les générations de frameworks.
|
|
|
|
### Compatibilité RTL (`--rtl`)
|
|
|
|
Chaque ligne de style et de produit comporte un `rtl_level` pour les interfaces de droite à gauche (arabe, hébreu, persan, ourdou) :
|
|
|
|
| Niveau | Signification |
|
|
|-------|---------|
|
|
| `full` | Indépendant du sens de lecture : la mise en page supporte l'inversion sans modification. |
|
|
| `partial` | S'inverse proprement, mais certains composants et animations doivent être ajustés. |
|
|
| `caveats` | Le style ou le produit encode le sens de lecture (typographie cinétique, frises chronologiques LTR, surfaces de code/terminal, cartes et ordre des sièges). |
|
|
|
|
```bash
|
|
# Uniquement les styles qui s'inversent sans travail supplémentaire
|
|
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "dashboard" --domain style --rtl=full
|
|
|
|
# Tous les niveaux, résultats filtrés toujours étiquetés avec rtl_level
|
|
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "mobile" --domain style --rtl
|
|
```
|
|
|
|
`--rtl` nécessite un `--domain style` ou `--domain product` explicite. Le filtre est appliqué après le classement mais avant la troncature `-n/--max-results`, de sorte qu'une limite étroite ne masque jamais une ligne correspondante. Il est refusé avec `--design-system` et `--stack`.
|
|
|
|
### Persister le design system (pattern Master + Overrides)
|
|
|
|
Enregistrez votre design system dans des fichiers pour une **récupération hiérarchique d'une session à l'autre** :
|
|
|
|
```bash
|
|
# Générer et enregistrer dans design-system/myapp/MASTER.md
|
|
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "SaaS dashboard" --design-system --persist -p "MyApp"
|
|
|
|
# Créer également un fichier de surcharge propre à une page
|
|
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "SaaS dashboard" --design-system --persist -p "MyApp" --page "dashboard"
|
|
```
|
|
|
|
Cela crée une arborescence `design-system/` :
|
|
|
|
```
|
|
design-system/
|
|
└── myapp/ # Un dossier par projet (slug de -p "MyApp")
|
|
├── MASTER.md # Source de vérité globale (couleurs, typographie, espacements, composants)
|
|
└── pages/
|
|
└── dashboard.md # Surcharges propres à la page (uniquement les écarts par rapport au Master)
|
|
```
|
|
|
|
**Fonctionnement de la récupération hiérarchique :**
|
|
1. Lorsque vous créez une page précise (p. ex. « Checkout »), vérifiez d'abord `design-system/[project-slug]/pages/checkout.md`
|
|
2. Si le fichier de la page existe, ses règles **remplacent** celles du fichier Master
|
|
3. Sinon, utilisez exclusivement `design-system/[project-slug]/MASTER.md`
|
|
|
|
**Prompt de récupération contextuelle :**
|
|
```
|
|
Je crée la page [Nom de la page]. Lis design-system/[project-slug]/MASTER.md.
|
|
Vérifie aussi si design-system/[project-slug]/pages/[page-name].md existe.
|
|
Si le fichier de la page existe, donne la priorité à ses règles.
|
|
Sinon, utilise exclusivement les règles du Master.
|
|
Maintenant, génère le code...
|
|
```
|
|
|
|
## Architecture et contribution
|
|
|
|
### Pour les utilisateurs
|
|
|
|
Le code a été restructuré autour d'un **système de génération à base de templates**. Tous les fichiers propres à chaque plateforme (`.cursor/`, `.windsurf/`, `.kiro/`, `.factory/`, etc.) sont désormais générés dynamiquement par la CLI.
|
|
|
|
**Utilisez toujours la CLI pour installer :**
|
|
|
|
```bash
|
|
npm install -g ui-ux-pro-max-cli
|
|
uipro init --ai <platform>
|
|
```
|
|
|
|
Vous obtenez ainsi les derniers templates fournis avec le paquet CLI installé, ainsi que la structure de fichiers adaptée à votre assistant IA. Mettez d'abord à jour le paquet npm lorsqu'une nouvelle version est publiée.
|
|
|
|
### Pour les contributeurs
|
|
|
|
Si vous souhaitez contribuer à ce projet :
|
|
|
|
```bash
|
|
# 1. Cloner le dépôt
|
|
git clone https://github.com/nextlevelbuilder/ui-ux-pro-max-skill.git
|
|
cd ui-ux-pro-max-skill
|
|
|
|
# 2. Comprendre la structure
|
|
src/ui-ux-pro-max/ # Source de vérité (données, scripts, templates)
|
|
cli/ # Installeur CLI (génère les fichiers à partir des templates)
|
|
.claude/ # Développement/test local du skill Claude Code
|
|
.factory/ # Développement/test local du skill Droid (Factory)
|
|
|
|
# 3. Apporter vos modifications dans src/ui-ux-pro-max/
|
|
# - data/*.csv → Fichiers de base de données
|
|
# - scripts/*.py → Moteur de recherche et design system
|
|
# - templates/ → Templates propres à chaque plateforme
|
|
|
|
# 4. Synchroniser vers la CLI et tester en local
|
|
cd cli
|
|
npm run sync:assets
|
|
npm run check:assets
|
|
npm run verify:data
|
|
npm run typecheck
|
|
|
|
# 5. Compiler et tester la CLI
|
|
# `npm run build` utilise Bun s'il est disponible, sinon le compilateur TypeScript après `npm ci`.
|
|
npm run build
|
|
node dist/index.js init --ai claude --offline # Tester dans un dossier temporaire
|
|
node dist/index.js init --ai claude --dry-run # Prévisualiser l'installation (aucune écriture)
|
|
|
|
# 6. Créer une PR (ne jamais pousser directement sur main)
|
|
git checkout -b feat/your-feature
|
|
git commit -m "feat: description"
|
|
git push -u origin feat/your-feature
|
|
gh pr create
|
|
```
|
|
|
|
Consultez [CLAUDE.md](CLAUDE.md) pour les consignes de développement détaillées.
|
|
|
|
### Provenance et actualisation des catalogues
|
|
|
|
Le résumé de catalogue versionné recense actuellement **1 934 Google Fonts approuvées** ainsi que **8 exclusions en attente de revue**, qui ne sont pas promues tant qu'elles n'ont pas de métadonnées de licence officielles correspondantes. Les recommandations d'icônes restent à **105 lignes sélectionnées** (100 imports web Phosphor directs plus des recommandations React Native/de repli) ; le **manifeste Phosphor amont de 1 512 icônes**, distinct, valide les noms, les graisses et les imports React/SSR sans inonder les résultats de recherche avec l'intégralité du paquet amont.
|
|
|
|
Le développement courant et la CI des pull requests ne dépendent pas du réseau. Lancez la vérification hors ligne complète, y compris les hachages des snapshots et la validation des comptes générés, avec :
|
|
|
|
```bash
|
|
npm --prefix cli run verify:data
|
|
# Ou vérifier uniquement le résumé de catalogue généré :
|
|
npm --prefix cli run validate:catalog-summary
|
|
```
|
|
|
|
La normalisation de l'actualisation peut également être testée entièrement hors ligne à partir des fixtures versionnées. Les résultats sont écrits dans un répertoire candidat temporaire et ne remplacent jamais les données canoniques :
|
|
|
|
```bash
|
|
candidate_dir="$(mktemp -d)"
|
|
python3 scripts/refresh-google-fonts.py \
|
|
--api-input src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/google-api.json \
|
|
--metadata-input src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/google-metadata.json \
|
|
--existing-csv src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/google-existing.csv \
|
|
--overrides src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/google-overrides.json \
|
|
--output-csv "$candidate_dir/google-fonts.csv" \
|
|
--license-output "$candidate_dir/google-font-licenses.json" \
|
|
--metadata-revision fixture-catalogs-v1 \
|
|
--verified-at 2026-08-13 --expected-count 2 --approve-changes
|
|
python3 scripts/refresh-icon-catalog.py \
|
|
--input src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/phosphor-core.json \
|
|
--package-json src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/phosphor-package.json \
|
|
--react-package-json src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/phosphor-react-package.json \
|
|
--react-exports-input src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/phosphor-react-exports.json \
|
|
--curated-csv src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/icons-curated.csv \
|
|
--output "$candidate_dir/phosphor-icons-upstream.json" \
|
|
--verified-at 2026-08-13 --expected-count 2
|
|
```
|
|
|
|
L'actualisation en direct depuis les sources amont est volontairement isolée dans le workflow `refresh-catalogs.yml`, planifié le lundi à 03h17 UTC et également disponible à la demande. Configurez `GOOGLE_FONTS_API_KEY` comme secret GitHub Actions, puis lancez le workflow et téléchargez son artefact de revue :
|
|
|
|
```bash
|
|
gh workflow run refresh-catalogs.yml
|
|
run_id="$(gh run list --workflow refresh-catalogs.yml --limit 1 --json databaseId --jq '.[0].databaseId')"
|
|
gh run watch "$run_id"
|
|
gh run download "$run_id" --name "catalog-refresh-review-$run_id"
|
|
```
|
|
|
|
Le workflow interroge l'API Google Fonts Developer et les paquets Phosphor officiels à version figée, écrit les fichiers candidats et les diffs unifiés dans un artefact, et ne dispose que de permissions en lecture seule sur le dépôt. Il ne fait jamais de commit, de push, n'ouvre jamais de PR et ne fusionne jamais rien. Examinez les rapports de modifications, les exclusions, les licences, les métriques de pertinence et la vérification hors ligne avant de promouvoir manuellement les fichiers candidats dans `src/ui-ux-pro-max/data/`.
|
|
|
|
|
|
## Releases automatisées
|
|
|
|
Ce dépôt utilise semantic-release avec les Conventional Commits pour créer automatiquement les releases GitHub :
|
|
|
|
- La branche `dev` crée des pré-versions bêta GitHub, comme `2.6.0-beta.1`.
|
|
- La branche `main` crée des versions stables officielles GitHub, comme `2.6.0`.
|
|
|
|
Les notes de version et le `CHANGELOG.md` sont générés à partir des messages de commit au format Conventional Commits. Les numéros de version sont synchronisés entre `skill.json`, `.claude-plugin/plugin.json`, `.claude-plugin/marketplace.json`, `cli/package.json` et `cli/package-lock.json` lors de la préparation de la release.
|
|
|
|
Utilisez ces types de commit pour obtenir le bon incrément de version :
|
|
|
|
- `fix:` -> version corrective (patch)
|
|
- `feat:` -> version mineure
|
|
- `feat!:` ou `BREAKING CHANGE:` -> version majeure
|
|
|
|
Le workflow de release utilise le `GITHUB_TOKEN` par défaut pour les releases GitHub et le secret `NPM_TOKEN` du dépôt pour publier `ui-ux-pro-max-cli` sur npm.
|
|
|
|
## Dépannage
|
|
|
|
### Claude Code signale `response exceeded the ... output token maximum`
|
|
|
|
Il s'agit d'une limite propre à une seule réponse de Claude Code, et non d'une erreur de l'installeur ou des scripts de recherche d'UI/UX Pro Max. Demandez d'abord à Claude de découper la tâche en étapes plus petites et d'écrire les résultats volumineux dans des fichiers au fur et à mesure.
|
|
|
|
Si vous avez réellement besoin d'une réponse unique plus longue et que le modèle actif le permet, définissez la limite de tokens de sortie de Claude Code avant de démarrer une nouvelle session. Par exemple :
|
|
|
|
```bash
|
|
# macOS, Linux ou WSL
|
|
export CLAUDE_CODE_MAX_OUTPUT_TOKENS="64000"
|
|
claude
|
|
```
|
|
|
|
```powershell
|
|
# Windows PowerShell
|
|
$env:CLAUDE_CODE_MAX_OUTPUT_TOKENS = "64000"
|
|
claude
|
|
```
|
|
|
|
Les modifications de l'environnement du shell ne s'appliquent qu'aux programmes lancés depuis ce shell : redémarrez donc Claude Code après avoir défini la variable. Claude Code plafonne les valeurs supérieures à la limite de sortie du modèle actif ; les plafonds varient selon le modèle et le fournisseur. Augmenter cette valeur peut aussi accroître la latence et la consommation, et réduit le contexte effectivement disponible avant la compaction automatique. Consultez la [référence officielle des variables d'environnement de Claude Code](https://code.claude.com/docs/en/env-vars#variables).
|
|
|
|
### `uipro: unknown command 'uninstall'` ou `unknown command 'update'`
|
|
|
|
Votre version installée de `ui-ux-pro-max-cli` est obsolète. Mettez-la à jour et réessayez :
|
|
|
|
```bash
|
|
npm install -g ui-ux-pro-max-cli@latest
|
|
uipro uninstall
|
|
```
|
|
|
|
### `uipro uninstall` affiche « No installed AI skill directories detected »
|
|
|
|
Le skill a été installé dans un autre répertoire que celui depuis lequel vous lancez la commande. Au choix :
|
|
|
|
```bash
|
|
# Option A — lancer la commande depuis la racine du projet où vous l'avez installé
|
|
cd /path/to/your/project
|
|
uipro uninstall
|
|
|
|
# Option B — supprimer l'installation globale
|
|
uipro uninstall --global
|
|
|
|
# Option C — supprimer manuellement
|
|
rm -rf .claude/skills/ui-ux-pro-max # Claude Code
|
|
rm -rf .cursor/skills/ui-ux-pro-max # Cursor
|
|
rm -rf .windsurf/skills/ui-ux-pro-max # Windsurf
|
|
rm -rf .agents/skills/ui-ux-pro-max # Antigravity / Codex
|
|
```
|
|
|
|
### La boîte de dialogue « Upload a skill » de Claude.ai affiche « Zip contains too many files (maximum 200) »
|
|
|
|
N'envoyez pas le ZIP complet du dépôt GitHub. Il s'agit d'une copie de développement qui contient le code source, les ressources de la CLI, la documentation, des aperçus et plusieurs skills intégrés : elle dépasse donc la limite de 200 fichiers de Claude. Ce n'est pas un artefact destiné à l'envoi d'un skill sur Claude, et ce projet ne publie pas actuellement de ZIP distinct pour un envoi manuel sur Claude.ai.
|
|
|
|
Pour Claude Code, installez-le via la Marketplace :
|
|
|
|
```bash
|
|
/plugin marketplace add nextlevelbuilder/ui-ux-pro-max-skill
|
|
/plugin install ui-ux-pro-max@ui-ux-pro-max-skill
|
|
```
|
|
|
|
Ou utilisez l'installeur CLI :
|
|
|
|
```bash
|
|
npx ui-ux-pro-max-cli init --ai claude
|
|
```
|
|
|
|
### L'installation via la Claude Marketplace échoue avec « Zip file contains a symbolic link »
|
|
|
|
Il s'agit d'un problème connu des versions antérieures à la v2.5.1. Le dépôt utilisait en interne des liens symboliques que certains outils d'installation ne savent pas gérer. **Solution :** utilisez plutôt l'installeur CLI :
|
|
|
|
```bash
|
|
npm install -g ui-ux-pro-max-cli
|
|
uipro init --ai claude
|
|
```
|
|
|
|
Ou attendez la prochaine version, dans laquelle ce problème est corrigé.
|
|
|
|
### `npm install -g ui-ux-pro-max-cli` échoue avec une erreur de permissions
|
|
|
|
Utilisez un gestionnaire de versions de Node (recommandé), ou évitez complètement l'installation globale :
|
|
|
|
```bash
|
|
# npx sans installation globale
|
|
npx ui-ux-pro-max-cli init --ai claude
|
|
```
|
|
|
|
### Python introuvable lors de l'exécution des commandes de design system
|
|
|
|
Les scripts de recherche nécessitent Python 3.x. Installez-le manuellement depuis [python.org](https://www.python.org/downloads/) ou avec le gestionnaire de paquets de votre système (Homebrew, apt, winget). Les agents IA ne doivent pas l'installer à votre place : ils ont pour consigne de vous le demander.
|
|
|
|
### La sortie du design system est coupée / les champs sont tronqués
|
|
|
|
La sortie lisible par un humain tronque les champs longs à 300 caractères. Utilisez `--json` pour obtenir les données complètes, sans troncature :
|
|
|
|
```bash
|
|
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "SaaS" --domain style --json
|
|
```
|
|
|
|
---
|
|
|
|
## Historique des étoiles
|
|
|
|
[](https://star-history.dera.page/#nextlevelbuilder/ui-ux-pro-max-skill&Date)
|
|
|
|
## Licence
|
|
|
|
Ce projet est distribué sous [licence MIT](LICENSE).
|
|
|
|
## Agents compatibles
|
|
|
|
Ce skill fonctionne avec :
|
|
- [Claude Code](https://claude.com/product/claude-code)
|
|
- [AdaL](https://sylph.ai/) - Agent de programmation IA auto-évolutif ([Documentation](https://docs.sylph.ai/) | [GitHub](https://github.com/SylphAI-Inc/adal-cli))
|