ui-ux-pro-max-skill
ui-ux-pro-max-skill is an open-source Python project in the ui components space with 88.5k GitHub stars. The repository has seen commits within the last year.
MITPermissive — free to use in commercial and proprietary software, with attribution.View license →
Production readiness
4/5- Actively maintainedCommits in the last 6 months
- No known vulnerabilitiesNot yet scanned
- Clear, usable licenseMIT (permissive)
- Proven adoptionWidely used
- Has documentationDocumentation indexed
pip install ui-ux-pro-max-skillUI UX Pro Max
An AI skill that provides design intelligence for building professional UI/UX across multiple platforms and frameworks.
What's New in v2.0
Intelligent Design System Generation
The flagship feature of v2.0 is the Design System Generator - an AI-powered reasoning engine that analyzes your project requirements and generates a complete, tailored design system in seconds.
+----------------------------------------------------------------------------------------+
| TARGET: Serenity Spa - RECOMMENDED DESIGN SYSTEM |
+----------------------------------------------------------------------------------------+
| |
| PATTERN: Hero-Centric + Social Proof |
| Conversion: Emotion-driven with trust elements |
| CTA: Above fold, repeated after testimonials |
| Sections: |
| 1. Hero |
| 2. Services |
| 3. Testimonials |
| 4. Booking |
| 5. Contact |
| |
| STYLE: Soft UI Evolution |
| Keywords: Soft shadows, subtle depth, calming, premium feel, organic shapes |
| Best For: Wellness, beauty, lifestyle brands, premium services |
| Performance: Excellent | Accessibility: WCAG AA |
| |
| COLORS: |
| Primary: #E8B4B8 (Soft Pink) |
| Secondary: #A8D5BA (Sage Green) |
| CTA: #D4AF37 (Gold) |
| Background: #FFF5F5 (Warm White) |
| Text: #2D3436 (Charcoal) |
| Notes: Calming palette with gold accents for luxury feel |
| |
| TYPOGRAPHY: Cormorant Garamond / Montserrat |
| Mood: Elegant, calming, sophisticated |
| Best For: Luxury brands, wellness, beauty, editorial |
| Google Fonts: https://fonts.google.com/share?selection.family=... |
| |
| KEY EFFECTS: |
| Soft shadows + Smooth transitions (200-300ms) + Gentle hover states |
| |
| AVOID (Anti-patterns): |
| Bright neon colors + Harsh animations + Dark mode + AI purple/pink gradients |
| |
| PRE-DELIVERY CHECKLIST: |
| [ ] No emojis as icons (use SVG: Heroicons/Lucide) |
| [ ] cursor-pointer on all clickable elements |
| [ ] Hover states with smooth transitions (150-300ms) |
| [ ] Light mode: text contrast 4.5:1 minimum |
| [ ] Focus states visible for keyboard nav |
| [ ] prefers-reduced-motion respected |
| [ ] Responsive: 375px, 768px, 1024px, 1440px |
| |
+----------------------------------------------------------------------------------------+
How Design System Generation Works
┌─────────────────────────────────────────────────────────────────┐
│ 1. USER REQUEST │
│ "Build a landing page for my beauty spa" │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ 2. MULTI-DOMAIN SEARCH (5 parallel searches) │
│ • Product type matching (161 categories) │
│ • Style recommendations (67 styles) │
│ • Color palette selection (161 palettes) │
│ • Landing page patterns (24 patterns) │
│ • Typography pairing (57 font combinations) │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ 3. REASONING ENGINE │
│ • Match product → UI category rules │
│ • Apply style priorities (BM25 ranking) │
│ • Filter anti-patterns for industry │
│ • Process decision rules (JSON conditions) │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ 4. COMPLETE DESIGN SYSTEM OUTPUT │
│ Pattern + Style + Colors + Typography + Effects │
│ + Anti-patterns to avoid + Pre-delivery checklist │
└─────────────────────────────────────────────────────────────────┘
161 Industry-Specific Reasoning Rules
The reasoning engine includes specialized rules for:
CategoryExamplesTech & SaaSSaaS, Micro SaaS, B2B Service, Developer Tool / IDE, AI/Chatbot Platform, Cybersecurity PlatformFinanceFintech/Crypto, Banking, Insurance, Personal Finance Tracker, Invoice & Billing ToolHealthcareMedical Clinic, Pharmacy, Dental, Veterinary, Mental Health, Medication ReminderE-commerceGeneral, Luxury, Marketplace (P2P), Subscription Box, Food DeliveryServicesBeauty/Spa, Restaurant, Hotel, Legal, Home Services, Booking & AppointmentCreativePortfolio, Agency, Photography, Gaming, Music Streaming, Photo/Video EditorLifestyleHabit Tracker, Recipe & Cooking, Meditation, Weather, Diary, Mood TrackerEmerging TechWeb3/NFT, Spatial Computing, Quantum Computing, Autonomous Drone Fleet
Each rule includes:
Recommended Pattern - Landing page structure
Style Priority - Best matching UI styles
Color Mood - Industry-appropriate palettes
Typography Mood - Font personality matching
Key Effects - Animations and interactions
Anti-Patterns - What NOT to do (e.g., "AI purple/pink gradients" for banking)
Features
67 UI Styles - Glassmorphism, Claymorphism, Minimalism, Brutalism, Neumorphism, Bento Grid, Dark Mode, AI-Native UI, and more
161 Color Palettes - Industry-specific palettes aligned 1:1 with the 161 product types
57 Font Pairings - Curated typography combinations with Google Fonts imports
25 Chart Types - Recommendations for dashboards and analytics
15 Tech Stacks - React, Next.js, Astro, Vue, Nuxt.js, Nuxt UI, Svelte, SwiftUI, React Native, Flutter, HTML+Tailwind, shadcn/ui, Jetpack Compose, Angular, Laravel
99 UX Guidelines - Best practices, anti-patterns, and accessibility rules
161 Reasoning Rules - Industry-specific design system generation (NEW in v2.0)
Available Styles (67)
#StyleBest For1Minimalism & Swiss StyleEnterprise apps, dashboards, documentation2NeumorphismHealth/wellness apps, meditation platforms3GlassmorphismModern SaaS, financial dashboards4BrutalismDesign portfolios, artistic projects53D & HyperrealismGaming, product showcase, immersive6Vibrant & Block-basedStartups, creative agencies, gaming7Dark Mode (OLED)Night-mode apps, coding platforms8Accessible & EthicalGovernment, healthcare, education9ClaymorphismEducational apps, children's apps, SaaS10Aurora UIModern SaaS, creative agencies11Retro-FuturismGaming, entertainment, music platforms12Flat DesignWeb apps, mobile apps, startup MVPs13SkeuomorphismLegacy apps, gaming, premium products14Liquid GlassPremium SaaS, high-end e-commerce15Motion-DrivenPortfolio sites, storytelling platforms16Micro-interactionsMobile apps, touchscreen UIs17Inclusive DesignPublic services, education, healthcare18Zero InterfaceVoice assistants, AI platforms19Soft UI EvolutionModern enterprise apps, SaaS20NeubrutalismGen Z brands, startups, Figma-style21Bento Box GridDashboards, product pages, portfolios22Y2K AestheticFashion brands, music, Gen Z23Cyberpunk UIGaming, tech products, crypto apps24Organic BiophilicWellness apps, sustainability brands25AI-Native UIAI products, chatbots, copilots26Memphis DesignCreative agencies, music, youth brands27VaporwaveMusic platforms, gaming, portfolios28Dimensional LayeringDashboards, card layouts, modals29Exaggerated MinimalismFashion, architecture, portfolios30Kinetic TypographyHero sections, marketing sites31Parallax StorytellingBrand storytelling, product launches32Swiss Modernism 2.0Corporate sites, architecture, editorial33HUD / Sci-Fi FUISci-fi games, space tech, cybersecurity34Pixel ArtIndie games, retro tools, creative35Bento GridsProduct features, dashboards, personal36Spatial UI (VisionOS)Spatial computing apps, VR/AR37E-Ink / PaperReading apps, digital newspapers38Gen Z Chaos / MaximalismGen Z lifestyle, music artists39Biomimetic / Organic 2.0Sustainability tech, biotech, health40Anti-Polish / Raw AestheticCreative portfolios, artist sites41Tactile Digital / Deformable UIModern mobile apps, playful brands42Nature DistilledWellness brands, sustainable products43Interactive Cursor DesignCreative portfolios, interactive44Voice-First MultimodalVoice assistants, accessibility apps453D Product PreviewE-commerce, furniture, fashion46Gradient Mesh / Aurora EvolvedHero sections, backgrounds, creative47Editorial Grid / MagazineNews sites, blogs, magazines48Chromatic Aberration / RGB SplitMusic platforms, gaming, tech49Vintage Analog / Retro FilmPhotography, music/vinyl brands
#StyleBest For1Hero-Centric DesignProducts with strong visual identity2Conversion-OptimizedLead generation, sales pages3Feature-Rich ShowcaseSaaS, complex products4Minimal & DirectSimple products, apps5Social Proof-FocusedServices, B2C products6Interactive Product DemoSoftware, tools7Trust & AuthorityB2B, enterprise, consulting8Storytelling-DrivenBrands, agencies, nonprofits
#StyleBest For1Data-Dense DashboardComplex data analysis2Heat Map & Heatmap StyleGeographic/behavior data3Executive DashboardC-suite summaries4Real-Time MonitoringOperations, DevOps5Drill-Down AnalyticsDetailed exploration6Comparative Analysis DashboardSide-by-side comparisons7Predictive AnalyticsForecasting, ML insights8User Behavior AnalyticsUX research, product analytics9Financial DashboardFinance, accounting10Sales Intelligence DashboardSales teams, CRM
Installation
Using Claude Marketplace (Claude Code)
Install directly in Claude Code with two commands:
/plugin marketplace add nextlevelbuilder/ui-ux-pro-max-skill
/plugin install ui-ux-pro-max@ui-ux-pro-max-skill
Using CLI (Recommended)
# Install CLI globally
npm install -g uipro-cli
# Go to your project
cd /path/to/your/project
# Install for your AI assistant
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 all # All assistants
Global Install (Available for All Projects)
uipro init --ai claude --global # Install to ~/.claude/skills/
uipro init --ai cursor --global # Install to ~/.cursor/skills/
Other CLI Commands
uipro versions # List available versions
uipro update # Update to latest version
uipro init --offline # Skip GitHub download, use bundled assets
uipro uninstall # Remove skill (auto-detect platform)
uipro uninstall --ai claude # Remove specific platform
uipro uninstall --global # Remove from global install
Prerequisites
Python 3.x is required for the search script.
# Check if Python is installed
python3 --version
# macOS
brew install python3
# Ubuntu/Debian
sudo apt update && sudo apt install python3
# Windows
winget install Python.Python.3.12
Usage
Skill Mode (Auto-activate)
Supported: Claude Code, Cursor, Windsurf, Antigravity, Codex CLI, Continue, Gemini CLI, OpenCode, Qoder, CodeBuddy, Droid (Factory), KiloCode, Warp, Augment
The skill activates automatically when you request UI/UX work. Just chat naturally:
Build a landing page for my SaaS product
Trae: Switch to SOLO mode first. The skill will activate for UI/UX requests.
Workflow Mode (Slash Command)
Supported: Kiro, GitHub Copilot, Roo Code, KiloCode
Use the slash command to invoke the skill:
/ui-ux-pro-max Build a landing page for my SaaS product
Example Prompts
Build a landing page for my SaaS product
Create a dashboard for healthcare analytics
Design a portfolio website with dark mode
Make a mobile app UI for e-commerce
Build a fintech banking app with dark theme
How It Works
You ask - Request any UI/UX task (build, design, create, implement, review, fix, improve)
Design System Generated - The AI automatically generates a complete design system using the reasoning engine
Smart recommendations - Based on your product type and requirements, it finds the best matching styles, colors, and typography
Code generation - Implements the UI with proper colors, fonts, spacing, and best practices
Pre-delivery checks - Validates against common UI/UX anti-patterns
Supported Stacks
The skill provides stack-specific guidelines for:
CategoryStacksWeb (HTML)HTML + Tailwind (default)React EcosystemReact, Next.js, shadcn/uiVue EcosystemVue, Nuxt.js, Nuxt UIAngularAngularPHPLaravel (Blade, Livewire, Inertia.js)Other WebSvelte, AstroiOSSwiftUIAndroidJetpack ComposeCross-PlatformReact Native, Flutter
Just mention your preferred stack in the prompt, or let it default to HTML + Tailwind.
Design System Command (Advanced)
For direct access to the design system generator:
Note: If you installed via Continue, replace
.claude/skills/with.continue/skills/in the commands below. For Droid (Factory), use.factory/skills/.
# Generate design system with ASCII output
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness" --design-system -p "Serenity Spa"
# Generate with Markdown output
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "fintech banking" --design-system -f markdown
# Domain-specific search
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
# Stack-specific guidelines
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
Persist Design System (Master + Overrides Pattern)
Save your design system to files for hierarchical retrieval across sessions:
# Generate and persist to design-system/MASTER.md
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "SaaS dashboard" --design-system --persist -p "MyApp"
# Also create a page-specific override file
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "SaaS dashboard" --design-system --persist -p "MyApp" --page "dashboard"
This creates a design-system/ folder structure:
design-system/
├── MASTER.md # Global Source of Truth (colors, typography, spacing, components)
└── pages/
└── dashboard.md # Page-specific overrides (only deviations from Master)
How hierarchical retrieval works:
When building a specific page (e.g., "Checkout"), first check
design-system/pages/checkout.mdIf the page file exists, its rules override the Master file
If not, use
design-system/MASTER.mdexclusively
Context-aware retrieval prompt:
I am building the [Page Name] page. Please read design-system/MASTER.md.
Also check if design-system/pages/[page-name].md exists.
If the page file exists, prioritize its rules.
If not, use the Master rules exclusively.
Now, generate the code...
Architecture & Contributing
For Users
The codebase has been restructured to use a template-based generation system. All platform-specific files (.cursor/, .windsurf/, .kiro/, .factory/, etc.) are now generated dynamically by the CLI.
Always use the CLI to install:
npm install -g uipro-cli
uipro init --ai <platform>
This ensures you get the latest templates and correct file structure for your AI assistant.
For Contributors
If you want to contribute to this project:
# 1. Clone the repository
git clone https://github.com/nextlevelbuilder/ui-ux-pro-max-skill.git
cd ui-ux-pro-max-skill
# 2. Understand the structure
src/ui-ux-pro-max/ # Source of truth (data, scripts, templates)
cli/ # CLI installer (generates files from templates)
.claude/ # Local dev/test for Claude Code skill
.factory/ # Local dev/test for Droid (Factory) skill
# 3. Make changes in src/ui-ux-pro-max/
# - data/*.csv → Database files
# - scripts/*.py → Search engine & design system
# - templates/ → Platform-specific templates
# 4. Sync to CLI and test locally
cp -r src/ui-ux-pro-max/data/* cli/assets/data/
cp -r src/ui-ux-pro-max/scripts/* cli/assets/scripts/
cp -r src/ui-ux-pro-max/templates/* cli/assets/templates/
# 5. Build and test CLI
cd cli && bun run build
node dist/index.js init --ai claude --offline # Test in a temp folder
# 6. Create PR (never push directly to main)
git checkout -b feat/your-feature
git commit -m "feat: description"
git push -u origin feat/your-feature
gh pr create
See CLAUDE.md for detailed development guidelines.
Star History
License
This project is licensed under the MIT License.
On this page
- What's New in v2.0
- Intelligent Design System Generation
- How Design System Generation Works
- 161 Industry-Specific Reasoning Rules
- Features
- Available Styles (67)
- Installation
- Using Claude Marketplace (Claude Code)
- Using CLI (Recommended)
- Global Install (Available for All Projects)
- Other CLI Commands
- Prerequisites
- Usage
- Skill Mode (Auto-activate)
- Workflow Mode (Slash Command)
- Example Prompts
- How It Works
- Supported Stacks
- Design System Command (Advanced)
- Persist Design System (Master + Overrides Pattern)
- Architecture & Contributing
- For Users
- For Contributors
- Star History
- License