codymaster 4.1.4 → 4.3.0

package/skills/cm-ux-master/cli/README.md

@@ -0,0 +1,180 @@
+# UX-Master CLI
+
+Ultimate UX Design Intelligence - CLI tool with 48 UX Laws, 37 Design Tests, and MCP integrations.
+
+## Installation
+
+### From PyPI (Recommended)
+
+```bash
+pip install uxmaster
+```
+
+### From Homebrew (macOS/Linux)
+
+```bash
+brew install uxmaster
+```
+
+### Development Installation
+
+```bash
+cd cli
+pip install -e ".[dev]"
+```
+
+## Quick Start
+
+```bash
+# Install for Claude Code
+uxm init --ai claude
+
+# Generate design system
+uxm search "fintech dashboard" --design-system
+
+# Search UX Laws
+uxm search "mobile touch targets" --domain ux-laws
+
+# List supported platforms
+uxm platforms
+```
+
+## Commands
+
+### `init` - Install skill for AI assistants
+
+```bash
+uxm init --ai claude                    # Install for Claude Code
+uxm init --ai cursor --force            # Overwrite existing
+uxm init --ai all                       # Install for all platforms
+uxm init --ai claude --global           # Install to global config
+uxm init --ai figma --dry-run           # Preview Figma integration
+```
+
+### `search` - Search knowledge base
+
+```bash
+# Generate design system
+uxm search "fintech dashboard" --design-system -p "MyApp"
+
+# Search specific domain
+uxm search "fitts law" --domain ux-laws
+uxm search "glassmorphism" --domain style
+uxm search "mobile forms" --domain design-tests
+
+# Stack-specific guidelines
+uxm search "form validation" --stack react
+```
+
+### `extract` - Extract design system from website
+
+```bash
+uxm extract https://stripe.com --output stripe.json
+uxm extract https://linear.app --format tailwind
+uxm extract https://vercel.com --figma
+```
+
+### `validate` - Validate UI against Design Tests
+
+```bash
+uxm validate index.html --suite mobile
+uxm validate component.html --suite a11y --output report.html
+```
+
+### `platforms` - List supported AI platforms
+
+```bash
+uxm platforms
+```
+
+## Features
+
+### 1. Template Engine
+
+Advanced template system with:
+- YAML-based platform configurations
+- Conditional blocks: `{{#if pro}}...{{/if}}`
+- Loops: `{{#each stacks}}...{{/each}}`
+- Partials: `{{> quick-reference}}`
+- Variables with filters: `{{name | upper}}`
+
+### 2. Multi-Platform Support
+
+16 AI platforms supported:
+- Claude Code
+- Cursor
+- Windsurf
+- Antigravity
+- GitHub Copilot
+- Kiro
+- OpenCode
+- Roo Code
+- Codex
+- Qoder
+- Gemini CLI
+- Trae
+- Continue
+- CodeBuddy
+- Droid (Factory)
+- Cline
+
+### 3. Search Engine
+
+BM25-based search across:
+- 16 domains (48 UX Laws, 37 Design Tests, 67 styles, etc.)
+- 17 technology stacks
+- 1000+ design rules
+
+### 4. MCP Integration (Coming)
+
+- Figma plugin for design token sync
+- Google Stitch integration
+- VS Code MCP server
+
+## Architecture
+
+```
+cli/
+├── uxmaster/
+│   ├── __init__.py
+│   ├── __main__.py
+│   ├── cli.py              # Main CLI commands
+│   ├── template_engine.py  # Template rendering
+│   ├── search_engine.py    # BM25 search
+│   ├── commands/           # Command implementations
+│   └── utils/              # Utilities
+├── templates/
+│   ├── platforms/          # Platform YAML configs
+│   └── base/               # Base templates
+├── pyproject.toml
+└── README.md
+```
+
+## Development
+
+### Setup
+
+```bash
+cd cli
+python -m venv .venv
+source .venv/bin/activate  # or .venv\Scripts\activate on Windows
+pip install -e ".[dev]"
+```
+
+### Testing
+
+```bash
+pytest
+```
+
+### Code Quality
+
+```bash
+black uxmaster/
+ruff check uxmaster/
+mypy uxmaster/
+```
+
+## License
+
+MIT License - see LICENSE file for details.

package/skills/cm-ux-master/cli/pyproject.toml

@@ -0,0 +1,106 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "uxmaster"
+version = "2.0.0"
+description = "Ultimate UX Design Intelligence - CLI tool with 48 UX Laws, 37 Design Tests, MCP server, Figma & Stitch integrations"
+readme = "README.md"
+license = {file = "LICENSE"}
+requires-python = ">=3.9"
+authors = [
+    {name = "UX Master Team", email = "hello@ux-master.dev"}
+]
+keywords = [
+    "ui", "ux", "design", "design-system", "accessibility", "wcag",
+    "claude", "cursor", "windsurf", "ai", "mcp", "figma", "stitch",
+    "frontend", "tailwind", "react", "vue"
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: User Interfaces",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "click>=8.0.0",
+    "rich>=13.0.0",
+    "PyYAML>=6.0",
+    "pydantic>=2.0.0",
+    "httpx>=0.25.0",
+    "playwright>=1.40.0",
+    "beautifulsoup4>=4.12.0",
+    "cssutils>=2.9.0",
+    "pillow>=10.0.0",
+    "numpy>=1.24.0",
+    "scikit-learn>=1.3.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+    "pytest-cov>=4.0.0",
+    "black>=23.0.0",
+    "ruff>=0.1.0",
+    "mypy>=1.0.0",
+    "pre-commit>=3.0.0",
+]
+mcp = [
+    "fastapi>=0.104.0",
+    "uvicorn[standard]>=0.24.0",
+    "python-multipart>=0.0.6",
+    "websockets>=12.0",
+]
+figma = [
+    "httpx>=0.25.0",
+]
+all = [
+    "fastapi>=0.104.0",
+    "uvicorn[standard]>=0.24.0",
+    "python-multipart>=0.0.6",
+    "websockets>=12.0",
+    "httpx>=0.25.0",
+]
+
+[project.scripts]
+uxmaster = "uxmaster.__main__:cli"
+uxm = "uxmaster.__main__:cli"
+
+[project.urls]
+Homepage = "https://ux-master.dev"
+Documentation = "https://docs.ux-master.dev"
+Repository = "https://github.com/relukdev/ux-master"
+"Bug Tracker" = "https://github.com/relukdev/ux-master/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["uxmaster"]
+
+[tool.black]
+line-length = 100
+target-version = ['py39']
+
+[tool.ruff]
+line-length = 100
+select = ["E", "F", "I", "N", "W", "UP", "B", "C4"]
+ignore = ["E501"]
+
+[tool.mypy]
+python_version = "3.9"
+strict = true
+warn_return_any = true
+warn_unused_configs = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+addopts = "-v --tb=short"

package/skills/cm-ux-master/cli/requirements.txt

@@ -0,0 +1,21 @@
+# Core dependencies
+click>=8.0.0
+rich>=13.0.0
+PyYAML>=6.0
+pydantic>=2.0.0
+httpx>=0.25.0
+
+# For extraction features
+playwright>=1.40.0
+beautifulsoup4>=4.12.0
+cssutils>=2.9.0
+pillow>=10.0.0
+
+# For ML/AI features
+numpy>=1.24.0
+scikit-learn>=1.3.0
+
+# Optional: MCP support
+# mcp>=1.0.0
+# fastapi>=0.104.0
+# uvicorn>=0.24.0

package/skills/cm-ux-master/cli/templates/base/skill-core.md

@@ -0,0 +1,262 @@
+# {{title}}
+
+{{description}}
+
+{{#if has_ux_laws}}
+## Core Capabilities
+
+- **48 UX Laws** - Psychology-driven design principles (Fitts's Law, Hick's Law, Doherty Threshold, etc.)
+- **37 Design Tests** - Automated validation with pass/fail criteria
+- **Design System Extractor** - Extract tokens from any website
+- **Multi-Device Support** - 20 device profiles including mobile, tablet, watch, TV, foldable, VR
+{{/if}}
+
+## Prerequisites
+
+Check if Python is installed:
+
+```bash
+python3 --version || python --version
+```
+
+If Python is not installed:
+
+**macOS:**
+```bash
+brew install python3
+```
+
+**Ubuntu/Debian:**
+```bash
+sudo apt update && sudo apt install python3
+```
+
+**Windows:**
+```powershell
+winget install Python.Python.3.12
+```
+
+---
+
+## How to Use This {{skill_or_workflow}}
+
+When user requests UI/UX work (design, build, create, implement, review, fix, improve), follow this workflow:
+
+### Step 1: Analyze User Requirements
+
+Extract key information:
+- **Product type**: SaaS, e-commerce, portfolio, dashboard, landing page, mobile app
+- **Style keywords**: minimal, playful, professional, elegant, dark mode
+- **Industry**: healthcare, fintech, gaming, education, beauty
+- **Stack**: React, Vue, Next.js, or default to `html-tailwind`
+
+### Step 2: Generate Design System (REQUIRED)
+
+**Always start with `--design-system`**:
+
+```bash
+python3 {{script_path}} "<product_type> <industry> <keywords>" --design-system [-p "Project Name"]
+```
+
+This command:
+1. Searches 5 domains in parallel (product, style, color, landing, typography)
+2. Applies reasoning rules with UX Laws mapping
+3. Returns complete design system: pattern, style, colors, typography, effects
+4. Includes applicable UX Laws and Design Tests
+5. Lists anti-patterns to avoid
+
+**Example:**
+```bash
+python3 {{script_path}} "fintech crypto dashboard" --design-system -p "CryptoApp"
+```
+
+### Step 2b: Query UX Laws (NEW)
+
+Get psychology-based design principles:
+
+```bash
+python3 {{script_path}} "mobile app fitts" --domain ux-laws -n 5
+python3 {{script_path}} "e-commerce checkout" --domain ux-laws
+```
+
+**48 UX Laws** mapped across 12 product types with:
+- Law definition and application
+- Pass/fail criteria
+- Anti-patterns
+- Severity levels
+
+### Step 2c: Query Design Tests (NEW)
+
+Get TDD-style validation criteria:
+
+```bash
+python3 {{script_path}} "landing page hero" --domain design-tests -n 5
+python3 {{script_path}} "mobile touch target" --domain design-tests
+```
+
+**37 Design Tests** with:
+- Measurable pass/fail criteria
+- Test methods (visual audit, automated, functional)
+- Severity levels (Critical, High, Medium, Low)
+
+### Step 3: Persist Design System (Master + Overrides)
+
+```bash
+python3 {{script_path}} "<query>" --design-system --persist -p "Project Name"
+```
+
+Creates:
+- `design-system/MASTER.md` — Global Source of Truth
+- `design-system/pages/` — Page-specific overrides
+
+**With page override:**
+```bash
+python3 {{script_path}} "<query>" --design-system --persist -p "Project" --page "dashboard"
+```
+
+### Step 4: Supplement with Detailed Searches
+
+```bash
+# More style options
+python3 {{script_path}} "glassmorphism dark" --domain style
+
+# Chart recommendations
+python3 {{script_path}} "real-time dashboard" --domain chart
+
+# UX best practices
+python3 {{script_path}} "animation accessibility" --domain ux
+
+# Animation patterns
+python3 {{script_path}} "micro-interaction" --domain animation
+
+# Responsive patterns
+python3 {{script_path}} "mobile-first" --domain responsive
+```
+
+### Step 5: Stack Guidelines
+
+```bash
+python3 {{script_path}} "<keyword>" --stack html-tailwind
+```
+
+Available: `html-tailwind`, `react`, `nextjs`, `vue`, `nuxtjs`, `nuxt-ui`, `svelte`, `astro`, `swiftui`, `react-native`, `flutter`, `shadcn`, `jetpack-compose`, `angular`, `htmx`, `electron`, `tauri`
+
+---
+
+## Search Reference
+
+### Available Domains (16)
+
+| Domain | Entries | Use For |
+|--------|---------|---------|
+| `ux-laws` | 48 | Psychology principles, behavioral design |
+| `design-tests` | 37 | Validation criteria, test cases |
+| `style` | 67 | UI styles, effects, CSS keywords |
+| `color` | 96 | Color palettes by product type |
+| `typography` | 57 | Font pairings, Google Fonts |
+| `product` | 96 | Product type recommendations |
+| `landing` | 30 | Page structure, CTA strategies |
+| `chart` | 25 | Chart types, data visualization |
+| `ux` | 99 | Best practices, anti-patterns |
+| `animation` | 30 | Micro-interactions, transitions |
+| `responsive` | 25 | Breakpoints, container queries |
+| `accessibility` | 25 | WCAG 2.2 patterns |
+| `devices` | 20 | Device-specific guidelines |
+
+### Available Stacks (17)
+
+| Stack | Focus |
+|-------|-------|
+| `html-tailwind` | Tailwind utilities, responsive, a11y |
+| `react` | Hooks, performance, patterns |
+| `nextjs` | App Router, SSR, RSC |
+| `vue` | Composition API, Pinia |
+| `svelte` | Runes, stores, transitions |
+| `astro` | Islands architecture |
+| `angular` | Signals, standalone, NgRx |
+| `swiftui` | iOS/macOS native |
+| `react-native` | Cross-platform mobile |
+| `flutter` | Dart widgets, Material |
+| `shadcn` | shadcn/ui components |
+| `electron` | Desktop - IPC, security |
+| `tauri` | Desktop - Rust commands |
+
+---
+
+## Execution Workflow (MANDATORY Output Format)
+
+### Step 1: 🧠 UX Reasoning
+
+Explain (2-3 bullets) which UX Laws you applied:
+
+```
+- Fitts's Law → Primary "Save" in thumb zone, 48px touch target
+- Hick's Law → Advanced settings hidden, only 2 visible CTAs
+- Doherty Threshold → Skeleton loader for data table
+```
+
+### Step 2: 💻 Production-Ready Code
+
+Provide clean, modular code with inline UX comments:
+
+```html
+<!-- UX: Fitts's Law — Touch target ≥ 44px -->
+<button class="min-h-[44px] min-w-[44px]">
+
+<!-- UX: Doherty Threshold — Skeleton loader -->
+<div class="animate-pulse bg-gray-200 rounded h-4">
+```
+
+### Step 3: ✅ Validation Checklist
+
+```
+✅ Fitts's Law: Touch targets ≥ 44px
+✅ Hick's Law: Max 2 CTAs, progressive disclosure
+✅ Miller's Law: Data chunked in groups of 6
+✅ Doherty: Skeleton + Empty + Error states
+✅ A11y: focus-visible, WCAG AA contrast
+```
+
+---
+
+## Output Formats
+
+```bash
+# ASCII box (default)
+python3 {{script_path}} "fintech" --design-system
+
+# Markdown
+python3 {{script_path}} "fintech" --design-system -f markdown
+
+# JSON
+python3 {{script_path}} "fintech" --design-system -f json
+```
+
+---
+
+## Pre-Delivery Checklist
+
+### Core Directive Compliance
+- [ ] Fitts's Law: ALL touch targets ≥ 44×44px
+- [ ] Hick's Law: Max 1-2 primary CTAs per view
+- [ ] Miller's Law: Info chunked in groups of 5-9
+- [ ] Doherty: <400ms feedback, skeleton loaders
+- [ ] A11y: WCAG 2.1 AA contrast, focus-visible
+- [ ] Inline UX Comments: Code explains constraints
+
+### Visual Quality
+- [ ] No emojis as icons (use SVG)
+- [ ] Consistent icon library (Heroicons/Lucide)
+- [ ] Brand logos correct (Simple Icons)
+- [ ] Hover states don't shift layout
+
+### Interaction
+- [ ] cursor-pointer on all clickable elements
+- [ ] Smooth transitions (150-300ms)
+- [ ] Focus states visible
+- [ ] prefers-reduced-motion respected
+
+### Responsive
+- [ ] Tested at 375px, 768px, 1024px, 1440px
+- [ ] No horizontal scroll on mobile
+- [ ] Touch targets scale appropriately

package/skills/cm-ux-master/cli/templates/platforms/claude.yaml

@@ -0,0 +1,21 @@
+platform: claude
+display_name: Claude Code
+install_type: full
+folder_structure:
+  root: ".claude"
+  skillPath: "skills/ux-master"
+  filename: "SKILL.md"
+script_path: "skills/ux-master/scripts/search.py"
+frontmatter:
+  name: "ux-master"
+  description: "Ultimate UX Design Intelligence with 48 UX Laws, 37 Design Tests, Design System Extractor, and Multi-Device Support. Actions: plan, build, create, design, implement, review, fix, improve, validate, extract, optimize. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, web app. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive. Domains: ux-laws, design-tests, style, color, typography, animation, responsive, accessibility. Stacks: React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui, Angular, HTMX."
+sections:
+  quick_reference: true
+title: "UX Master - Ultimate Design Intelligence"
+description: "Comprehensive design guide with psychology-driven UX Laws, automated Design Tests, and design system extraction. Contains 48 UX Laws, 37 Design Tests, 67 styles, 96 color palettes across 17 technology stacks."
+skill_or_workflow: "Skill"
+mcp_capabilities:
+  - search
+  - validate
+  - extract
+tool_endpoints: []

package/skills/cm-ux-master/cli/templates/platforms/cursor.yaml

@@ -0,0 +1,21 @@
+platform: cursor
+display_name: Cursor
+install_type: full
+folder_structure:
+  root: ".cursor"
+  skillPath: "skills/ux-master"
+  filename: "SKILL.md"
+script_path: "skills/ux-master/scripts/search.py"
+frontmatter:
+  name: "ux-master"
+  description: "Ultimate UX Design Intelligence with 48 UX Laws, 37 Design Tests, Design System Extractor, and Multi-Device Support. Use for: designing UI/UX, validating designs, extracting design systems, implementing accessible interfaces."
+sections:
+  quick_reference: true
+title: "UX Master - Ultimate Design Intelligence"
+description: "Comprehensive design guide with psychology-driven UX Laws, automated Design Tests, and design system extraction."
+skill_or_workflow: "Skill"
+mcp_capabilities:
+  - search
+  - validate
+  - extract
+tool_endpoints: []

package/skills/cm-ux-master/cli/templates/platforms/figma.yaml

@@ -0,0 +1,24 @@
+platform: figma
+display_name: Figma Plugin
+install_type: reference
+folder_structure:
+  root: "figma-plugins"
+  skillPath: "ux-master"
+  filename: "manifest.json"
+script_path: "code.ts"
+frontmatter: null
+sections:
+  quick_reference: false
+title: "UX Master for Figma"
+description: "Figma plugin for design system management and UX validation."
+skill_or_workflow: "Figma Plugin"
+mcp_capabilities:
+  - import_design_tokens
+  - validate_selection
+  - apply_ux_laws
+  - generate_palette
+tool_endpoints:
+  - name: "import_from_url"
+    description: "Extract and import design tokens from website"
+  - name: "validate_selection"
+    description: "Check selected layers against Design Tests"

package/skills/cm-ux-master/cli/templates/platforms/vscode-mcp.yaml

@@ -0,0 +1,28 @@
+platform: vscode-mcp
+display_name: VS Code MCP Server
+install_type: mcp
+folder_structure:
+  root: ".vscode"
+  skillPath: "mcp"
+  filename: "ux-master.json"
+script_path: "mcp/server.py"
+frontmatter: null
+sections:
+  quick_reference: false
+title: "UX Master MCP Server"
+description: "MCP server providing UX Laws, Design Tests, and validation tools for VS Code."
+skill_or_workflow: "MCP Server"
+mcp_capabilities:
+  - search_ux_laws
+  - search_design_tests
+  - validate_design
+  - extract_design_system
+  - generate_color_palette
+  - suggest_typography
+tool_endpoints:
+  - name: "search_ux_laws"
+    description: "Search 48 UX Laws applicable to product type"
+  - name: "validate_design"
+    description: "Validate UI code against 37 Design Tests"
+  - name: "extract_design_system"
+    description: "Extract design tokens from website URL"

package/skills/cm-ux-master/cli/templates/platforms/windsurf.yaml

@@ -0,0 +1,21 @@
+platform: windsurf
+display_name: Windsurf
+install_type: full
+folder_structure:
+  root: ".windsurf"
+  skillPath: "skills/ux-master"
+  filename: "SKILL.md"
+script_path: "skills/ux-master/scripts/search.py"
+frontmatter:
+  name: "ux-master"
+  description: "Ultimate UX Design Intelligence with 48 UX Laws, 37 Design Tests. Use when designing, building, reviewing, or improving any UI/UX."
+sections:
+  quick_reference: true
+title: "UX Master - Ultimate Design Intelligence"
+description: "Comprehensive design guide with psychology-driven UX Laws and automated Design Tests."
+skill_or_workflow: "Skill"
+mcp_capabilities:
+  - search
+  - validate
+  - extract
+tool_endpoints: []

package/skills/cm-ux-master/cli/uxmaster/__init__.py

@@ -0,0 +1,10 @@
+"""UX-Master CLI - Ultimate UX Design Intelligence."""
+
+__version__ = "2.0.0"
+__author__ = "UX Master Team"
+__email__ = "hello@ux-master.dev"
+
+from .template_engine import TemplateEngine, PlatformConfig
+from .search_engine import SearchEngine
+
+__all__ = ["TemplateEngine", "PlatformConfig", "SearchEngine"]