qt-qml-review — скилл для Claude Code: ревью Qt6 QML
Проверяет Qt6 QML: сначала детерминированный линтер, потом агенты по семи доменам, на выходе один отчёт только с уверенными находками.
npx skills add TheQtCompanyRnD/agent-skills --skill qt-qml-review -a claude-codeЧто делает qt-qml-review
Скилл запускается, когда просишь ревью, аудит или проверку QML перед коммитом. Сначала идёт Python-линтер без зависимостей, больше 48 правил по группам IMP, ORD, BND, LAY, LDR, DEL, STA, IMG, PRF, STY, SIG, ERR, JS. К нему подключается qmllint — его предупреждения попадают в отчёт строками QL:<id>. Если Python не нашёлся, скилл предупредит и продолжит.
Дальше глубокий разбор по семи разделам: биндинги, вёрстка, загрузка компонентов, делегаты ListView, состояния и переходы, производительность, логика. Размер разбора зависит от объёма: до 1500 строк анализ идёт прямо в основном контексте, дальше файлы режутся на шарды примерно по 1500 строк, до шести агентов параллельно. У скилла есть свой режим --diff: находки только на изменённых строках, так что ревью конкретного коммита дешевле полного аудита каталога.
Код скилл не правит, только показывает проблемы с рекомендациями. Находки ниже порога уверенности отсекаются, поэтому мелкий стиль в отчёт не попадёт. В режиме --diff нужен git-репозиторий, иначе файл не из чего брать. Для проверок типов нужен установленный Qt 6 — линтер ищет qmllint в $QT_HOST_PATH/bin, в PATH и в свежем наборе Qt из онлайн-установщика; если Qt лежит в нестандартном месте, укажи путь через --qmllint=<kit>/bin и больше не ищи.
Какие задачи решает
- прогнать линтер по каталогу QML и получить сводку по правилам
- проверить перед коммитом только изменённые строки
- найти тяжёлые места в делегатах и загрузке компонентов
- сверить типы через
qmllintи увидеть его замечания рядом с остальными - разобрать большой проект по частям, не забивая контекст целиком
Примеры запросов агенту
- Отревью изменения в
qml/перед коммитом, только по диффу - Проведи аудит
src/ui— интересуют делегаты и биндинги - Посмотри этот коммит и скажи, что стоит поправить до пуша
Как установить qt-qml-review
1Через Skills CLI (Vercel)
npx skills add TheQtCompanyRnD/agent-skills --skill qt-qml-review -a claude-code2Вручную: положить файлы
~/.claude/skills/qt-qml-review/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/qt-qml-review/
1Через Skills CLI (Vercel)
npx skills add TheQtCompanyRnD/agent-skills --skill qt-qml-review -a codex2Вручную: положить файлы
.agents/skills/qt-qml-review/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add TheQtCompanyRnD/agent-skills --skill qt-qml-review -a cursor2Вручную: положить файлы
.cursor/skills/qt-qml-review/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install TheQtCompanyRnD/agent-skills qt-qml-review2Вручную: положить файлы
.github/skills/qt-qml-review/SKILL.md1Через Skills CLI (Vercel)
npx skills add TheQtCompanyRnD/agent-skills --skill qt-qml-review -a gemini-cli2Командой платформы
gemini skills install https://github.com/TheQtCompanyRnD/agent-skills --path skills/qt-qml-reviewВручную: положить файлы
.devin/skills/qt-qml-review/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add TheQtCompanyRnD/agent-skills --skill qt-qml-review -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о qt-qml-review
Как установить qt-qml-review в Claude Code?
Выполни npx skills add TheQtCompanyRnD/agent-skills --skill qt-qml-review -a claude-code, после установки скилл лежит в ~/.claude/skills/qt-qml-review/SKILL.md.
Что делает qt-qml-review?
Проводит ревью Qt6 QML: прогоняет детерминированный линтер, затем разбор по семи доменам и выдаёт единый отчёт без правок в коде.
Нужен ли установленный Qt?
Для стилевых и производительных проверок нет: Python-линтер работает сам. Проверки типов через qmllint доступны, только если Qt 6 найден в системе.
