# qt-qml-profiler

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 691 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-profiler/SKILL.md
- Updated: 2026-10-20
- HTML: https://affpapa.org/en/nevibecode/skills/qt-qml-profiler

## What it 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.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add TheQtCompanyRnD/agent-skills --skill qt-qml-profiler -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-profiler/SKILL.md

## When to use it
- 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
- Profile my QML app and identify the main performance bottlenecks.
- Run a rendering-focused profile for `./build/my-app`.
- Analyze `profiler/traces/app.qtd` and report memory-related issues.

## Similar
- [frontend-design](https://affpapa.org/en/nevibecode/skills/frontend-design.md) — skill · 1025790 installs
- [design-taste-frontend](https://affpapa.org/en/nevibecode/skills/design-taste-frontend.md) — skill · 678700 installs
- [prototype](https://affpapa.org/en/nevibecode/skills/prototype.md) — skill · 986201 installs
- [hyperframes](https://affpapa.org/en/nevibecode/skills/heygen-com-hyperframes.md) — skill · 1200000 installs
- [hyperframes-cli](https://affpapa.org/en/nevibecode/skills/heygen-com-hyperframes-cli.md) — skill · 1300000 installs
- [webapp-testing](https://affpapa.org/en/nevibecode/skills/webapp-testing.md) — skill · 186758 installs

From the same set: [theqtcompanyrnd/agent-skills](https://affpapa.org/en/nevibecode/by/theqtcompanyrnd/agent-skills.md) — 12 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