Antigravity-awesome-skills ui-ux-pro-max
Comprehensive design guide for web and mobile applications. Use when designing new UI components or pages, choosing color palettes and typography, or reviewing code for UX issues.
git clone https://github.com/sickn33/antigravity-awesome-skills
T=$(mktemp -d) && git clone --depth=1 https://github.com/sickn33/antigravity-awesome-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/plugins/antigravity-awesome-skills/skills/ui-ux-pro-max" ~/.claude/skills/sickn33-antigravity-awesome-skills-ui-ux-pro-max-64ff6f && rm -rf "$T"
plugins/antigravity-awesome-skills/skills/ui-ux-pro-max/SKILL.md- uses sudo
UI/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 Use
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.
Limitations
- Use this skill only when the task clearly matches the scope described above.
- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.