UI/UX Pro Max - Design Intelligence
Searchable database of UI styles, color palettes, font pairings, chart types, product recommendations, UX guidelines, and stack-specific best practices.
Summary
Goal: Provide design intelligence (styles, color palettes, font pairings, UX guidelines) as a searchable database to inform UI/UX decisions before implementation.
| Step |
Action |
Key Notes |
| 1 |
Analyze requirements |
Extract product type, style keywords, industry, stack |
| 2 |
Search domains |
Use search.py for product, style, color, font, UX data |
| 3 |
Compile recommendations |
Style guide, palette, typography, UX patterns |
| 4 |
Deliver design brief |
Tech-agnostic recommendations ready for implementation |
Key Principles:
- Use FIRST before implementation — design decisions before code
- Tech-agnostic: works with React, Vue, Angular, Flutter, any stack
- For React component implementation, use shadcn-tailwind after this skill
Prerequisites
Check if Python is installed:
python3 --version || python --version
If Python is not installed, install it based on user's OS:
macOS:
brew install python3
Ubuntu/Debian:
sudo apt update && sudo apt install python3
Windows:
winget install Python.Python.3.12
How to Use This Skill
When user requests UI/UX work (design, build, create, implement, review, fix, improve), follow this workflow:
Step 1: Analyze User Requirements
Extract key information from user request:
- Product type: SaaS, e-commerce, portfolio, dashboard, landing page, etc.
- Style keywords: minimal, playful, professional, elegant, dark mode, etc.
- Industry: healthcare, fintech, gaming, education, etc.
- Stack: React, Vue, Next.js, or default to
html-tailwind
Step 2: Search Relevant Domains
Use search.py multiple times to gather comprehensive information. Search until you have enough context.
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "<keyword>" --domain <domain> [-n <max_results>]
Recommended search order:
- Product - Get style recommendations for product type
- Style - Get detailed style guide (colors, effects, frameworks)
- Typography - Get font pairings with Google Fonts imports
- Color - Get color palette (Primary, Secondary, CTA, Background, Text, Border)
- Landing - Get page structure (if landing page)
- Chart - Get chart recommendations (if dashboard/analytics)
- UX - Get best practices and anti-patterns
- Stack - Get stack-specific guidelines (default: html-tailwind)
Step 3: Stack Guidelines (Default: html-tailwind)
If user doesn't specify a stack, default to html-tailwind.
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "<keyword>" --stack html-tailwind
Available stacks: html-tailwind, react, nextjs, vue, svelte, swiftui, react-native, flutter
Search Reference
Available Domains
| Domain |
Use For |
Example Keywords |
product |
Product type recommendations |
SaaS, e-commerce, portfolio, healthcare, beauty, service |
style |
UI styles, colors, effects |
glassmorphism, minimalism, dark mode, brutalism |
typography |
Font pairings, Google Fonts |
elegant, playful, professional, modern |
color |
Color palettes by product type |
saas, ecommerce, healthcare, beauty, fintech, service |
landing |
Page structure, CTA strategies |
hero, hero-centric, testimonial, pricing, social-proof |
chart |
Chart types, library recommendations |
trend, comparison, timeline, funnel, pie |
ux |
Best practices, anti-patterns |
animation, accessibility, z-index, loading |
prompt |
AI prompts, CSS keywords |
(style name) |
Available Stacks
| Stack |
Focus |
html-tailwind |
Tailwind utilities, responsive, a11y (DEFAULT) |
react |
State, hooks, performance, patterns |
nextjs |
SSR, routing, images, API routes |
vue |
Composition API, Pinia, Vue Router |
svelte |
Runes, stores, SvelteKit |
swiftui |
Views, State, Navigation, Animation |
react-native |
Components, Navigation, Lists |
flutter |
Widgets, State, Layout, Theming |
Example Workflow
User request: "Làm landing page cho dịch vụ chăm sóc da chuyên nghiệp"
AI should:
# 1. Search product type
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness service" --domain product
# 2. Search style (based on industry: beauty, elegant)
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "elegant minimal soft" --domain style
# 3. Search typography
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "elegant luxury" --domain typography
# 4. Search color palette
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness" --domain color
# 5. Search landing page structure
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "hero-centric social-proof" --domain landing
# 6. Search UX guidelines
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "animation" --domain ux
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "accessibility" --domain ux
# 7. Search stack guidelines (default: html-tailwind)
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "layout responsive" --stack html-tailwind
Then: Synthesize all search results and implement the design.
Tips for Better Results
- Be specific with keywords - "healthcare SaaS dashboard" > "app"
- Search multiple times - Different keywords reveal different insights
- Combine domains - Style + Typography + Color = Complete design system
- Always check UX - Search "animation", "z-index", "accessibility" for common issues
- Use stack flag - Get implementation-specific best practices
- Iterate - If first search doesn't match, try different keywords
Common Rules for Professional UI
These are frequently overlooked issues that make UI look unprofessional:
Icons & Visual Elements
| Rule |
Do |
Don't |
| No emoji icons |
Use SVG icons (Heroicons, Lucide, Simple Icons) |
Use emojis like 🎨 🚀 ⚙️ as UI icons |
| Stable hover states |
Use color/opacity transitions on hover |
Use scale transforms that shift layout |
| Correct brand logos |
Research official SVG from Simple Icons |
Guess or use incorrect logo paths |
| Consistent icon sizing |
Use fixed viewBox (24x24) with w-6 h-6 |
Mix different icon sizes randomly |
Interaction & Cursor
| Rule |
Do |
Don't |
| Cursor pointer |
Add cursor-pointer to all clickable/hoverable cards |
Leave default cursor on interactive elements |
| Hover feedback |
Provide visual feedback (color, shadow, border) |
No indication element is interactive |
| Smooth transitions |
Use transition-colors duration-200 |
Instant state changes or too slow (>500ms) |
Light/Dark Mode Contrast
| Rule |
Do |
Don't |
| Glass card light mode |
Use bg-white/80 or higher opacity |
Use bg-white/10 (too transparent) |
| Text contrast light |
Use #0F172A (slate-900) for text |
Use #94A3B8 (slate-400) for body text |
| Muted text light |
Use #475569 (slate-600) minimum |
Use gray-400 or lighter |
| Border visibility |
Use border-gray-200 in light mode |
Use border-white/10 (invisible) |
Layout & Spacing
| Rule |
Do |
Don't |
| Floating navbar |
Add top-4 left-4 right-4 spacing |
Stick navbar to top-0 left-0 right-0 |
| Content padding |
Account for fixed navbar height |
Let content hide behind fixed elements |
| Consistent max-width |
Use same max-w-6xl or max-w-7xl |
Mix different container widths |
Pre-Delivery Checklist
Before delivering UI code, verify these items:
Visual Quality
Interaction
Light/Dark Mode
Layout
Accessibility
IMPORTANT Task Planning Notes
- Always plan and break many small todo tasks
- Always add a final review todo task to review the works done at the end to find any fix or enhancement needed
1---2name: ui-ux-pro-max-643description: "[Utilities] Design intelligence database for UI/UX decisions (tech-agnostic). Use FIRST when planning beautiful interfaces - provides style recommendations, color palettes, font pairings, UX guidelines BEFORE implementation. Searchable: 50 styles (glassmorphism, minimalism, brutalism), 21 color palettes, 50 font pairings, chart recommendations, landing page structures, accessibility patterns. Works with any stack (React, Vue, Angular, Flutter). For React component implementation, use shadcn-tailwind instead. Triggers on: beautiful UI, design system, color palette, font pairing, UX review, style guide."4metadata:5 source: https://skillmd.com/skills/diegosouzapw/ui-ux-pro-max-646---78# UI/UX Pro Max - Design Intelligence910Searchable database of UI styles, color palettes, font pairings, chart types, product recommendations, UX guidelines, and stack-specific best practices.1112## Summary1314**Goal:** Provide design intelligence (styles, color palettes, font pairings, UX guidelines) as a searchable database to inform UI/UX decisions before implementation.1516| Step | Action | Key Notes |17|------|--------|-----------|18| 1 | Analyze requirements | Extract product type, style keywords, industry, stack |19| 2 | Search domains | Use `search.py` for product, style, color, font, UX data |20| 3 | Compile recommendations | Style guide, palette, typography, UX patterns |21| 4 | Deliver design brief | Tech-agnostic recommendations ready for implementation |2223**Key Principles:**24- Use FIRST before implementation — design decisions before code25- Tech-agnostic: works with React, Vue, Angular, Flutter, any stack26- For React component implementation, use shadcn-tailwind after this skill2728## Prerequisites2930Check if Python is installed:3132```bash33python3 --version || python --version34```3536If Python is not installed, install it based on user's OS:3738**macOS:**39```bash40brew install python341```4243**Ubuntu/Debian:**44```bash45sudo apt update && sudo apt install python346```4748**Windows:**49```powershell50winget install Python.Python.3.1251```5253---5455## How to Use This Skill5657When user requests UI/UX work (design, build, create, implement, review, fix, improve), follow this workflow:5859### Step 1: Analyze User Requirements6061Extract key information from user request:62- **Product type**: SaaS, e-commerce, portfolio, dashboard, landing page, etc.63- **Style keywords**: minimal, playful, professional, elegant, dark mode, etc.64- **Industry**: healthcare, fintech, gaming, education, etc.65- **Stack**: React, Vue, Next.js, or default to `html-tailwind`6667### Step 2: Search Relevant Domains6869Use `search.py` multiple times to gather comprehensive information. Search until you have enough context.7071```bash72python3 .claude/skills/ui-ux-pro-max/scripts/search.py "<keyword>" --domain <domain> [-n <max_results>]73```7475**Recommended search order:**76771. **Product** - Get style recommendations for product type782. **Style** - Get detailed style guide (colors, effects, frameworks)793. **Typography** - Get font pairings with Google Fonts imports804. **Color** - Get color palette (Primary, Secondary, CTA, Background, Text, Border)815. **Landing** - Get page structure (if landing page)826. **Chart** - Get chart recommendations (if dashboard/analytics)837. **UX** - Get best practices and anti-patterns848. **Stack** - Get stack-specific guidelines (default: html-tailwind)8586### Step 3: Stack Guidelines (Default: html-tailwind)8788If user doesn't specify a stack, **default to `html-tailwind`**.8990```bash91python3 .claude/skills/ui-ux-pro-max/scripts/search.py "<keyword>" --stack html-tailwind92```9394Available stacks: `html-tailwind`, `react`, `nextjs`, `vue`, `svelte`, `swiftui`, `react-native`, `flutter`9596---9798## Search Reference99100### Available Domains101102| Domain | Use For | Example Keywords |103| ------------ | ------------------------------------ | -------------------------------------------------------- |104| `product` | Product type recommendations | SaaS, e-commerce, portfolio, healthcare, beauty, service |105| `style` | UI styles, colors, effects | glassmorphism, minimalism, dark mode, brutalism |106| `typography` | Font pairings, Google Fonts | elegant, playful, professional, modern |107| `color` | Color palettes by product type | saas, ecommerce, healthcare, beauty, fintech, service |108| `landing` | Page structure, CTA strategies | hero, hero-centric, testimonial, pricing, social-proof |109| `chart` | Chart types, library recommendations | trend, comparison, timeline, funnel, pie |110| `ux` | Best practices, anti-patterns | animation, accessibility, z-index, loading |111| `prompt` | AI prompts, CSS keywords | (style name) |112113### Available Stacks114115| Stack | Focus |116| --------------- | ---------------------------------------------- |117| `html-tailwind` | Tailwind utilities, responsive, a11y (DEFAULT) |118| `react` | State, hooks, performance, patterns |119| `nextjs` | SSR, routing, images, API routes |120| `vue` | Composition API, Pinia, Vue Router |121| `svelte` | Runes, stores, SvelteKit |122| `swiftui` | Views, State, Navigation, Animation |123| `react-native` | Components, Navigation, Lists |124| `flutter` | Widgets, State, Layout, Theming |125126---127128## Example Workflow129130**User request:** "Làm landing page cho dịch vụ chăm sóc da chuyên nghiệp"131132**AI should:**133134```bash135# 1. Search product type136python3 .claude/skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness service" --domain product137138# 2. Search style (based on industry: beauty, elegant)139python3 .claude/skills/ui-ux-pro-max/scripts/search.py "elegant minimal soft" --domain style140141# 3. Search typography142python3 .claude/skills/ui-ux-pro-max/scripts/search.py "elegant luxury" --domain typography143144# 4. Search color palette145python3 .claude/skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness" --domain color146147# 5. Search landing page structure148python3 .claude/skills/ui-ux-pro-max/scripts/search.py "hero-centric social-proof" --domain landing149150# 6. Search UX guidelines151python3 .claude/skills/ui-ux-pro-max/scripts/search.py "animation" --domain ux152python3 .claude/skills/ui-ux-pro-max/scripts/search.py "accessibility" --domain ux153154# 7. Search stack guidelines (default: html-tailwind)155python3 .claude/skills/ui-ux-pro-max/scripts/search.py "layout responsive" --stack html-tailwind156```157158**Then:** Synthesize all search results and implement the design.159160---161162## Tips for Better Results1631641. **Be specific with keywords** - "healthcare SaaS dashboard" > "app"1652. **Search multiple times** - Different keywords reveal different insights1663. **Combine domains** - Style + Typography + Color = Complete design system1674. **Always check UX** - Search "animation", "z-index", "accessibility" for common issues1685. **Use stack flag** - Get implementation-specific best practices1696. **Iterate** - If first search doesn't match, try different keywords170171---172173## Common Rules for Professional UI174175These are frequently overlooked issues that make UI look unprofessional:176177### Icons & Visual Elements178179| Rule | Do | Don't |180| -------------------------- | ----------------------------------------------- | -------------------------------------- |181| **No emoji icons** | Use SVG icons (Heroicons, Lucide, Simple Icons) | Use emojis like 🎨 🚀 ⚙️ as UI icons |182| **Stable hover states** | Use color/opacity transitions on hover | Use scale transforms that shift layout |183| **Correct brand logos** | Research official SVG from Simple Icons | Guess or use incorrect logo paths |184| **Consistent icon sizing** | Use fixed viewBox (24x24) with w-6 h-6 | Mix different icon sizes randomly |185186### Interaction & Cursor187188| Rule | Do | Don't |189| ---------------------- | ----------------------------------------------------- | -------------------------------------------- |190| **Cursor pointer** | Add `cursor-pointer` to all clickable/hoverable cards | Leave default cursor on interactive elements |191| **Hover feedback** | Provide visual feedback (color, shadow, border) | No indication element is interactive |192| **Smooth transitions** | Use `transition-colors duration-200` | Instant state changes or too slow (>500ms) |193194### Light/Dark Mode Contrast195196| Rule | Do | Don't |197| ------------------------- | ----------------------------------- | --------------------------------------- |198| **Glass card light mode** | Use `bg-white/80` or higher opacity | Use `bg-white/10` (too transparent) |199| **Text contrast light** | Use `#0F172A` (slate-900) for text | Use `#94A3B8` (slate-400) for body text |200| **Muted text light** | Use `#475569` (slate-600) minimum | Use gray-400 or lighter |201| **Border visibility** | Use `border-gray-200` in light mode | Use `border-white/10` (invisible) |202203### Layout & Spacing204205| Rule | Do | Don't |206| ------------------------ | ----------------------------------- | -------------------------------------- |207| **Floating navbar** | Add `top-4 left-4 right-4` spacing | Stick navbar to `top-0 left-0 right-0` |208| **Content padding** | Account for fixed navbar height | Let content hide behind fixed elements |209| **Consistent max-width** | Use same `max-w-6xl` or `max-w-7xl` | Mix different container widths |210211---212213## Pre-Delivery Checklist214215Before delivering UI code, verify these items:216217### Visual Quality218- [ ] No emojis used as icons (use SVG instead)219- [ ] All icons from consistent icon set (Heroicons/Lucide)220- [ ] Brand logos are correct (verified from Simple Icons)221- [ ] Hover states don't cause layout shift222223### Interaction224- [ ] All clickable elements have `cursor-pointer`225- [ ] Hover states provide clear visual feedback226- [ ] Transitions are smooth (150-300ms)227- [ ] Focus states visible for keyboard navigation228229### Light/Dark Mode230- [ ] Light mode text has sufficient contrast (4.5:1 minimum)231- [ ] Glass/transparent elements visible in light mode232- [ ] Borders visible in both modes233- [ ] Test both modes before delivery234235### Layout236- [ ] Floating elements have proper spacing from edges237- [ ] No content hidden behind fixed navbars238- [ ] Responsive at 320px, 768px, 1024px, 1440px239- [ ] No horizontal scroll on mobile240241### Accessibility242- [ ] All images have alt text243- [ ] Form inputs have labels244- [ ] Color is not the only indicator245- [ ] `prefers-reduced-motion` respected246247## IMPORTANT Task Planning Notes248249- Always plan and break many small todo tasks250- Always add a final review todo task to review the works done at the end to find any fix or enhancement needed