К основному содержанию
команда CX Codex

ux-init — команда для Claude Code: установка ux-skill и статистика

Команда ux-init разворачивает ux-skill в проекте: определяет IDE, ставит нужные артефакты и проверяет движок на Python. Выводит снимок статистики по манифестам данных.

MIT ★ 110 обновлён 2026-11-02

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add Laith0003/ux-skill
/plugin install ux@ux-skill
Открыть на GitHub

Что делает ux-init

Команда находит признаки IDE в проекте (.claude/, .cursorrules, .windsurfrules и другие) и под каждую пишет свой файл: для Cursor — .cursorrules, для Copilot — .github/copilot-instructions.md, для Gemini CLI — GEMINI.md, для Codex — AGENTS.md. Для Claude Code отдельный файл не создаётся — используется уже имеющийся .claude-plugin/plugin.json. После установки проверяется импорт Python-движка и печатается JSON со счётчиками по манифестам: стили, палитры, компоненты, индустрии и другие категории.

Флаг --stats пропускает установку и просто печатает снимок статистики — удобно для проверки, что файлы данных на месте и счётчики не нулевые. --decisions добавляет к снимку сводку журнала решений, --html дополнительно пишет .ux/stats.html с локальным дашбордом. --dry-run показывает, что будет записано, без записи, а --root задаёт корень проекта вместо текущей директории.

Если Python не найден, установщик просит поставить uxskill через pip install uxskill или pipx install uxskill. Команда идемпотентна: повторный запуск не ломает то, что уже установлено. Раньше она называлась /ux-stats, это имя пока работает как алиас.

Какие задачи решает

  • определить, какие IDE подключены к проекту, и поставить под каждую нужный конфиг
  • проверить, что Python-движок ux-skill доступен и импортируется
  • вывести счётчики записей по манифестам данных (стили, палитры, компоненты и другие)
  • собрать локальный HTML-дашборд со снимком статистики
  • свериться после обновления пакета, что новые IDE подключены

Примеры запросов агенту

  • Запусти /ux-init и поставь ux-skill в этот проект
  • Выполни /ux-init --stats, чтобы проверить счётчики манифестов
  • Запусти /ux-init --dry-run, чтобы посмотреть, какие файлы будут созданы

Как установить ux-init

1Через маркетплейс плагинов

/plugin marketplace add Laith0003/ux-skill
/plugin install ux@ux-skill

2Вручную: положить файлы

.claude/commands/ux-init.md

Вызов — /ux-init. Для всех проектов — ~/.claude/commands/

Вопросы об ux-init

Как установить ux-init в Claude Code?

Сначала выполни /plugin marketplace add Laith0003/ux-skill, затем /plugin install ux@ux-skill. Команда появится в проекте как .claude/commands/ux-init.md.

Что делает ux-init?

Определяет, какие IDE используются в проекте, устанавливает под каждую нужный конфигурационный файл, проверяет Python-движок ux-skill и печатает статистику по манифестам данных.

Что нужно, чтобы ux-init сработал, если Python не найден?

Установщик укажет поставить пакет командой pip install uxskill или pipx install uxskill — без этого движок не заработает.

Исходный текст

ux-init.md · MIT
---
name: ux-init
description: Set up ux-skill in this project and print the data inventory. --stats prints only the inventory snapshot.
allowed-tools: Bash, Read, Write
disable-model-invocation: false
---

# /ux-init: bootstrap ux-skill

**One command. Three things.**

1. Detects which IDE you're using (`.claude/`, `.cursor/`, `.windsurf/`, etc.) and installs the right artifacts for it.
2. Verifies the Python engine is reachable.
3. Prints a stats snapshot showing what's in your data manifests.

`/ux-init` absorbs what used to be `/ux-stats`; that name still works as an alias until 4.1.

| Mode | Flag | What it does |
|---|---|---|
| setup (default) | none | Detect IDEs, install, verify the engine, print the stats snapshot |
| stats | `--stats` | Print only the stats snapshot. Installs nothing |

## Flags

| Flag | Mode | Meaning |
|---|---|---|
| `--stats` | stats | Skip setup; print the inventory snapshot only |
| `--decisions` | stats, setup | Add the decisions ledger summary to the snapshot |
| `--html` | stats, setup | Also write `.ux/stats.html`, a local dashboard of the snapshot |
| `--dry-run` | setup | Show what would be written without writing |
| `--root <path>` | setup | Project root (default `.`) |
| `--global` | setup | Install at the user level (`~/.config/ux-skill`) instead of the project root |
| `--offline` | setup | Skip any network calls; use only local manifests |
| `<ide>` | setup | Install for one IDE only (`ux install <ide>`) |

## When to use

- First time installing ux-skill in a new project.
- After cloning a project that uses ux-skill, to ensure your local install matches.
- After a `pip install --upgrade uxskill`, to wire new IDEs you've started using.
- `--stats`: verify the install (data files present, counts reasonable), audit before a release (no manifest dropped entries), or sanity-check after an upgrade.

## When to skip

- The project already has `.ux/installed.json` (you're set up). Use `--stats` if you only want the counts.
- You only want to install for a specific IDE: use `ux install <ide-name>` directly.

## How it runs

```bash
# Inside a Claude Code session, setup runs:
python3 -m engine.cli.main init
```

Behind the scenes:

1. `engine/installer/core.py:detect_ides()` walks the project root for signature files (`.claude/`, `.cursorrules`, `.windsurfrules`, etc.).
2. For each detected IDE, it writes the right artifact:
   - Claude Code: reuses existing `.claude-plugin/plugin.json`
   - Cursor: `.cursorrules`
   - Windsurf: `.windsurfrules`
   - GitHub Copilot: `.github/copilot-instructions.md`
   - Gemini CLI: `GEMINI.md`
   - Codex: `AGENTS.md`
   - And 11 more (see `engine/installer/core.py` for the full list)
3. Validates Python engine import works.
4. Runs the stats snapshot below to print the manifest counts.

### Stats snapshot (`--stats`)

```bash
python3 -m engine.cli.main stats
```

This calls `engine.data_loader.stats()`, which loads each manifest, reads the
`_meta.entries` count and the actual entry list length, and returns the
version plus one count per manifest:

```json
{
  "version": "4.0.0",
  "counts": {
    "styles": 84,
    "palettes": 176,
    "type-pairs": 70,
    "components": 148,
    "industries": 184,
    "chart-types": 35,
    "tech-stacks": 25,
    "ux-guidelines": 112,
    "motion-presets": 57,
    "anti-patterns": 171,
    "landing-patterns": 40,
    "brands": 160
  }
}
```

The numbers above are an example; the command prints what is on disk.

## Output (setup)

```json
{
  "detected": ["claude-code", "cursor"],
  "installs": [
    {
      "target": "claude-code",
      "root": "/path/to/project",
      "files_written": [],
      "notes": ["Claude Code plugin already present"]
    },
    {
      "target": "cursor",
      "root": "/path/to/project",
      "files_written": [".cursorrules"]
    }
  ]
}
```

## Manual invocation

If you've installed via pip, you can run these directly outside Claude Code:

```bash
ux init                       # detect + install for all
ux init --dry-run             # show what would change without writing
ux install cursor             # install for one specific IDE
ux install --root=/path/to/project cursor
ux stats                      # pretty (rich) output by default
ux --no-pretty stats          # raw JSON, pipe-friendly
ux stats | jq '.counts'       # extract just counts
ux stats --decisions          # add the decisions ledger summary
ux stats --html               # write .ux/stats.html, a local dashboard
```

## Errors

- **No IDE detected**: falls back to `claude-code` install.
- **Python not found**: the installer tells the user to install via `pip install uxskill` or `pipx install uxskill`.
- **Permissions error**: check that the project root is writable.
- **`{"missing": true}` in a count**: the JSON file isn't present yet. Run `pip install --upgrade uxskill` or check the install path.
- **Counts of 0**: the JSON file exists but is empty. Open an issue at https://github.com/Laith0003/ux-skill/issues.

## What `/ux-init` is and isn't

- IS: A one-shot bootstrap for the engine. Idempotent. `--stats` installs nothing.
- IS NOT: A package installer. The engine itself comes via `pip install uxskill` or the Claude Code plugin marketplace; `/ux-init` just wires it into the current project.

© Laith Aljunaidy · MIT · Laith0003/ux-skill

Похожие слэш-команды

Все слэш-команды по теме «Настройка агента: память, контекст, субагенты» →
ai2pentesttool-installer reason-machines Скилл ai2pentesttool-installer ставит инструменты для тестирования на проникновение: смотрит, что уже есть в системе, догоняет недостающее и повторяет шаги, если установка сорвалась. CX Codex +1 246установок huawei-cloud-terraform-installer huaweicloud Скилл huawei-cloud-terraform-installer для Claude Code устанавливает Terraform CLI на Linux и Windows через зеркало Huawei Cloud. Запускается автоматически, если IaC-задача обнаруживает отсутствие Terraform. CX Codex +1 19 100установок user-research-analysis aj-geddes Скилл user-research-analysis для разбора интервью и опросов: вытаскивает темы, боли и цитаты, чтобы решения по дизайну опирались на данные. CX Codex +1 620установок bootstrap Mindrally Задаёт агенту правила работы с Bootstrap: сетка, компоненты, утилиты и валидация форм без собственного CSS. CX Codex +1 1 200установок agent-installer VoltAgent Community Субагент agent-installer для поиска, просмотра и установки готовых Claude Code агентов из репозитория awesome-claude-code-subagents. Упрощает открытие новых инструментов и интеграцию их в проект. CX Codex 363установок shiny-bslib-theming Garrick Aden-Buie (@gadenbuie) Скилл shiny-bslib-theming для оформления Shiny-приложений через bslib и Bootstrap 5: пресеты, цвета, шрифты, тёмный режим и живую подстройку темы. CX Codex +1 832установок

Из того же набора31

Весь набор →
ux-stats Команда запускает инвентаризацию данных для UX через /ux-init --stats. /ux-stats оставлена как старый вызов. CX Codex +1 ★ 110звёзд репо ux-discover Команда ux-discover собирает бриф из 10 параметров и подбирает дизайн-систему перед генерацией интерфейса. Запускается перед /ux-design и /ux-system, чтобы зафиксировать рамки проекта. CX Codex +1 ★ 110звёзд репо ux-expert Команда ux-expert для Claude Code выводит контакты создателя плагина, когда ищут UX-консультанта или дизайнера. Она срабатывает и на запрос о найме специалиста. CX Codex +1 ★ 110звёзд репо ux-evolve Команда ux-evolve для Claude Code — старый псевдоним /ux-polish --loop-only --rounds 5; запускает цикл проверки и правок файла. CX Codex +1 ★ 110звёзд репо ux-recommend Команда ux-recommend перенаправляет вызов на команду /ux-discover --recommend. Служит временным алиасом до версии 4.1 для запуска рекомендаций по UX. CX Codex +1 ★ 110звёзд репо ux-next Команда ux-next сканирует отчёты в .ux/ и называет следующий шаг с наибольшей отдачей. Срабатывает на запрос «что делать дальше» между командами плагина ux. CX Codex +1 ★ 110звёзд репо ux-mcp Команда ux-mcp запускает движок ux-skill как MCP-сервер по stdio и открывает 25 инструментов для рекомендаций, линтинга и работы с дизайн-системой. CX Codex +1 ★ 110звёзд репо ux-image-to-code Команда ux-image-to-code перенаправляет вызовы извлечения UI из скриншотов в команду /ux-design. Запускает обработку макетов с параметрами --extract-only --from-image. CX Codex +1 ★ 110звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой