Об этом проекте

# ux-skill — Движок дизайн-интеллекта для ИИ-инструментов кодирования ux-skill — это **движок дизайн-интеллекта**, предназначенный для того, чтобы сделать сгенерированный ИИ пользовательский интерфейс отличительным, а не шаблонным. Он интегрируется с 17 ИИ-инструментами кодирования, включая Claude Code, Cursor, Windsurf, GitHub Copilot, Gemini CLI, Codex и другие. Движок бесплатен, лицензирован под MIT, работает офлайн и никогда не вызывает LLM. ## Ключевые возможности - **Детерминированный 7-осевой синтезатор**: Компилирует брифы в свежие дизайн-токены (теплота, контраст, плотность, геометрия, формальность, движение, характер шрифта) без выбора из шаблонов. - **152 правила линтинга против ИИ-халтуры**: Детерминированные правила на основе регулярных выражений, которые запускаются в CI и завершаются ненулевым кодом при критических/высоких проблемах. - **160 бренд-спеков**: Реальные спецификации DESIGN.md для таких брендов, как Apple, Stripe, Linear, Figma, Tesla, BMW, Notion, Spotify, Airbnb, Vercel, Supabase, Cursor, Raycast, Claude и других. - **12 запрашиваемых JSON-манифестов**: 84 стиля, 176 палитр, 70 пар шрифтов, 148 компонентов, 184 отрасли, 35 типов диаграмм, 57 пресетов движения, 112 UX-законов, 152 правила анти-паттернов, 25 технологических стеков и 160 бренд-спеков. - **25 слэш-команд**: Команды обнаружения, генерации, аудита, линтинга, полировки, цикла исправлений, кейс-стади, воркшопа, копирайтинга, движения, доступности, дашборда и дирижирования. - **5 субагентов**: Фронтенд-инженер, инженер по движению, копирайтер, синтезатор исследований и архитектор дизайн-систем. - **18 MCP-инструментов**: Включая ux_synthesize, ux_decisions_query и ux_decisions_stats. - **Поддержка 17 IDE**: Тот же движок с разной склейкой для каждой IDE. - **Офлайн и детерминированность**: Без вызовов LLM, одинаковый ввод всегда дает одинаковый вывод. ## Установка Доступны три пути установки: ### Путь 1 — Маркетплейс Claude Code (канонический) ```bash /plugin marketplace add Laith0003/ux-skill /plugin install ux@ux-skill ``` ### Путь 2 — pip (универсальный) ```bash pip install uxskill uxskill init # автоматически определяет вашу IDE, устанавливает нужный артефакт uxskill stats # выводит количество манифестов для проверки установки uxskill lint . # запускает линтер для текущей директории ``` ### Путь 3 — npx (Python не требуется) ```bash npx uxskill init # загружает pipx + uxskill при первом запуске npx uxskill recommend --industry=fintech-neobank --tone=warm --stack=nextjs-15-app-router ``` ## Как это работает 1. **Ввод**: Предоставьте бриф через `/ux-discover` (10 полей) или флаги к `ux recommend`. 2. **5 параллельных поисков**: Движок выполняет пять одновременных запросов по манифестам (отрасль, стиль, тон, стек, запрещенные/региональные). 3. **Слияние**: Детерминированный объединитель ранжирует кандидатов и разрешает конфликты. 4. **Вывод**: JSON-документ со стилем, палитрой, парой шрифтов, пресетами движения, компонентами, примерами брендов и защитными анти-паттернами. 5. **Генерация**: Последующие команды используют рекомендацию для генерации кода через субагентов. 6. **Проверка**: `/ux-lint` повторно сканирует сгенерированный код на соответствие 152 правилам регулярных выражений. ## Основные моменты v3.1.0 - **Соблюдение бренда**: Основной цвет считывается из пикселей логотипа, стандартные шрифты отклоняются, жесткий минимум в оценке, который отклоняет выводы, теряющие цвет/логотип бренда или не содержащие реальных изображений. - **Мобильный приоритет**: Новые основы мастерства плюс гейт, учитывающий перенос, который отклоняет горизонтальную прокрутку, переносящуюся навигацию/слово-бренд/подпись кнопки или слишком высокий липкий заголовок. - **Слой "вау"**: Движок выводит 2-3 согласованных фирменных момента на страницу. - **Более точный линтер**: 152 правила, включая обязательность изображений, обнаружение только иконок, токены-заглушки и правила 100vw. - **310 пройденных тестов**: Офлайн, детерминированно, LLM никогда не вызывается. ## Архитектура Движок состоит из: - **data/**: Запрашиваемые JSON-манифесты (стили, палитры, пары шрифтов, компоненты, отрасли, типы диаграмм, технологические стеки, UX-руководства, пресеты движения, анти-паттерны, бренды). - **engine/**: Ядро рассуждений на Python (синтезатор, решения, рекомендатель, линтер, обнаружение, генератор, установщик, CLI). - **commands/**: 25 слэш-команд Claude Code (файлы .md). - **agents/**: 5 субагентов (файлы .md). - **references/**: Прозаический исходник для данных и демонстрационных страниц. - **bin/**: Обертка npx и скрипты линтера. - **.ux/**: Каталог состояния для каждого проекта. ## Сравнение В README есть честное сравнение с 8 другими UX-плагинами Claude, где указано, где ux-skill выигрывает (библиотека компонентов, пресеты движения, линтер анти-паттернов, бренд-спеки, поддержка 17 IDE, 25 слэш-команд) и где проигрывает (осведомленность, узнаваемость бренда, маркетинговая полировка). ## Лицензия Лицензия MIT. Автор: Лейт Альджунаиди, дизайнер и технический директор в Аммане. Сайт: uxskill.laithjunaidy.com. GitHub: Laith0003/ux-skill. PyPI: uxskill. npm: uxskill.