qt-qml
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").
Install
With your agent
Install OMGSkills skill "theqtcompanyrnd/agent-skills:skills/qt-qml" into this agent's normal skills directory: call the OMGSkills MCP get_install_plan tool for your agent and run the script it returns (it installs only the pinned commit and verifies SKILL.md), and stop if MCP or the pin is unavailable. Do not overwrite or change existing skills without asking me.
Manual command
git clone https://github.com/TheQtCompanyRnD/agent-skills /tmp/agent-skills && ln -s /tmp/agent-skills/skills/qt-qml ~/.claude/skills/qt-qml
From README
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 runqmlPreview 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: /CMakeCache.txt → Qt6DIR → PACKAGEVERSION in /Qt6ConfigVersion.cmake; failing that, ask the user. Don't disqualify on findpackage(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.
More from this repo
qt-canvas2d
Applies Qt Canvas2D (QtCanvas2D / Qt Canvas Painter, Qt 6.12+) best practices when producing or working with Canvas2D...
qt-cmake-project
Use to generate or update Qt 6 CMake projects or edit CMakeLists.txt, add sources/resources or define targets...
qt-cpp-docs
Generates standalone Markdown reference documentation for any Qt/C++ source files — Qt Widgets classes, Qt Quick...
