# qt-qml

Скилл внедряет стандарты оформления кода на QML при написании компонентов, рефакторинге и ревью. Пригодится разработчикам интерфейсов на Qt 6.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1100 установок · ★ 507
- Автор: qt-ai-skills
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/TheQtCompanyRnD/agent-skills/tree/HEAD/skills/qt-qml/SKILL.md
- Обновлён: 2026-10-20
- HTML: https://affpapa.org/nevibecode/skills/qt-qml

## Что делает

Скилл задаёт строгие рамки для работы с QML. Ассистент генерирует лаконичный код без шаблонных комментариев и лишних обёрток. При ревью агент не даёт общих советов. Он молча сверяет файл со стандартами и выдаёт только нарушенные правила со ссылкой на строку. Если проблем много, покажет пять главных замечаний.

Внутри заложены правила декомпозиции и загрузки интерфейса. Файл `main.qml` остаётся простой точкой входа без бизнес-логики. Компоненты выносятся в отдельные файлы при глубине вложенности от трёх уровней или длине от 150–200 строк. Для Qt 6 исключаются номера версий в директивах `import`. Динамическая загрузка интерфейса настраивается через `Loader` с обязательной выгрузкой неиспользуемых элементов.

Перед началом работы скилл проверяет наличие MCP-инструмента `run_qmlPreview`. Предпросмотр интерфейса работает только на Qt 6.12 или новее. На старых версиях инструмент молча ломается. Это повод заранее проверить `PACKAGE_VERSION` внутри `CMakeCache.txt`.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add TheQtCompanyRnD/agent-skills --skill qt-qml -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/qt-qml/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/qt-qml/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add TheQtCompanyRnD/agent-skills --skill qt-qml -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/qt-qml/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add TheQtCompanyRnD/agent-skills --skill qt-qml -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/qt-qml/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install TheQtCompanyRnD/agent-skills qt-qml
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/qt-qml/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add TheQtCompanyRnD/agent-skills --skill qt-qml -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/TheQtCompanyRnD/agent-skills --path skills/qt-qml
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/qt-qml/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add TheQtCompanyRnD/agent-skills --skill qt-qml -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/TheQtCompanyRnD/agent-skills/tree/HEAD/skills/qt-qml/SKILL.md

## Когда брать
- Провести аудит чужого QML-файла и выявить нарушения стандартов Qt
- Декомпозировать разросшийся `main.qml` на независимые компоненты
- Настроить отложенную загрузку тяжёлых диалогов через `Loader`
- Очистить импорты в проекте на Qt 6 от устаревших номеров версий

## Примеры запросов агенту
- Проверь этот файл на соответствие правилам QML и покажи главные нарушения
- Вынеси боковую панель из main.qml в отдельный компонент
- Оптимизируй загрузку диалоговых окон через Loader

## Похожие
- [emil-design-eng](https://affpapa.org/nevibecode/skills/emil-design-eng.md) — скилл · 388200 установок
- [better-interface](https://affpapa.org/nevibecode/skills/better-interface.md) — скилл · 30000 установок
- [interface-review](https://affpapa.org/nevibecode/skills/interface-review.md) — скилл · 18500 установок
- [om-ux-review-pr](https://affpapa.org/nevibecode/skills/om-ux-review-pr.md) — скилл · 2600 установок
- [shadcn-component-review](https://affpapa.org/nevibecode/skills/shadcn-component-review.md) — скилл · 635 установок
- [design-qa-checklist](https://affpapa.org/nevibecode/skills/design-qa-checklist.md) — скилл · 2200 установок

Из того же набора: [theqtcompanyrnd/agent-skills](https://affpapa.org/nevibecode/by/theqtcompanyrnd/agent-skills.md) — 8 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md