ux-skill

# ux-skill — Moteur d'intelligence de design pour les outils de codage IA ux-skill est un **moteur d'intelligence de design** conçu pour rendre les interfaces générées par IA distinctives plutôt que génériques. Il s'intègre à 17 outils de codage IA, notamment Claude Code, Cursor, Windsurf, GitHub Copilot, Gemini CLI, Codex et d'autres. Le moteur est gratuit, sous licence MIT, fonctionne hors ligne et n'appelle jamais de LLM. ## Fonctionnalités clés - **Synthétiseur déterministe à 7 axes** : compile des briefs en jetons de design inédits (chaleur, contraste, densité, géométrie, formalité, mouvement, personnalité typographique) sans choisir parmi des modèles. - **152 règles de linter anti-AI-slop** : règles déterministes basées sur des expressions régulières qui s'exécutent en CI et renvoient un code non nul en cas de problèmes Critiques/Élevés. - **160 spécifications de marque** : de vraies spécifications DESIGN.md pour des marques comme Apple, Stripe, Linear, Figma, Tesla, BMW, Notion, Spotify, Airbnb, Vercel, Supabase, Cursor, Raycast, Claude, et plus encore. - **12 manifestes JSON interrogeables** : 84 styles, 176 palettes, 70 associations typographiques, 148 composants, 184 secteurs, 35 types de graphiques, 57 préréglages de mouvement, 112 lois UX, 152 règles anti-patterns, 25 stacks technologiques et 160 spécifications de marque. - **25 commandes slash** : commandes de découverte, génération, audit, lint, polish, boucle de correction, étude de cas, atelier, copie, mouvement, a11y, tableau de bord et conductor. - **5 sous-agents** : ingénieur frontend, ingénieur mouvement, rédacteur, synthétiseur de recherche et architecte de système de design. - **18 outils MCP** : dont ux_synthesize, ux_decisions_query et ux_decisions_stats. - **Prise en charge de 17 IDE** : même moteur avec une glue différente par IDE. - **Hors ligne et déterministe** : aucun appel LLM, une même entrée produit toujours la même sortie. ## Installation Trois chemins d'installation sont disponibles : ### Chemin 1 — marketplace Claude Code (canonique) ```bash /plugin marketplace add Laith0003/ux-skill /plugin install ux@ux-skill ``` ### Chemin 2 — pip (universel) ```bash pip install uxskill uxskill init # détecte automatiquement votre IDE, installe l'artefact approprié uxskill stats # affiche les compteurs de manifestes pour vérifier l'installation uxskill lint . # exécute le linter sur le répertoire courant ``` ### Chemin 3 — npx (sans Python requis) ```bash npx uxskill init # télécharge pipx + uxskill au premier lancement npx uxskill recommend --industry=fintech-neobank --tone=warm --stack=nextjs-15-app-router ``` ## Fonctionnement 1. **Entrée** : fournissez un brief via `/ux-discover` (10 champs) ou des indicateurs à `ux recommend`. 2. **5 recherches parallèles** : le moteur exécute cinq recherches simultanément dans les manifestes (secteur, style, ton, stack, interdit/région). 3. **Fusion** : un fusionneur déterministe classe les candidats et résout les conflits. 4. **Sortie** : un document JSON avec style, palette, association typographique, préréglages de mouvement, composants, exemples de marque et garde-fous anti-patterns. 5. **Génération** : les commandes en aval consomment la recommandation pour générer du code via des sous-agents. 6. **Vérification** : `/ux-lint` réanalyse le code généré selon 152 règles regex. ## Points forts de la v3.1.0 - **Fidélité de marque imposée** : couleur primaire lue à partir des pixels du logo, polices par défaut rejetées, seuil strict dans evaluate qui fait échouer les sorties abandonnant la couleur/le logo de marque ou n'embarquant aucune imagerie réelle. - **Mobile-first conditionné** : nouvelles fondations craft plus un portail sensible au wrap qui échoue en cas de défilement horizontal, de nav/wordmark/libellé de bouton qui passe à la ligne, ou d'en-tête sticky trop haut. - **Couche Wow** : le moteur dérive 2-3 moments signature coordonnés par page. - **Linter plus précis** : 152 règles dont imagerie obligatoire, détection icon-only, règles sur les jetons placeholder et 100vw. - **310 tests réussis** : hors ligne, déterministe, aucun LLM jamais appelé. ## Architecture Le moteur se compose de : - **data/** : manifestes JSON interrogeables (styles, palettes, associations typographiques, composants, secteurs, types de graphiques, stacks technologiques, directives UX, préréglages de mouvement, anti-patterns, marques). - **engine/** : cœur de raisonnement Python (synthétiseur, décisions, recommender, linter, découverte, générateur, installateur, CLI). - **commands/** : 25 commandes slash Claude Code (fichiers .md). - **agents/** : 5 sous-agents (fichiers .md). - **references/** : source en prose pour les données et les pages de démonstration. - **bin/** : wrapper npx et scripts de linter. - **.ux/** : répertoire d'état par projet. ## Comparaison Le README inclut une comparaison honnête avec 8 autres plugins UX pour Claude, notant où ux-skill gagne (bibliothèque de composants, préréglages de mouvement, linter anti-patterns, spécifications de marque, prise en charge de 17 IDE, 25 commandes slash) et où il perd (notoriété, reconnaissance de marque, finition marketing). ## Licence Licence MIT. Auteur : Laith Aljunaidy, designer et CTO à Amman. Site : uxskill.laithjunaidy.com. GitHub : Laith0003/ux-skill. PyPI : uxskill. npm : uxskill.