UI/UX Pro Max
Searchable design database with CLI for generating complete design systems from natural language queries.
See also: ui-design for fundamentals and decision-making. This skill provides data-driven recommendations via CLI.
When to Use
- Designing new UI components or pages
- Choosing color palettes and typography
- Reviewing code for UX issues
- Building landing pages or dashboards
- Implementing accessibility requirements
Rule Categories by Priority
| Priority |
Category |
Impact |
Domain |
| 1 |
Accessibility |
CRITICAL |
ux |
| 2 |
Touch & Interaction |
CRITICAL |
ux |
| 3 |
Performance |
HIGH |
ux |
| 4 |
Layout & Responsive |
HIGH |
ux |
| 5 |
Typography & Color |
MEDIUM |
typography, color |
| 6 |
Animation |
MEDIUM |
ux |
| 7 |
Style Selection |
MEDIUM |
style, product |
| 8 |
Charts & Data |
LOW |
chart |
Quick Reference
Accessibility (CRITICAL)
color-contrast — Minimum 4.5:1 ratio for normal text
focus-states — Visible focus rings on interactive elements
alt-text — Descriptive alt text for meaningful images
aria-labels — aria-label for icon-only buttons
keyboard-nav — Tab order matches visual order
form-labels — Use label with for attribute
Touch & Interaction (CRITICAL)
touch-target-size — Minimum 44x44px touch targets
hover-vs-tap — Use click/tap for primary interactions
loading-buttons — Disable button during async operations
error-feedback — Clear error messages near the problem
cursor-pointer — Add cursor-pointer to clickable elements
Performance (HIGH)
image-optimization — Use WebP, srcset, lazy loading
reduced-motion — Check prefers-reduced-motion
content-jumping — Reserve space for async content
Layout & Responsive (HIGH)
viewport-meta — width=device-width initial-scale=1
readable-font-size — Minimum 16px body text on mobile
horizontal-scroll — Ensure content fits viewport width
z-index-management — Define z-index scale (10, 20, 30, 50)
Typography & Color (MEDIUM)
line-height — Use 1.5-1.75 for body text
line-length — Limit to 65-75 characters per line
font-pairing — Match heading/body font personalities
Animation (MEDIUM)
duration-timing — Use 150-300ms for micro-interactions
transform-performance — Use transform/opacity, not width/height
loading-states — Skeleton screens or spinners
Style Selection (MEDIUM)
style-match — Match style to product type
consistency — Use same style across all pages
no-emoji-icons — Use SVG icons, not emojis
Charts & Data (LOW)
chart-type — Match chart type to data type
color-guidance — Use accessible color palettes
data-table — Provide table alternative for accessibility
Installation
OpenClaw / Moltbot / Clawbot
npx clawhub@latest install ui-ux-pro-max
Prerequisites
Python 3 is required for the search CLI.
python3 --version
Workflow
When a user requests UI/UX work (design, build, create, implement, review, fix, improve), follow these steps.
Step 1: Analyze Requirements
Extract from the user request:
- Product type: SaaS, e-commerce, portfolio, dashboard, landing page
- Style keywords: minimal, playful, professional, elegant, dark mode
- Industry: healthcare, fintech, gaming, education
- Stack: React, Vue, Next.js, or default to
html-tailwind
Step 2: Generate Design System
Always start with --design-system to get comprehensive recommendations:
python3 scripts/search.py "<product_type> <industry> <keywords>" --design-system [-p "Project Name"]
This searches 5 domains in parallel (product, style, color, landing, typography), applies reasoning rules from ui-reasoning.csv, and returns a complete design system: pattern, style, colors, typography, effects, and anti-patterns.
Example:
python3 scripts/search.py "beauty spa wellness service" --design-system -p "Serenity Spa"
Step 2b: Persist Design System
Save the design system for hierarchical retrieval across sessions:
python3 scripts/search.py "<query>" --design-system --persist -p "Project Name"
Creates:
design-system/MASTER.md — Global source of truth
design-system/pages/ — Folder for page-specific overrides
With page override:
python3 scripts/search.py "<query>" --design-system --persist -p "Project Name" --page "dashboard"
Hierarchical retrieval: When building a specific page, check design-system/pages/<page>.md first. If it exists, its rules override the Master file. Otherwise use design-system/MASTER.md exclusively.
Step 3: Supplement with Domain Searches
After generating the design system, use domain searches for additional detail:
python3 scripts/search.py "<keyword>" --domain <domain> [-n <max_results>]
| Need |
Domain |
Example |
| More style options |
style |
--domain style "glassmorphism dark" |
| Chart recommendations |
chart |
--domain chart "real-time dashboard" |
| UX best practices |
ux |
--domain ux "animation accessibility" |
| Alternative fonts |
typography |
--domain typography "elegant luxury" |
| Landing structure |
landing |
--domain landing "hero social-proof" |
Step 4: Stack Guidelines
Get implementation-specific best practices. Default to html-tailwind if unspecified.
python3 scripts/search.py "<keyword>" --stack html-tailwind
Available stacks: html-tailwind, react, nextjs, vue, svelte, swiftui, react-native, flutter, shadcn, jetpack-compose
Search Reference
Domains
| Domain |
Use For |
Example Keywords |
product |
Product type recommendations |
SaaS, e-commerce, portfolio, healthcare |
style |
UI styles, colors, effects |
glassmorphism, minimalism, dark mode |
typography |
Font pairings, Google Fonts |
elegant, playful, professional |
color |
Color palettes by product type |
saas, ecommerce, healthcare, fintech |
landing |
Page structure, CTA strategies |
hero, testimonial, pricing, social-proof |
chart |
Chart types, library recs |
trend, comparison, timeline, funnel |
ux |
Best practices, anti-patterns |
animation, accessibility, z-index |
react |
React/Next.js performance |
waterfall, bundle, suspense, memo |
web |
Web interface guidelines |
aria, focus, keyboard, semantic |
prompt |
AI prompts, CSS keywords |
(style name) |
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 |
shadcn |
shadcn/ui components, theming, forms |
jetpack-compose |
Composables, Modifiers, State Hoisting |
Output Formats
# ASCII box (default) — best for terminal display
python3 scripts/search.py "fintech crypto" --design-system
# Markdown — best for documentation
python3 scripts/search.py "fintech crypto" --design-system -f markdown
Example Workflow
User request: "Build a landing page for a professional skincare service"
Step 1 — Analyze: Beauty/Spa service, elegant/professional, html-tailwind default.
Step 2 — Design system:
python3 scripts/search.py "beauty spa wellness service elegant" --design-system -p "Serenity Spa"
Step 3 — Supplement:
python3 scripts/search.py "animation accessibility" --domain ux
python3 scripts/search.py "elegant luxury serif" --domain typography
Step 4 — Stack:
python3 scripts/search.py "layout responsive form" --stack html-tailwind
Then synthesize design system + detailed searches and implement.
Search Tips
- Be specific — "healthcare SaaS dashboard" beats "app"
- Search multiple times — Different keywords reveal different insights
- Combine domains — Style + Typography + Color = complete system
- Always check UX — Search "animation", "z-index", "accessibility" for common issues
- Use the stack flag — Get implementation-specific best practices
- Iterate — If first search misses, try different keywords
Common Rules for Professional UI
Icons & Visual Elements
| Rule |
Do |
Don't |
| No emoji icons |
Use SVG icons (Heroicons, Lucide, Simple Icons) |
Use emojis as UI icons |
| Stable hover states |
Use color/opacity transitions |
Use scale transforms that shift layout |
| Correct brand logos |
Research official SVG from Simple Icons |
Guess or use incorrect logo paths |
| Consistent icon sizing |
Fixed viewBox (24x24) with w-6 h-6 |
Mix different icon sizes |
Interaction & Cursor
| Rule |
Do |
Don't |
| Cursor pointer |
cursor-pointer on all clickable elements |
Leave default cursor on interactive elements |
| Hover feedback |
Visual feedback (color, shadow, border) |
No indication element is interactive |
| Smooth transitions |
transition-colors duration-200 |
Instant changes or >500ms |
Light/Dark Mode Contrast
| Rule |
Do |
Don't |
| Glass card (light) |
bg-white/80 or higher opacity |
bg-white/10 (too transparent) |
| Text contrast (light) |
#0F172A (slate-900) for text |
#94A3B8 (slate-400) for body text |
| Muted text (light) |
#475569 (slate-600) minimum |
gray-400 or lighter |
| Border visibility |
border-gray-200 in light mode |
border-white/10 (invisible) |
Layout & Spacing
| Rule |
Do |
Don't |
| Floating navbar |
top-4 left-4 right-4 spacing |
Stick to top-0 left-0 right-0 |
| Content padding |
Account for fixed navbar height |
Let content hide behind fixed elements |
| Consistent max-width |
Same max-w-6xl or max-w-7xl |
Mix different container widths |
Pre-Delivery Checklist
Visual Quality
Interaction
Light/Dark Mode
Layout
Accessibility
1---2name: ui-ux-pro-max3description: Searchable UI/UX design databases: 50+ styles, 97 palettes, 57 font pairings, 99 UX rules, 25 chart types. CLI generates design systems from natural language. Data-driven complement to ui-design.4---56# UI/UX Pro Max78Searchable design database with CLI for generating complete design systems from natural language queries.910> **See also:** `ui-design` for fundamentals and decision-making. This skill provides data-driven recommendations via CLI.1112## When to Use1314- Designing new UI components or pages15- Choosing color palettes and typography16- Reviewing code for UX issues17- Building landing pages or dashboards18- Implementing accessibility requirements1920## Rule Categories by Priority2122| Priority | Category | Impact | Domain |23|----------|----------|--------|--------|24| 1 | Accessibility | CRITICAL | `ux` |25| 2 | Touch & Interaction | CRITICAL | `ux` |26| 3 | Performance | HIGH | `ux` |27| 4 | Layout & Responsive | HIGH | `ux` |28| 5 | Typography & Color | MEDIUM | `typography`, `color` |29| 6 | Animation | MEDIUM | `ux` |30| 7 | Style Selection | MEDIUM | `style`, `product` |31| 8 | Charts & Data | LOW | `chart` |3233## Quick Reference3435### Accessibility (CRITICAL)3637- `color-contrast` — Minimum 4.5:1 ratio for normal text38- `focus-states` — Visible focus rings on interactive elements39- `alt-text` — Descriptive alt text for meaningful images40- `aria-labels` — aria-label for icon-only buttons41- `keyboard-nav` — Tab order matches visual order42- `form-labels` — Use label with for attribute4344### Touch & Interaction (CRITICAL)4546- `touch-target-size` — Minimum 44x44px touch targets47- `hover-vs-tap` — Use click/tap for primary interactions48- `loading-buttons` — Disable button during async operations49- `error-feedback` — Clear error messages near the problem50- `cursor-pointer` — Add cursor-pointer to clickable elements5152### Performance (HIGH)5354- `image-optimization` — Use WebP, srcset, lazy loading55- `reduced-motion` — Check prefers-reduced-motion56- `content-jumping` — Reserve space for async content5758### Layout & Responsive (HIGH)5960- `viewport-meta` — width=device-width initial-scale=161- `readable-font-size` — Minimum 16px body text on mobile62- `horizontal-scroll` — Ensure content fits viewport width63- `z-index-management` — Define z-index scale (10, 20, 30, 50)6465### Typography & Color (MEDIUM)6667- `line-height` — Use 1.5-1.75 for body text68- `line-length` — Limit to 65-75 characters per line69- `font-pairing` — Match heading/body font personalities7071### Animation (MEDIUM)7273- `duration-timing` — Use 150-300ms for micro-interactions74- `transform-performance` — Use transform/opacity, not width/height75- `loading-states` — Skeleton screens or spinners7677### Style Selection (MEDIUM)7879- `style-match` — Match style to product type80- `consistency` — Use same style across all pages81- `no-emoji-icons` — Use SVG icons, not emojis8283### Charts & Data (LOW)8485- `chart-type` — Match chart type to data type86- `color-guidance` — Use accessible color palettes87- `data-table` — Provide table alternative for accessibility888990## Installation9192### OpenClaw / Moltbot / Clawbot9394```bash95npx clawhub@latest install ui-ux-pro-max96```979899---100101## Prerequisites102103Python 3 is required for the search CLI.104105```bash106python3 --version107```108109---110111## Workflow112113When a user requests UI/UX work (design, build, create, implement, review, fix, improve), follow these steps.114115### Step 1: Analyze Requirements116117Extract from the user request:118- **Product type**: SaaS, e-commerce, portfolio, dashboard, landing page119- **Style keywords**: minimal, playful, professional, elegant, dark mode120- **Industry**: healthcare, fintech, gaming, education121- **Stack**: React, Vue, Next.js, or default to `html-tailwind`122123### Step 2: Generate Design System124125Always start with `--design-system` to get comprehensive recommendations:126127```bash128python3 scripts/search.py "<product_type> <industry> <keywords>" --design-system [-p "Project Name"]129```130131This searches 5 domains in parallel (product, style, color, landing, typography), applies reasoning rules from `ui-reasoning.csv`, and returns a complete design system: pattern, style, colors, typography, effects, and anti-patterns.132133**Example:**134135```bash136python3 scripts/search.py "beauty spa wellness service" --design-system -p "Serenity Spa"137```138139### Step 2b: Persist Design System140141Save the design system for hierarchical retrieval across sessions:142143```bash144python3 scripts/search.py "<query>" --design-system --persist -p "Project Name"145```146147Creates:148- `design-system/MASTER.md` — Global source of truth149- `design-system/pages/` — Folder for page-specific overrides150151**With page override:**152153```bash154python3 scripts/search.py "<query>" --design-system --persist -p "Project Name" --page "dashboard"155```156157**Hierarchical retrieval**: When building a specific page, check `design-system/pages/<page>.md` first. If it exists, its rules override the Master file. Otherwise use `design-system/MASTER.md` exclusively.158159### Step 3: Supplement with Domain Searches160161After generating the design system, use domain searches for additional detail:162163```bash164python3 scripts/search.py "<keyword>" --domain <domain> [-n <max_results>]165```166167| Need | Domain | Example |168|------|--------|---------|169| More style options | `style` | `--domain style "glassmorphism dark"` |170| Chart recommendations | `chart` | `--domain chart "real-time dashboard"` |171| UX best practices | `ux` | `--domain ux "animation accessibility"` |172| Alternative fonts | `typography` | `--domain typography "elegant luxury"` |173| Landing structure | `landing` | `--domain landing "hero social-proof"` |174175### Step 4: Stack Guidelines176177Get implementation-specific best practices. Default to `html-tailwind` if unspecified.178179```bash180python3 scripts/search.py "<keyword>" --stack html-tailwind181```182183Available stacks: `html-tailwind`, `react`, `nextjs`, `vue`, `svelte`, `swiftui`, `react-native`, `flutter`, `shadcn`, `jetpack-compose`184185---186187## Search Reference188189### Domains190191| Domain | Use For | Example Keywords |192|--------|---------|------------------|193| `product` | Product type recommendations | SaaS, e-commerce, portfolio, healthcare |194| `style` | UI styles, colors, effects | glassmorphism, minimalism, dark mode |195| `typography` | Font pairings, Google Fonts | elegant, playful, professional |196| `color` | Color palettes by product type | saas, ecommerce, healthcare, fintech |197| `landing` | Page structure, CTA strategies | hero, testimonial, pricing, social-proof |198| `chart` | Chart types, library recs | trend, comparison, timeline, funnel |199| `ux` | Best practices, anti-patterns | animation, accessibility, z-index |200| `react` | React/Next.js performance | waterfall, bundle, suspense, memo |201| `web` | Web interface guidelines | aria, focus, keyboard, semantic |202| `prompt` | AI prompts, CSS keywords | (style name) |203204### Stacks205206| Stack | Focus |207|-------|-------|208| `html-tailwind` | Tailwind utilities, responsive, a11y (DEFAULT) |209| `react` | State, hooks, performance, patterns |210| `nextjs` | SSR, routing, images, API routes |211| `vue` | Composition API, Pinia, Vue Router |212| `svelte` | Runes, stores, SvelteKit |213| `swiftui` | Views, State, Navigation, Animation |214| `react-native` | Components, Navigation, Lists |215| `flutter` | Widgets, State, Layout, Theming |216| `shadcn` | shadcn/ui components, theming, forms |217| `jetpack-compose` | Composables, Modifiers, State Hoisting |218219### Output Formats220221```bash222# ASCII box (default) — best for terminal display223python3 scripts/search.py "fintech crypto" --design-system224225# Markdown — best for documentation226python3 scripts/search.py "fintech crypto" --design-system -f markdown227```228229---230231## Example Workflow232233**User request:** "Build a landing page for a professional skincare service"234235**Step 1 — Analyze:** Beauty/Spa service, elegant/professional, html-tailwind default.236237**Step 2 — Design system:**238239```bash240python3 scripts/search.py "beauty spa wellness service elegant" --design-system -p "Serenity Spa"241```242243**Step 3 — Supplement:**244245```bash246python3 scripts/search.py "animation accessibility" --domain ux247python3 scripts/search.py "elegant luxury serif" --domain typography248```249250**Step 4 — Stack:**251252```bash253python3 scripts/search.py "layout responsive form" --stack html-tailwind254```255256Then synthesize design system + detailed searches and implement.257258---259260## Search Tips2612621. **Be specific** — "healthcare SaaS dashboard" beats "app"2632. **Search multiple times** — Different keywords reveal different insights2643. **Combine domains** — Style + Typography + Color = complete system2654. **Always check UX** — Search "animation", "z-index", "accessibility" for common issues2665. **Use the stack flag** — Get implementation-specific best practices2676. **Iterate** — If first search misses, try different keywords268269---270271## Common Rules for Professional UI272273### Icons & Visual Elements274275| Rule | Do | Don't |276|------|-----|-------|277| No emoji icons | Use SVG icons (Heroicons, Lucide, Simple Icons) | Use emojis as UI icons |278| Stable hover states | Use color/opacity transitions | Use scale transforms that shift layout |279| Correct brand logos | Research official SVG from Simple Icons | Guess or use incorrect logo paths |280| Consistent icon sizing | Fixed viewBox (24x24) with w-6 h-6 | Mix different icon sizes |281282### Interaction & Cursor283284| Rule | Do | Don't |285|------|-----|-------|286| Cursor pointer | `cursor-pointer` on all clickable elements | Leave default cursor on interactive elements |287| Hover feedback | Visual feedback (color, shadow, border) | No indication element is interactive |288| Smooth transitions | `transition-colors duration-200` | Instant changes or >500ms |289290### Light/Dark Mode Contrast291292| Rule | Do | Don't |293|------|-----|-------|294| Glass card (light) | `bg-white/80` or higher opacity | `bg-white/10` (too transparent) |295| Text contrast (light) | `#0F172A` (slate-900) for text | `#94A3B8` (slate-400) for body text |296| Muted text (light) | `#475569` (slate-600) minimum | gray-400 or lighter |297| Border visibility | `border-gray-200` in light mode | `border-white/10` (invisible) |298299### Layout & Spacing300301| Rule | Do | Don't |302|------|-----|-------|303| Floating navbar | `top-4 left-4 right-4` spacing | Stick to `top-0 left-0 right-0` |304| Content padding | Account for fixed navbar height | Let content hide behind fixed elements |305| Consistent max-width | Same `max-w-6xl` or `max-w-7xl` | Mix different container widths |306307---308309## Pre-Delivery Checklist310311### Visual Quality312313- [ ] No emojis used as icons (use SVG instead)314- [ ] All icons from consistent set (Heroicons/Lucide)315- [ ] Brand logos verified (Simple Icons)316- [ ] Hover states don't cause layout shift317- [ ] Theme colors used directly (`bg-primary` not `var()` wrapper)318319### Interaction320321- [ ] All clickable elements have `cursor-pointer`322- [ ] Hover states provide clear visual feedback323- [ ] Transitions are 150-300ms324- [ ] Focus states visible for keyboard navigation325326### Light/Dark Mode327328- [ ] Light mode text has 4.5:1 minimum contrast329- [ ] Glass/transparent elements visible in light mode330- [ ] Borders visible in both modes331- [ ] Both modes tested before delivery332333### Layout334335- [ ] Floating elements have proper edge spacing336- [ ] No content hidden behind fixed navbars337- [ ] Responsive at 375px, 768px, 1024px, 1440px338- [ ] No horizontal scroll on mobile339340### Accessibility341342- [ ] All images have alt text343- [ ] Form inputs have labels344- [ ] Color is not the only indicator345- [ ] `prefers-reduced-motion` respected