# qt-qml

> Claude/Codex skill by [@theqtcompanyrnd](https://omgskills.com/library/theqtcompanyrnd/index.md) · 498 stars · Updated 2026-10-20

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").

Tags: ai-skills, claude-code, codex, github-copilot, qml, qt

## Install

```sh
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.

## Links

- HTML page: https://omgskills.com/library/theqtcompanyrnd/agent-skills/skills/qt-qml/
- GitHub: https://github.com/TheQtCompanyRnD/agent-skills
- Author: [@theqtcompanyrnd](https://omgskills.com/library/theqtcompanyrnd/index.md)

## More from this repo

- [qt-canvas2d](https://omgskills.com/library/theqtcompanyrnd/agent-skills/skills/qt-canvas2d/index.md) — Applies Qt Canvas2D (QtCanvas2D / Qt Canvas Painter, Qt 6.12+) best practices when producing or working with Canvas2D...
   - [@theqtcompanyrnd](https://omgskills.com/library/theqtcompanyrnd/index.md) · 498 stars
- [qt-cmake-project](https://omgskills.com/library/theqtcompanyrnd/agent-skills/skills/qt-cmake-project/index.md) — Use to generate or update Qt 6 CMake projects or edit CMakeLists.txt, add sources/resources or define targets...
   - [@theqtcompanyrnd](https://omgskills.com/library/theqtcompanyrnd/index.md) · 498 stars
- [qt-cpp-docs](https://omgskills.com/library/theqtcompanyrnd/agent-skills/skills/qt-cpp-docs/index.md) — Generates standalone Markdown reference documentation for any Qt/C++ source files — Qt Widgets classes, Qt Quick...
   - [@theqtcompanyrnd](https://omgskills.com/library/theqtcompanyrnd/index.md) · 498 stars