qt-qml-profiler — Claude Code skill: QML analysis and setup
This skill profiles 2D QML apps and inspects .qtd traces to locate performance bottlenecks. Use it when a Qt Quick interface stutters or you need to investigate rendering, bindings, or signals.
npx skills add TheQtCompanyRnD/agent-skills --skill qt-qml-profiler -a claude-codeWhat qt-qml-profiler does
The skill runs qmlprofiler against an application, parses the resulting .qtd trace, and checks hotspots against the source. Its summaries cover frame time, memory use, and the pixmap cache. It can also inspect an existing trace without launching the app again.
For a new capture, the skill locates qmlprofiler and can build the project with QML debugging enabled through CMake. Profiling can cover all available events or focus on rendering, logic, or memory. Qt and a working qmlprofiler executable are prerequisites; a failed CMake build must be resolved before profiling can continue.
The analysis targets 2D Qt Quick applications. Qt Quick 3D events are not analyzed, so 3D rendering bottlenecks will not appear in its results.
What it helps with
- locate QML code that slows an interface
- inspect frame timing and dropped frames
- review memory use and the pixmap cache
- relate profiler events to source code
Example prompts for the agent
- Profile my QML app and identify the main performance bottlenecks.
- Run a rendering-focused profile for
./build/my-app. - Analyze
profiler/traces/app.qtdand report memory-related issues.
How to install qt-qml-profiler
1Skills CLI (Vercel)
npx skills add TheQtCompanyRnD/agent-skills --skill qt-qml-profiler -a claude-code2Manually: put the files in place
~/.claude/skills/qt-qml-profiler/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/qt-qml-profiler/
1Skills CLI (Vercel)
npx skills add TheQtCompanyRnD/agent-skills --skill qt-qml-profiler -a codex2Manually: put the files in place
.agents/skills/qt-qml-profiler/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add TheQtCompanyRnD/agent-skills --skill qt-qml-profiler -a cursor2Manually: put the files in place
.cursor/skills/qt-qml-profiler/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install TheQtCompanyRnD/agent-skills qt-qml-profiler2Manually: put the files in place
.github/skills/qt-qml-profiler/SKILL.md1Skills CLI (Vercel)
npx skills add TheQtCompanyRnD/agent-skills --skill qt-qml-profiler -a gemini-cli2Platform CLI
gemini skills install https://github.com/TheQtCompanyRnD/agent-skills --path skills/qt-qml-profilerManually: put the files in place
.devin/skills/qt-qml-profiler/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add TheQtCompanyRnD/agent-skills --skill qt-qml-profiler -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about qt-qml-profiler
How do I install qt-qml-profiler in Claude Code?
Run npx skills add TheQtCompanyRnD/agent-skills --skill qt-qml-profiler -a claude-code. The skill file is placed at ~/.claude/skills/qt-qml-profiler/SKILL.md.
What does qt-qml-profiler do?
It profiles a 2D QML application with qmlprofiler or analyzes an existing .qtd trace. The report examines hotspots and summarizes frame time, memory, and pixmap-cache activity.
Can qt-qml-profiler analyze Qt Quick 3D?
No. Qt Quick 3D events are outside its analysis, so 3D rendering bottlenecks will not show up in the results.
