Qt AI Skills
Официальные скиллы Qt: ревью C++ и QML, лучшие практики QML и CMake, тесты Qt Quick, документация, профайлер и Figma в QML, плюс MCP с документацией Qt
- 513 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Скиллы запускают скрипты линтинга, `qmlprofiler` и `qmltestrunner`, а флаг --wire-up может менять тестовую инфраструктуру CMake
- Плагин подключает размещенный MCP-сервер документации Qt, запросы уходят на сторону Qt
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/qt-ai-skillsОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Скиллы запускают скрипты линтинга, `qmlprofiler` и `qmltestrunner`, а флаг --wire-up может менять тестовую инфраструктуру CMake
- Плагин подключает размещенный MCP-сервер документации Qt, запросы уходят на сторону Qt
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Qt AI Skills — официальный набор скиллов от Qt для разработки и контроля качества приложений на Qt. Он рассчитан на Claude Code, Codex CLI и GitHub Copilot, а при ручной подгонке работает и с другими инструментами. Авторы проверяли скиллы на моделях семейств Claude, Gemini и GPT. Скиллы четырех типов. Ревью: `qt-cpp-review` сочетает детерминированный линтинг и шесть параллельных агентов глубокого анализа (владение памятью, потоки, корректность, ошибки, производительность), qt-qml-review добавляет к этому более 47 правил QML. Концептуальные: `qt-qml` исправляет систематические ошибки моделей с привязками, областями видимости и модулями, qt-canvas2d описывает Qt Canvas2D из Qt 6.12, `qt-ui-design` разбирает дизайн интерфейсов для Qt/QML, веба и встраиваемых устройств, `qt-cmake-project` настраивает проекты Qt 6 на CMake. Процессные: `qt-qml-docs` и `qt-cpp-docs` пишут справку в Markdown, `qt-qml-test` создает тесты Qt Quick Test, а `qt-figma-token-extraction` и `qt-figma-component-generation` переносят токены и компоненты Figma в синглтоны и контролы QML. Инструментальные: `qt-qml-profiler` запускает `qmlprofiler` и разбирает трассу, `qt-qml-test-run` собирает и запускает тесты с отчетом. В набор входит и MCP-сервер `qt-documentation-mcp` для поиска по документации Qt.
Для кого. Для разработчиков на Qt, C++ и QML, команд встраиваемых интерфейсов и QA-инженеров, которые проверяют и пишут код с помощью агента.
Подходит, если
- Перед слиянием нужно проверить Qt C++ код на владение памятью, потокобезопасность и обработку ошибок
- QML-файлы разрастаются, и нужен разбор привязок, загрузчиков, делегатов и производительности
- Из дизайн-системы Figma нужно получить `design-tokens.json` и QML-контролы под Qt Quick Controls 2
- К компонентам QML нужны тесты tst_*.qml с TestCase и SignalSpy и отчет о прогоне
- Приложение на Qt Quick тормозит, и нужен разбор трассы `qmlprofiler` по исходникам
Не подходит, если
- Нужен Qt Quick 3D: профайлер скилла его не покрывает
- Нужна настройка раннера и CMake для тестов QML: `qt-qml-test` ее не включает, она есть только в `qt-qml-test-run` с флагом --wire-up
- Агент без запуска скриптов и субагентов, например Copilot без линтера: ревью получится менее полным, только статические рекомендации
- Проект не на Qt: скиллы написаны под Qt, QML и Qt Quick
Пример запроса к агенту
Проверь src/mainview.cpp и MainView.qml скиллами `qt-cpp-review` и qt-qml-review: сначала линтеры, потом глубокий разбор. Результат собери в список по критичностиОграничения
Авторы предупреждают, что скиллы используют ИИ и могут ошибаться, результат нужно перепроверять. При использовании по коммерческой лицензии Qt нужно принять условия Qt AI Services. В SKILL.md указана лицензия LicenseRef-Qt-Commercial OR BSD-3-Clause.
Qt Canvas2D требует Qt 6.12 или новее, живое превью QML через MCP тоже работает на Qt 6.12 и выше. В Cursor и Windsurf скилл превращается в правило, а Windsurf использует сжатые варианты для `qt-cpp-review`, qt-qml-review, `qt-qml-docs` и `qt-qml` без скриптов и субагентов.
Как отключить. В Claude Code удалите плагин командой /plugin или уберите символическую ссылку и папки скиллов из ~/.claude/skills либо .claude/skills. Для Codex удалите папки из ~/.codex/skills, для Gemini CLI удалите расширение, для Cursor удалите созданные правила.
Частые вопросы
Как поставить скиллы Qt в Claude Code?
Выполните /plugin marketplace add TheQtCompanyRnD/agent-skills и /plugin install qt-development-skills. Отдельные скиллы можно подключить вручную: символической ссылкой из skills/qt-qml-review в ~/.claude/skills или копированием в .claude/skills проекта.
Как использовать эти скиллы с Cursor или Windsurf?
Эти инструменты не читают каталоги скиллов. В Cursor SKILL.md копируют в .cursor/rules как RULE.md, в Windsurf берут сжатый вариант из platforms/windsurf.md. Скрипты и субагенты там не работают, остается только статическое руководство.
Что проверяет qt-qml-review?
Детерминированный линтинг по более чем 47 правилам QML и параллельные агенты глубокого анализа: привязки, раскладка, загрузчики, делегаты, состояния и производительность.
Есть ли у Qt MCP-сервер с документацией для агента?
Да, `qt-documentation-mcp`: размещенный сервер для поиска по документации Qt в последнем релизе и активных LTS-ветках. В Claude Code он идет в составе плагина qt-development-skills, а отдельно доступен как io.qt/qt-documentation-mcp в официальном реестре MCP.
Как перенести дизайн из Figma в QML?
Скилл `qt-figma-token-extraction` выгружает токены, стили текста и переменные в `design-tokens.json` и синглтоны QML. Затем `qt-figma-component-generation` генерирует контролы под Qt Quick Controls 2, ему нужны токены из первого скилла.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыОдиннадцать скиллов для Claude Code и Codex: аудит тестов, очистка git worktree, страницы планов, расшифровка записей экрана и вход через 1Password
Скилл для ревью кода по многим языкам и фреймворкам: архитектура, производительность, безопасность, антипаттерны и типичные ошибки
Claude Code Skills, китайский набор
Claude Code Skills 中文精选集
Набор из 21 собственного скилла для Claude Code с китайским выводом: ревью кода, README, тесты API, рефакторинг, профилирование
Маркетплейс Claude Code из 19 плагинов и 76 скиллов по фронтенду, бэкенду, DevOps и безопасности с командой сборки цепочек
Скиллы команды Dart: тесты и моки, анализ и dart fix, CLI-приложения, FFI, документация и разбор конфликтов пакетов для ИИ-агента
14 скиллов, которые находят пробелы в задаче до кода: интервью, план, проверка допущений и доказательство исправления бага
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Qt AI Skills (эта запись) | да | 513 | ||
| code-review-skill | нет | 2 163 | общий скилл ревью для многих языков, ревью Qt C++ и QML с линтерами в нем нет | |
| Figma MCP Server | да | OAuth | 2 128 | официальный MCP Figma отдает данные макета; перенос токенов и компонентов в QML-синглтоны и контролы делают скиллы Qt |
Коротко о README
README объясняет состав набора: 13 скиллов в таблице с типами Review, Conceptual, Process и Tool и MCP-инструмент документации. Затем структура репозитория, формат SKILL.md и правила описания, таблица поддержки инструментов и установка для Claude Code, Codex, Copilot CLI, VS Code, Gemini CLI, Cursor и Windsurf. В конце сайт документации на doc.qt.io и правила для контрибьюторов.
Бейдж для README
Исходный SKILL.md
---
name: qt-qml
description: >-
Applies QML best practices when producing or working with QML source code.
Use whenever QML code is the primary subject: writing, reviewing, fixing,
refactoring, optimizing, or debugging QML files, components, or bindings.
Do NOT trigger for purely conversational QML questions where no code is
produced or examined (e.g. "explain how anchors work").
license: LicenseRef-Qt-Commercial OR BSD-3-Clause
compatibility: >-
Designed for Claude Code, GitHub Copilot, and similar agents.
disable-model-invocation: false
metadata:
author: qt-ai-skills
version: "1.2"
qt-version: "6.x"
category: conceptual
---
# QML Coding Skill
## How to apply this skill
**On every invocation of this skill** — writing, editing, reviewing, or
validating QML — scan the connected MCP servers for a `run_qmlPreview` tool,
whose *purpose* is starting a QML preview or hot-reload session. Do this even
on read-only turns: a review is usually the turn *before* someone starts
changing things, and the scan reads an inventory you already have.
- **Found one — settle the Qt version first.** The server needs **Qt 6.12 or
newer** and does not report that itself; on older Qt the preview fails
silently, which is far harder to diagnose than an upfront check. Look inside
the project: `<build-dir>/CMakeCache.txt` → `Qt6_DIR` → `PACKAGE_VERSION` in
`<Qt6_DIR>/Qt6ConfigVersion.cmake`; failing that, ask the user. Don't
disqualify on `find_package(Qt6 6.x REQUIRED)` — it declares a *minimum*, so
it can confirm a project is new enough but never that it is too old. Settle
this once per session.
- **6.12 or newer** — read and follow
[references/qmlpreview.md](references/qmlpreview.md).
- **Older, or unknown** — say that live preview needs Qt 6.12 or newer, then