Antigravity-awesome-skills ui-ux-pro-max
UI/UX design intelligence. 50 styles, 21 palettes, 50 font pairings, 20 charts, 9 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui). Actions: plan, build, cr...
git clone https://github.com/benjaminasterA/antigravity-awesome-skills
T=$(mktemp -d) && git clone --depth=1 https://github.com/benjaminasterA/antigravity-awesome-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/ui-ux-pro-max" ~/.claude/skills/benjaminastera-antigravity-awesome-skills-ui-ux-pro-max && rm -rf "$T"
skills/ui-ux-pro-max/SKILL.mdUI/UX Pro Max - Design Intelligence
Comprehensive design guide for web and mobile applications. Contains 50+ styles, 97 color palettes, 57 font pairings, 99 UX guidelines, and 25 chart types across 9 technology stacks. Searchable database with priority-based recommendations.
When to Apply
Reference these guidelines when:
- 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 | |
| 2 | Touch & Interaction | CRITICAL | |
| 3 | Performance | HIGH | |
| 4 | Layout & Responsive | HIGH | |
| 5 | Typography & Color | MEDIUM | , |
| 6 | Animation | MEDIUM | |
| 7 | Style Selection | MEDIUM | , |
| 8 | Charts & Data | LOW | |
Quick Reference
1. Accessibility (CRITICAL)
- Minimum 4.5:1 ratio for normal textcolor-contrast
- Visible focus rings on interactive elementsfocus-states
- Descriptive alt text for meaningful imagesalt-text
- aria-label for icon-only buttonsaria-labels
- Tab order matches visual orderkeyboard-nav
- Use label with for attributeform-labels
2. Touch & Interaction (CRITICAL)
- Minimum 44x44px touch targetstouch-target-size
- Use click/tap for primary interactionshover-vs-tap
- Disable button during async operationsloading-buttons
- Clear error messages near problemerror-feedback
- Add cursor-pointer to clickable elementscursor-pointer
3. Performance (HIGH)
- Use WebP, srcset, lazy loadingimage-optimization
- Check prefers-reduced-motionreduced-motion
- Reserve space for async contentcontent-jumping
4. Layout & Responsive (HIGH)
- width=device-width initial-scale=1viewport-meta
- Minimum 16px body text on mobilereadable-font-size
- Ensure content fits viewport widthhorizontal-scroll
- Define z-index scale (10, 20, 30, 50)z-index-management
5. Typography & Color (MEDIUM)
- Use 1.5-1.75 for body textline-height
- Limit to 65-75 characters per lineline-length
- Match heading/body font personalitiesfont-pairing
6. Animation (MEDIUM)
- Use 150-300ms for micro-interactionsduration-timing
- Use transform/opacity, not width/heighttransform-performance
- Skeleton screens or spinnersloading-states
7. Style Selection (MEDIUM)
- Match style to product typestyle-match
- Use same style across all pagesconsistency
- Use SVG icons, not emojisno-emoji-icons
8. Charts & Data (LOW)
- Match chart type to data typechart-type
- Use accessible color palettescolor-guidance
- Provide table alternative for accessibilitydata-table
How to Use
Search specific domains using the CLI tool below.
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: Generate Design System (REQUIRED)
Always start with
to get comprehensive recommendations with reasoning:--design-system
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "<product_type> <industry> <keywords>" --design-system [-p "Project Name"]
This command:
- Searches 5 domains in parallel (product, style, color, landing, typography)
- Applies reasoning rules from
to select best matchesui-reasoning.csv - Returns complete design system: pattern, style, colors, typography, effects
- Includes anti-patterns to avoid
Example:
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness service" --design-system -p "Serenity Spa"
Step 3: Supplement with Detailed Searches (as needed)
After getting the design system, use domain searches to get additional details:
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "<keyword>" --domain <domain> [-n <max_results>]
When to use detailed searches:
| Need | Domain | Example |
|---|---|---|
| More style options | | |
| Chart recommendations | | |
| UX best practices | | |
| Alternative fonts | | |
| Landing structure | | |
Step 4: Stack Guidelines (Default: html-tailwind)
Get implementation-specific best practices. 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, shadcn
Search Reference
Available Domains
| Domain | Use For | Example Keywords |
|---|---|---|
| Product type recommendations | SaaS, e-commerce, portfolio, healthcare, beauty, service |
| UI styles, colors, effects | glassmorphism, minimalism, dark mode, brutalism |
| Font pairings, Google Fonts | elegant, playful, professional, modern |
| Color palettes by product type | saas, ecommerce, healthcare, beauty, fintech, service |
| Page structure, CTA strategies | hero, hero-centric, testimonial, pricing, social-proof |
| Chart types, library recommendations | trend, comparison, timeline, funnel, pie |
| Best practices, anti-patterns | animation, accessibility, z-index, loading |
| React/Next.js performance | waterfall, bundle, suspense, memo, rerender, cache |
| Web interface guidelines | aria, focus, keyboard, semantic, virtualize |
| AI prompts, CSS keywords | (style name) |
Available Stacks
| Stack | Focus |
|---|---|
| Tailwind utilities, responsive, a11y (DEFAULT) |
| State, hooks, performance, patterns |
| SSR, routing, images, API routes |
| Composition API, Pinia, Vue Router |
| Runes, stores, SvelteKit |
| Views, State, Navigation, Animation |
| Components, Navigation, Lists |
| Widgets, State, Layout, Theming |
| shadcn/ui components, theming, forms, patterns |
Example Workflow
User request: "Làm landing page cho dịch vụ chăm sóc da chuyên nghiệp"
Step 1: Analyze Requirements
- Product type: Beauty/Spa service
- Style keywords: elegant, professional, soft
- Industry: Beauty/Wellness
- Stack: html-tailwind (default)
Step 2: Generate Design System (REQUIRED)
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness service elegant" --design-system -p "Serenity Spa"
Output: Complete design system with pattern, style, colors, typography, effects, and anti-patterns.
Step 3: Supplement with Detailed Searches (as needed)
# Get UX guidelines for animation and accessibility python3 .claude/skills/ui-ux-pro-max/scripts/search.py "animation accessibility" --domain ux # Get alternative typography options if needed python3 .claude/skills/ui-ux-pro-max/scripts/search.py "elegant luxury serif" --domain typography
Step 4: Stack Guidelines
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "layout responsive form" --stack html-tailwind
Then: Synthesize design system + detailed searches and implement the design.
Output Formats
The
--design-system flag supports two output formats:
# ASCII box (default) - best for terminal display python3 .claude/skills/ui-ux-pro-max/scripts/search.py "fintech crypto" --design-system # Markdown - best for documentation python3 .claude/skills/ui-ux-pro-max/scripts/search.py "fintech crypto" --design-system -f markdown
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 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 | Instant state changes or too slow (>500ms) |
Light/Dark Mode Contrast
| Rule | Do | Don't |
|---|---|---|
| Glass card light mode | Use or higher opacity | Use (too transparent) |
| Text contrast light | Use (slate-900) for text | Use (slate-400) for body text |
| Muted text light | Use (slate-600) minimum | Use gray-400 or lighter |
| Border visibility | Use in light mode | Use (invisible) |
Layout & Spacing
| Rule | Do | Don't |
|---|---|---|
| Floating navbar | Add spacing | Stick navbar to |
| Content padding | Account for fixed navbar height | Let content hide behind fixed elements |
| Consistent max-width | Use same or | Mix different container widths |
Pre-Delivery Checklist
Before delivering UI code, verify these items:
Visual Quality
- No emojis used as icons (use SVG instead)
- All icons from consistent icon set (Heroicons/Lucide)
- Brand logos are correct (verified from Simple Icons)
- Hover states don't cause layout shift
- Use theme colors directly (bg-primary) not var() wrapper
Interaction
- All clickable elements have
cursor-pointer - Hover states provide clear visual feedback
- Transitions are smooth (150-300ms)
- Focus states visible for keyboard navigation
Light/Dark Mode
- Light mode text has sufficient contrast (4.5:1 minimum)
- Glass/transparent elements visible in light mode
- Borders visible in both modes
- Test both modes before delivery
Layout
- Floating elements have proper spacing from edges
- No content hidden behind fixed navbars
- Responsive at 375px, 768px, 1024px, 1440px
- No horizontal scroll on mobile
Accessibility
- All images have alt text
- Form inputs have labels
- Color is not the only indicator
-
respectedprefers-reduced-motion
When to Use
This skill is applicable to execute the workflow or actions described in the overview.