Spartan-ai-toolkit ui-ux-pro-max
UI/UX design intelligence with searchable style, palette, typography, and chart databases. Use when designing UI components, choosing colors/fonts, reviewing code for UX issues, building landing pages, or implementing responsive layouts.
git clone https://github.com/c0x12c/ai-toolkit
T=$(mktemp -d) && git clone --depth=1 https://github.com/c0x12c/ai-toolkit "$T" && mkdir -p ~/.claude/skills && cp -r "$T/toolkit/skills/ui-ux-pro-max" ~/.claude/skills/spartan-stratos-spartan-ai-toolkit-ui-ux-pro-max && rm -rf "$T"
toolkit/skills/ui-ux-pro-max/SKILL.mdUI/UX Pro Max - Design Intelligence
Comprehensive design guide for web and mobile applications. Contains 67 styles, 96 color palettes, 57 font pairings, 99 UX guidelines, and 25 chart types across 13 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.
See
for Python script usage.python-setup.md
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 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 skills/ui-ux-pro-max/scripts/search.py "animation accessibility" --domain ux # Get alternative typography options if needed python3 skills/ui-ux-pro-max/scripts/search.py "elegant luxury serif" --domain typography
Step 4: Stack Guidelines
python3 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 skills/ui-ux-pro-max/scripts/search.py "fintech crypto" --design-system # Markdown - best for documentation python3 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