ui-ux-pro-max-skill

Implements a BM25 ranking algorithm in core.py that searches across 344+ design resources stored in CSV databases covering 10 domains (styles, colors, typography, landing patterns, charts, UX guidelines, icons, products, reasoning rules) and 16 technology stacks. The search engine automatically detects the user's design domain context and filters results by stack-specific guidelines, returning ranked design recommendations that match both semantic intent and technical constraints.

The design_system.py reasoning engine performs sequential multi-domain searches (colors, typography, patterns, guidelines) and synthesizes complete design systems using a Master + Overrides architectural pattern. This pattern defines a master design configuration that can be selectively overridden per platform or component, enabling consistent design systems across 18+ AI platforms while maintaining platform-specific customizations without duplication.

The system integrates with Claude Marketplace through a .claude-plugin/ directory structure that enables direct plugin installation for Claude Code users. The skill.json manifest declares capabilities and activation triggers, allowing the plugin to activate automatically when users request UI/UX work within Claude, with design resources and reasoning engine accessible through Claude's native function-calling interface.

The system includes a pre-delivery checklist capability that validates generated designs against accessibility, performance, and consistency standards before delivery to users. The checklist is generated from reasoning rules and stack-specific guidelines, checking for common issues (color contrast, responsive design, component naming, design token usage) and providing actionable feedback for remediation.

The CLI tool's detectAIType() function in detect.ts identifies the user's AI coding assistant environment (Claude, Cursor, Windsurf, Copilot, etc.) by analyzing file system markers, environment variables, and configuration files. Once detected, the template generation system in template.ts automatically generates platform-specific configuration files from JSON templates (augment.json, kilocode.json, warp.json), enabling zero-configuration installation across 18+ supported platforms.

The system maintains stack-specific guideline configurations that filter and customize design recommendations based on technology stack (React, Vue, Tailwind, HTML5, etc.). When a user requests UI/UX work, the skill automatically detects the target stack from code context or user input, then filters design resources and applies stack-specific guidelines from the CSV database, ensuring generated designs follow framework conventions and best practices.

The system stores 344+ design resources in CSV format across 10 domain-specific files (colors.csv, typography.csv, patterns.csv, etc.), with a source-of-truth synchronization pattern that maintains consistency between CLI templates and skill definitions. Each CSV row contains design metadata (name, description, stack, domain, implementation code) and is indexed for BM25 search, enabling version control, offline access, and collaborative design database management without requiring a backend database.

The CLI tool orchestrates installation across 18+ AI platforms (Claude, Cursor, Windsurf, Copilot, Augment, Kiro, Qoder, Trae, etc.) by generating platform-specific skill or workflow files from templates and placing them in platform-specific directories. The skill.json manifest defines activation triggers and capabilities, enabling automatic activation when users request UI/UX work, with platform-specific behavior controlled through configuration overrides.

The system includes a reasoning rules database (stored in CSV) that encodes design decision logic for common UI/UX scenarios (e.g., 'use high contrast colors for accessibility', 'prefer sans-serif for body text on screens'). The design_system.py engine applies these rules during synthesis to ensure generated designs follow established design principles, with rules indexed by domain and stack to enable context-aware reasoning.

The template.ts utility generates platform-specific configuration files (skill.json, workflow.json, augment.json, kilocode.json, warp.json) from parameterized JSON schema templates. Each template defines platform-specific file structure, activation triggers, and capability declarations, with variables substituted at generation time based on detected platform and user configuration, enabling single-source-of-truth template management.

The extract.ts utility analyzes user codebase files (package.json, tsconfig.json, component files) to automatically detect technology stack and design domain context. It parses dependency declarations, file structure, and code patterns to infer whether the user is building a landing page, dashboard, mobile app, or other design domain, enabling automatic activation of domain-specific design resources without explicit user specification.

The github.ts utility manages distribution of UI/UX Pro Max through GitHub Releases, enabling users to download source archives (.zip) for offline installation or manual deployment. The system maintains release artifacts with version tags, enabling version pinning and rollback capabilities, with automated release workflows that package CLI and skill assets together.