UI UX Pro Max Skill

repository·main·Indexed 33 days ago

https://github.com/nextlevelbuilder/ui-ux-pro-max-skill

An AI-driven design intelligence tool and CLI for AI coding assistants. It provides a structured 'Website Design Stack' featuring intelligent design system generation, industry-specific reasoning rules, anti-pattern detection, and accessibility checklists. Supports integration with Claude Code, Cursor, Windsurf, GitHub Copilot, and more via the ui-ux-pro-max-cli.

Tokens
8.4K
Snippets
23
Records
42
Agent score
96%

What's inside ui-ux-pro-max-skill

  1. Overview of UI UX Pro Max

    main

    UI UX Pro Max is an AI skill designed to provide design intelligence for building professional user interfaces and experiences across various platforms and frameworks.

    Key capabilities include:

    • Intelligent Design System Generation: An AI-powered reasoning engine that analyzes project requirements to generate tailored design systems (patterns, styles, colors, typography, and effects).
    • Industry-Specific Reasoning: Utilizes 161 reasoning rules across categories like Tech & SaaS, Finance, Healthcare, E-commerce, and more to ensure design decisions align with industry standards.
    • Anti-Pattern Detection: Identifies design choices to avoid (e.g., avoiding neon colors in banking applications) to maintain professional standards.
    • Pre-delivery Checklists: Provides actionable checklists for accessibility (WCAG), responsiveness, and interaction design.
  2. Understand the Claude Website Design Stack layers

    main

    The stack integrates four specific layers to improve AI design quality:

    • Knowledge Layer: Uses ui-ux-pro-max to provide searchable design systems (styles, color palettes, typography, UX rules).
    • Taste Layer: Uses the official Anthropic frontend-design plugin to enforce aesthetic commitment.
    • Components Layer: Uses the shadcn MCP to add production components via natural language.
    • Visual Feedback Layer: Uses @playwright/mcp and chrome-devtools-mcp so Claude can see, screenshot, and iterate on the rendered page.
    • Automated Review: Uses a design-review subagent and the /design-review command to perform a 7-phase audit (WCAG AA, responsiveness, etc.).
  3. Understand the three data, scripts, and templates locations

    main

    The project maintains three distinct locations for data, scripts, and templates, each serving a specific purpose in the ecosystem. To avoid maintenance overhead, you should only modify files in the src/ui-ux-pro-max/ directory.

    LocationPurposeMaintainability
    src/ui-ux-pro-max/Single Source of Truth. All CSVs, scripts, and templates must be modified here.Primary source; do not delete.
    .claude/skills/ui-ux-pro-max/Used by Cursor / Claude Code skills. AI reads SKILL.md and runs scripts/search.py from here.Should use symbolic links pointing to src to avoid duplication.
    cli/assets/Used for packaging the ui-ux-pro-max-cli npm package. This is what users receive when running uipro init.Must be synchronized from src before publishing to npm.
  4. Understand the Design System Generation workflow

    main

    UI UX Pro Max uses an AI-driven reasoning engine to generate complete, customized design systems in seconds. The generation process follows a four-step pipeline:

    1. User Request: You provide a prompt (e.g., "Build a landing page for my beauty salon").
    2. Multi-Domain Search: The engine performs 5 parallel searches:
      • Product Type Matching: Selects from 161 categories.
      • Style Recommendation: Selects from 67 UI styles.
      • Color Palette Selection: Selects from 161 palettes.
      • Landing Page Patterns: Selects from 24 patterns.
      • Font Pairing: Selects from 57 combinations.
    3. Reasoning Engine: Matches products to UI rules, applies style priorities (using BM25 ranking), filters out industry anti-patterns, and processes decision rules via JSON conditions.
    4. Complete Design System Output: Delivers a comprehensive specification including Patterns, Styles, Color Palettes, Typography, Effects, Anti-patterns to avoid, and a Pre-delivery Checklist.
  5. Explore UI UX Pro Max features and styles

    main

    UI UX Pro Max provides a comprehensive design intelligence engine with the following capabilities:

    • 67 UI Styles: Includes Glassmorphism, Neumorphism, Minimalism, Brutalism, Claymorphism, AI Native UI, and more.
    • 161 Color Palettes: Industry-specific palettes aligned 1:1 with 161 product types.
    • 57 Font Pairings: Curated combinations including Google Fonts imports.
    • 25 Chart Types: Recommended for dashboards and analytics.
    • 22 Tech Stacks: Specialized guides for React, Next.js, Vue, Nuxt, Svelte, SwiftUI, Flutter, Tailwind, etc.
    • 99 UX Guidelines: Best practices, anti-patterns, and accessibility rules.
    • 161 Reasoning Rules: Industry-specific rules for design system generation (v2.0).

    Style Categories include:

    • General Styles: (e.g., Swiss Style, Cyberpunk, Y2K, Aurora UI, Space UI).
    • Landing Page Styles: (e.g., Conversion Optimized, Narrative Driven, Trust & Authority).
    • BI/Dashboard Styles: (e.g., Dense Data, Heatmap, Executive Summary, Real-time Monitoring).
  6. Understand the Website Design Stack layers

    main

    The Website Design Stack is composed of several layers designed to solve specific AI design failures. By combining these tools, you move from generic 'AI slop' to distinctive, grounded, and audited UI/UX.

    Core Layers

    LayerToolPurpose
    Knowledgeui-ux-pro-maxProvides grounded design intelligence (styles, colors, fonts, UX guidelines) to prevent vague or inconsistent tokens.
    Tastefrontend-designForces aesthetic commitment (purpose, tone, constraints, differentiation) to prevent generic, templated looks.
    Componentsshadcn MCPAllows browsing and installing proven, accessible primitives instead of hand-rolling components.
    Visual FeedbackPlaywright / Chrome DevTools MCPGives the agent 'eyes' to see, click, resize, and screenshot real Chromium instances to catch layout and accessibility bugs.
    Automated Reviewdesign-review subagentProvides a senior-reviewer subagent that performs a 7-phase audit (responsiveness, visual polish, WCAG 2.1 AA, etc.).

    Optional Add-ons

    • Figma Dev Mode MCP: Syncs Figma tokens/layouts to code and pushes Claude-built UI back to Figma layers.
    • 21st.dev Magic MCP: Generates React components from prompts (similar to v0).
  7. Quickstart the Claude Website Design Stack

    main

    To set up a Claude Code environment optimized for professional website design, follow these steps to install the necessary MCP servers (Playwright, Chrome DevTools, shadcn) and the design workflow.

    1. Clone the repository and enter the directory.
    2. Run the setup script to install plugins and the Playwright browser.
    3. Launch Claude Code; the MCP servers and CLAUDE.md workflow will load automatically.

    Once running, you can request UI work directly. Claude will follow a loop of planning, building, screenshotting for visual feedback, and performing a /design-review audit.

    # 1. Clone and enter
    git clone https://github.com/YMungerDev/claude-website-design-stack
    cd claude-website-design-stack
    
    # 2. Install the skills/plugins + Playwright browser
    ./scripts/setup.sh
    
    # 3. Open Claude Code
    claude
  8. Use UI UX Pro Max in your workflow

    main

    Depending on your AI assistant, you can trigger the UI/UX intelligence in two ways:

    Skill Mode (Automatic Activation)

    Supported by: Claude Code, Cursor, Windsurf, Antigravity, Continue, Gemini CLI, etc. Simply ask for UI/UX tasks in natural language. The skill activates automatically when it detects a design request. *Example: "Build a landing page for my SaaS product"

    Workflow Mode (Slash Commands)

    Supported by: Kiro, GitHub Copilot, Roo Code, KiloCode. Use the specific slash command to invoke the skill. *Example: /ui-ux-pro-max Build a landing page for my SaaS product

    Note for Trae users: Switch to SOLO mode first; the skill will then activate automatically on UI/UX requests.

  9. Use UI UX Pro Max in your workflow

    main

    Depending on your AI assistant, you can trigger the design intelligence in two ways:

    1. Skill Mode (Auto-activate): For assistants like Claude Code, Cursor, and Windsurf, the skill activates automatically when you request UI/UX tasks. Just chat naturally. Note for Trae: Switch to SOLO mode first.

    2. Workflow Mode (Slash Command): For assistants like Kiro, GitHub Copilot, and Roo Code, use the explicit slash command: /ui-ux-pro-max <your request>

    Example Prompts:

    • Build a landing page for my SaaS product
    • Create a dashboard for healthcare analytics
    • Design a portfolio website with dark mode
    • Make a mobile app UI for e-commerce
    # Skill Mode (Natural Language)
    Build a landing page for my SaaS product
    
    # Workflow Mode (Slash Command)
    /ui-ux-pro-max Build a landing page for my SaaS product
  10. Install UI UX Pro Max via CLI

    main

    The recommended way to use UI UX Pro Max is via the ui-ux-pro-max-cli package.

    1. Global Installation

    Install the CLI globally using npm:

    2. Initialize for AI Assistants

    Navigate to your project directory and run uipro init with the --ai flag followed by your specific assistant name.

    Supported Assistants:

    • claude (Claude Code)
    • cursor (Cursor)
    • windsurf (Windsurf)
    • copilot (GitHub Copilot)
    • roo (Roo Code)
    • continue (Continue)
    • all (Installs for all supported assistants)

    3. Global Installation for Assistants

    To install the skill globally for an assistant (e.g., in ~/.claude/skills/), add the --global flag.

  11. Set up the Claude Website Design Stack

    main

    Follow these steps to set up the full design-to-audit workflow using Claude Code. This requires Node 18+ and Python 3.x.

    1. One-shot setup

    Run the setup script to install audit dependencies (Playwright + Chromium) and the ui-ux-pro-max skill:

    ./scripts/setup.sh

    2. Install the taste plugin

    Inside your Claude Code session, install the required frontend design plugin:

    /plugin install frontend-design@anthropics/claude-code

    3. Approve MCP servers

    Open Claude Code in the project directory. It will prompt you to approve the project MCP servers: playwright, chrome-devtools, and shadcn. Approve them to allow Claude to interact with the browser and design tools. Verify they are active by running /mcp.

  12. Install UI UX Pro Max via CLI

    main

    The codebase uses a template-based generation system. To ensure you receive the latest templates and the correct file structure for your AI assistant, always use the CLI for installation rather than manual file copying or Marketplace installs (which may have issues with symbolic links).

    1. Install the CLI globally: npm install -g ui-ux-pro-max-cli
    2. Initialize for your specific platform: uipro init --ai <platform> (e.g., claude, cursor, windsurf)

    If you encounter permission errors during global installation, you can use npx to run the initialization without a global install: npx ui-ux-pro-max-cli init --ai claude

    npm install -g ui-ux-pro-max-cli
    uipro init --ai claude