$ show nextlevelbuilder/ui-ux-pro-max-skill
This repository provides a comprehensive AI-assisted UI/UX design system toolkit, primarily packaged as a skill for AI coding assistants (Claude Code, Cursor, Windsurf, Copilot, etc.) and distributed via the 'ui-ux-pro-max-cli' npm package. Its core functionality includes a curated knowledge base of 79 UI styles, 192 product color palettes, 74 font pairings, 119 UX guidelines, 22 tech stacks, and 192 reasoning rules – all stored as structured CSV files. A BM25 search engine (implemented in Python) enables domain‑aware retrieval, while a design system generator aggregates search results and applies reasoning rules to output complete design system recommendations (colors, typography, style, layout patterns, motion, anti‑patterns). The gallery Next.js app provides a browsable, filterable interface for the style catalog. Architecturally, the project is a hybrid of data curation and application delivery. The canonical source of truth lives in `src/ui-ux-pro-max/`, which is synchronised to `cli/assets/` and `.claude/skills/` via a CI‑enforced sync script. It includes sub‑skills for brand management, slide/presentation generation, banner design, icon/logo generation, and UI styling (with shadcn/ui and Tailwind integration). The CLI tool installs these skills into the appropriate AI assistant configuration directories, with platform‑specific templates for 20+ assistants. Automated workflows refresh Google Fonts and Phosphor icon catalogs weekly, and a suite of Python tests validates data contracts, stack freshness, and search relevance. Despite its active maintenance and rich functionality, the codebase suffers from significant file duplication across three directory trees, hardcoded version pins for frameworks, and test brittleness tied to exact data row counts. The design system generator and search engine are well‑crafted and reusable, but the overall project is tightly coupled to its curated CSV schema and the ecosystem of AI coding assistants. It represents a mature, production‑grade toolkit for developers who want AI‑assisted design generation, but the heavy duplication and external API dependencies (Gemini, Atlas Cloud, MuAPI) introduce moderate technical drift risk.
The LLM identified 5 files worth highlighting for reuse:
Reusable BM25 search engine with configurable tokenization (synonym normalization, stopword removal, UK→US spelling). Loads CSV datasets by domain, caches indices with file‑signature integrity, and supports multiple search domains (styles, colors, typography, etc.). Can be extracted into a standalone project by copying the BM25 class and CSV config dict.
Orchestrates design system generation by querying multiple CSV knowledge bases (product palettes, styles, colors, typography, motion) and applying decision rules from ui-reasoning.csv. Resolves light/dark color modes with WCAG contrast checks, includes anti‑pattern gating, and supports atomic file persistence with a Master + Overrides pattern. Modular enough to reuse as a template for any multi‑domain recommendation system.
Comprehensive cross‑file data contract validator that checks CSV schemas, color contrast, typography imports, icon semantics, chart accessibility, UX guidance completeness, reasoning cross‑references, catalog provenance, and stack version pinning. Serves as a reusable CI guard for any codebase that maintains multiple structured datasets with consistency requirements.
Generates skill configuration files for 20+ AI assistant platforms from JSON templates. Handles platform‑specific folder structures, frontmatter, and file extension mapping. Demonstrates a clean pattern for distributing a single knowledge base across diverse consumers, reusable for any tool that needs to output to multiple IDEs or agents.
Main CLI entry point for design system generation, wrapping core search and design_system modules. Accepts query, project name, output format, persistence options, and three design dials (variance, motion, density) that bias search results. Demonstrates a well‑structured CLI with multiple modes (single‑use, demonstration, persisted) and ANSI terminal output with color swatches.