qt-qml-review — Claude Code skill for Qt6 QML review

What qt-qml-review does

Ask for a review, audit or check of QML code and this skill takes over. A dependency-free Python linter runs first with more than 48 checks split across rule families IMP, ORD, BND, LAY, LDR, DEL, STA, IMG, PRF, STY, SIG, ERR, JS. When qmllint is present it runs too and its warnings merge into the report as QL:<id> rows. No Python on the machine? The skill warns and carries on.

Deep analysis follows, covering seven areas: bindings and properties, layout and anchoring, component loading, ListView delegates, states and transitions, performance, logic and wiring. Scope size decides how it runs. Up to 1500 lines the analysis happens inline in the main context; past that the files are cut into shards of about 1500 lines, at most six agents in parallel. A --diff mode limits findings to changed lines, which makes reviewing one commit cheaper than auditing a whole directory.

The skill is read-only and suggests fixes rather than applying them. Anything below the confidence cutoff is dropped, so nitpicks stay out of the report. Diff mode needs a git repository to work from. Type-level checks depend on a Qt 6 install: the linter looks for qmllint in $QT_HOST_PATH/bin, on PATH and in the newest online-installer kit. If your Qt sits somewhere non-standard, pass --qmllint=<kit>/bin once instead of hunting further.