# qt-qml-test-run

Builds a Qt 6 CMake project, executes Qt Quick Test via qmltestrunner or CTest, and generates a Markdown report. Useful for verifying QML interfaces in terminal-enabled workflows.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 569 installs · ★ 507
- Author: qt-ai-skills
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/TheQtCompanyRnD/agent-skills/tree/HEAD/skills/qt-qml-test-run/SKILL.md
- Updated: 2026-10-20
- HTML: https://affpapa.org/en/nevibecode/skills/qt-qml-test-run

## What it does

The skill detects Qt 6 paths across Linux, macOS, or Windows, locates `tst_*.qml` files, and runs the test suite. If tests rely only on relative imports, it invokes `qmltestrunner` directly without touching build configurations. For static QML modules, direct runner execution fails to load imports; passing `--wire-up` creates `tests/CMakeLists.txt` and `tests/main.cpp` alongside root CMake targets.

Once execution finishes, an internal Python script parses the JUnit XML output to generate a structured Markdown report. Optional flags let you bypass steps: `--no-build` uses the existing test binary, while `--no-report` suppresses report files during fast test-fix cycles.

Support is limited to CMake projects in environments with shell access. The runner will fail on qmake or cross-compiled device builds.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add TheQtCompanyRnD/agent-skills --skill qt-qml-test-run -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/qt-qml-test-run/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/qt-qml-test-run/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add TheQtCompanyRnD/agent-skills --skill qt-qml-test-run -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/qt-qml-test-run/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add TheQtCompanyRnD/agent-skills --skill qt-qml-test-run -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/qt-qml-test-run/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install TheQtCompanyRnD/agent-skills qt-qml-test-run
```

2. **Manually: put the files in place**
- File: `.github/skills/qt-qml-test-run/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add TheQtCompanyRnD/agent-skills --skill qt-qml-test-run -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/TheQtCompanyRnD/agent-skills --path skills/qt-qml-test-run
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/qt-qml-test-run/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add TheQtCompanyRnD/agent-skills --skill qt-qml-test-run -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/TheQtCompanyRnD/agent-skills/tree/HEAD/skills/qt-qml-test-run/SKILL.md

## When to use it
- run QML tests using qmltestrunner without manual CMake wiring
- scaffold a QUICK_TEST_MAIN test target via the --wire-up flag
- convert Qt Quick test JUnit XML results into a Markdown report
- verify test fixes quickly without project rebuilding via --no-build

## Example prompts
- Run the QML tests in this project and generate a Markdown report
- Execute qmltestrunner on tests/ with --wire-up
- Run QML tests without rebuilding using --no-build

## Similar
- [cpp-testing](https://affpapa.org/en/nevibecode/skills/cpp-testing.md) — skill · 4700 installs
- [platform-apex-test-run](https://affpapa.org/en/nevibecode/skills/platform-apex-test-run.md) — skill · 6900 installs
- [dx-devops-test-suite-run](https://affpapa.org/en/nevibecode/skills/dx-devops-test-suite-run.md) — skill · 5000 installs
- [meticulous-test](https://affpapa.org/en/nevibecode/skills/meticulous-test.md) — skill · 8500 installs
- [run-acceptance-tests](https://affpapa.org/en/nevibecode/skills/run-acceptance-tests.md) — skill · 3700 installs
- [accessibility-test-plan](https://affpapa.org/en/nevibecode/skills/accessibility-test-plan.md) — skill · 2100 installs

From the same set: [theqtcompanyrnd/agent-skills](https://affpapa.org/en/nevibecode/by/theqtcompanyrnd/agent-skills.md) — 8 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md