qt-qml-review

Reviews Qt6 QML code using deterministic linting and six parallel deep-analysis agents.

1|Updated Jul 12, 2026
One-click install
npx skills add https://github.com/TypeThe0ry/Multi-Detect --skill qt-qml-review-typethe0ry
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: qt-qml-review
Source: https://github.com/TypeThe0ry/Multi-Detect/tree/main/ground-control/MultiDetectGCS/tools/skills/qt-qml-review
Command: npx skills add https://github.com/TypeThe0ry/Multi-Detect --skill qt-qml-review-typethe0ry

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Qt6 QML codebases accumulate subtle defects—binding loops, delegate reuse bugs, layout conflicts, and performance anti-patterns—that manual review often misses. This Skill automates structured, read-only QML code review by combining a deterministic 47+ rule linter with six focused deep-analysis agents, producing a consolidated report with confidence-scored findings and mitigations. ## Core Features & Use Cases - Deterministic Linting: A single-pass Python script checks 47+ rules across 13 categories (imports, bindings, layout, loaders, delegates, states, images, performance, style, signals, errors, JavaScript) in under a second, with optional qmllint integration for type-level checks. - Parallel Deep Analysis: Six agents analyze bindings and properties, layout and anchoring, component lifecycle, ListView delegates, states and transitions, and performance, reporting only findings above 80/100 confidence. - Scoped Reviews: Supports both narrow diff/commit scope (review only changed lines) and wide codebase scope (glob all *.qml files in a directory). - Use Case: Before committing QML changes to a Qt6 ground station application, run this Skill to catch issues like missing required property declarations in delegates, Loader.item access without status guards, or anchors mixed with Layout.* on the same item. ## Quick Start Ask the AI to review your Qt6 QML code, for example: review the QML files in src/ui/ or check my staged QML changes before I commit.

Frequently Asked Questions about qt-qml-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I review Qt6 QML code before committing?▼

Invoke the review on your staged or unstaged changes using git diff scope detection. The skill runs a Python linter with 47+ rules, then six parallel analysis agents, and reports only high-confidence issues with file paths, line numbers, and mitigations.

What QML issues does a linter catch that qmllint misses?▼

The Python linter covers style, ordering, and performance patterns like imperative assignment destroying bindings, transparent Rectangles, and missing sourceSize on Images. qmllint handles type-level checks like unresolved types and unqualified access, and both outputs are merged and deduplicated.

Does this QML review tool modify my code?▼

No, the review is strictly read-only. The linter and all six analysis agents only read files and report findings with prose mitigations; they never edit, write, or apply code patches.

Can I use qmllint together with this QML review?▼

Yes, if qmllint from a Qt 6 installation is found on your system, it runs with JSON output and its type-level findings are merged with the Python linter results. If qmllint is unavailable, the review continues with a warning.

What are the limitations of the QML linter script?▼

The linter uses regex and brace tracking rather than a full QML parser, so multiline expressions or QML-like patterns inside string literals can cause false positives. It also cannot resolve types across files, which is why semantic checks are delegated to the analysis agents.

Which platforms support the full QML review skill?▼

The full multi-phase skill with the Python linter and parallel agents works natively on Claude Code and Codex CLI. GitHub Copilot loads the static guidance only, and a condensed variant is available for Windsurf.