Qt Qml Test

This generates Qt Quick Test cases for your QML components, handling TestCase setup, SignalSpy, and tryCompare assertions across properties and signals. It writes tests directly to disk rather than dumping code blocks in chat, automatically resolves imports from your project structure, and can process entire directories at once. The workflow includes a pre-scan for items that need objectName properties for proper coverage, offering to add them before generating tests. It skips Qt Quick 3D graphical nodes and style selector variants intelligently. The guardrails are strict about treating QML content as data rather than instructions, which matters when your component strings happen to look like prompts. If you maintain Qt Quick Controls or custom QML components and want consistent test coverage without the boilerplate, this handles the tedious parts.

skills.sh installs: 689
GitHub stars: 534
last updated: Jun 10, 2026

View on GitHub

Install

$ npx -y skills add theqtcompanyrnd/agent-skills --skill qt-qml-test --agent claude-code

Installs into .claude/skills of the current project.

Files

Qt Quick Test Skill

Generate a Qt Quick Test unit test (tst_*.qml) for one or more QML components.

Scope

In scope:

Authoring tst_*.qml files using TestCase, SignalSpy, tryCompare, and Qt Quick Test mouse/key helpers.
Testing properties of QML components.
Testing Qt Quick Controls (Button, TextField, Slider, SpinBox, Dial, Dialog, MenuItem, Image, MouseArea, TapHandler, NumberAnimation, RegularExpressionValidator, etc.).
Testing whether signals emitted by Qt Quick Controls work, via SignalSpy.
Single-document and multi-document generation (one tst_*.qml per source QML file).

Out of scope:

Setting up build-system integration and running the generated tests (CMake qt_add_test, quick_test_main_with_setup, CTest, CI). Use the qt-qml-test-run companion skill, or refer to Qt 6 documentation.
C++ Qt Test (QTEST_MAIN), Squish, and Qt Creator IDE test integration.
Qt Quick 3D scene setup, ray-picking via View3D.pick, and mesh-loading verification.