qt-qml-test-run

Build and run Qt Quick Tests for QML projects with Markdown reports.

351|38|Updated Mar 26, 2026
One-click install
npx skills add https://github.com/TheQtCompanyRnD/agent-skills --skill qt-qml-test-run
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qt-qml-test-run
Source: https://github.com/TheQtCompanyRnD/agent-skills/tree/main/skills/qt-qml-test-run
Command: npx skills add https://github.com/TheQtCompanyRnD/agent-skills --skill qt-qml-test-run

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires qmltestrunner, CMake, Python, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the process of building and running Qt Quick Tests for a QML project, generating a structured Markdown report for test results.

Core Features & Use Cases

  • Automated Test Execution: Build and run Qt Quick Tests using qmltestrunner or CTest, depending on the project setup.
  • Markdown Reporting: Generates a detailed Markdown report with test results, including pass/fail counts, slowest tests, and failed test details.
  • CMake Integration: Can integrate with CMake projects, adding missing test infrastructure if required.
  • Use Case: If you have a QML project with a set of test files (tst_*.qml), this Skill can be used to automatically run these tests and provide a detailed report of the results.

Quick Start

To run the tests for your QML project, simply use the following command:

qt-qml-test-run <path-to-project>

Frequently Asked Questions about qt-qml-test-run

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

FAQPage Schema
How do I automate building and running Qt Quick Tests for a QML project?

Automate Qt Quick Tests by executing a single command that builds and runs your test files using qmltestrunner or CTest, then generates a Markdown report with pass/fail counts and slowest test details.

What is the best way to generate test reports for QML test files?

Generate test reports for QML by running your tst_*.qml files through an automated test execution process that parses JUnit XML and outputs a detailed Markdown report with failed test specifics.

Do I need CMake to automate Qt Quick Test execution?

CMake is not strictly required but is supported for test execution via CTest, and the automation can integrate with CMake projects to add missing test infrastructure if needed.

Can I use qmltestrunner to automate Qt Quick Tests without manual configuration?

Yes, qmltestrunner is used to automatically build and run Qt Quick Tests for your QML project without manual configuration, streamlining the test execution process.

What dependencies are required to parse test results and generate Markdown reports for QML?

Parsing JUnit XML and generating Markdown reports for QML test results requires Python, along with qmltestrunner and CMake for building and running the automated tests.