qt-qml — скилл для Claude Code: что делает и как установить
Скилл внедряет стандарты оформления кода на QML при написании компонентов, рефакторинге и ревью. Пригодится разработчикам интерфейсов на Qt 6.
npx skills add TheQtCompanyRnD/agent-skills --skill qt-qml -a claude-codeЧто делает qt-qml
Скилл задаёт строгие рамки для работы с QML. Ассистент генерирует лаконичный код без шаблонных комментариев и лишних обёрток. При ревью агент не даёт общих советов. Он молча сверяет файл со стандартами и выдаёт только нарушенные правила со ссылкой на строку. Если проблем много, покажет пять главных замечаний.
Внутри заложены правила декомпозиции и загрузки интерфейса. Файл main.qml остаётся простой точкой входа без бизнес-логики. Компоненты выносятся в отдельные файлы при глубине вложенности от трёх уровней или длине от 150–200 строк. Для Qt 6 исключаются номера версий в директивах import. Динамическая загрузка интерфейса настраивается через Loader с обязательной выгрузкой неиспользуемых элементов.
Перед началом работы скилл проверяет наличие MCP-инструмента run_qmlPreview. Предпросмотр интерфейса работает только на Qt 6.12 или новее. На старых версиях инструмент молча ломается. Это повод заранее проверить PACKAGE_VERSION внутри CMakeCache.txt.
Какие задачи решает
- Провести аудит чужого QML-файла и выявить нарушения стандартов Qt
- Декомпозировать разросшийся
main.qmlна независимые компоненты - Настроить отложенную загрузку тяжёлых диалогов через
Loader - Очистить импорты в проекте на Qt 6 от устаревших номеров версий
Примеры запросов агенту
- Проверь этот файл на соответствие правилам QML и покажи главные нарушения
- Вынеси боковую панель из main.qml в отдельный компонент
- Оптимизируй загрузку диалоговых окон через Loader
Как установить qt-qml
1Через Skills CLI (Vercel)
npx skills add TheQtCompanyRnD/agent-skills --skill qt-qml -a claude-code2Вручную: положить файлы
~/.claude/skills/qt-qml/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/qt-qml/
1Через Skills CLI (Vercel)
npx skills add TheQtCompanyRnD/agent-skills --skill qt-qml -a codex2Вручную: положить файлы
.agents/skills/qt-qml/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add TheQtCompanyRnD/agent-skills --skill qt-qml -a cursor2Вручную: положить файлы
.cursor/skills/qt-qml/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install TheQtCompanyRnD/agent-skills qt-qml2Вручную: положить файлы
.github/skills/qt-qml/SKILL.md1Через Skills CLI (Vercel)
npx skills add TheQtCompanyRnD/agent-skills --skill qt-qml -a gemini-cli2Командой платформы
gemini skills install https://github.com/TheQtCompanyRnD/agent-skills --path skills/qt-qmlВручную: положить файлы
.devin/skills/qt-qml/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add TheQtCompanyRnD/agent-skills --skill qt-qml -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о qt-qml
Как установить qt-qml в Claude Code?
Выполните команду npx skills add TheQtCompanyRnD/agent-skills --skill qt-qml -a claude-code в терминале.
Зачем нужен скилл qt-qml?
Он заставляет ассистента следовать официальным стандартам QML для Qt 6. Модель генерирует компактный код без шаблонных комментариев и проверяет структуру проекта на скрытые ошибки.
Какая версия Qt требуется для живого предпросмотра?
Для работы инструмента run_qmlPreview через MCP необходим Qt 6.12 или новее. На более старых релизах предпросмотр не запускается и завершается сбоем без сообщений об ошибке.
