# qt-qml-review

Reviews Qt6 QML in two passes: a deterministic linter, then agents over seven rule domains. One report, only high-confidence findings.

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

## What it does

Ask for a review, audit or check of QML code and this skill takes over. A dependency-free Python linter runs first with more than 48 checks split across rule families IMP, ORD, BND, LAY, LDR, DEL, STA, IMG, PRF, STY, SIG, ERR, JS. When `qmllint` is present it runs too and its warnings merge into the report as `QL:<id>` rows. No Python on the machine? The skill warns and carries on.

Deep analysis follows, covering seven areas: bindings and properties, layout and anchoring, component loading, ListView delegates, states and transitions, performance, logic and wiring. Scope size decides how it runs. Up to 1500 lines the analysis happens inline in the main context; past that the files are cut into shards of about 1500 lines, at most six agents in parallel. A `--diff` mode limits findings to changed lines, which makes reviewing one commit cheaper than auditing a whole directory.

The skill is read-only and suggests fixes rather than applying them. Anything below the confidence cutoff is dropped, so nitpicks stay out of the report. Diff mode needs a git repository to work from. Type-level checks depend on a Qt 6 install: the linter looks for `qmllint` in `$QT_HOST_PATH/bin`, on `PATH` and in the newest online-installer kit. If your Qt sits somewhere non-standard, pass `--qmllint=<kit>/bin` once instead of hunting further.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

## When to use it
- lint a QML directory and get a summary grouped by rule
- review only the changed lines before committing
- spot slow delegates and component loading
- run `qmllint` type checks alongside the other findings
- split a large codebase without flooding the context

## Example prompts
- Review the changes in `qml/` before I commit, diff only
- Audit `src/ui` and focus on delegates and bindings
- Look over this commit and tell me what to fix before pushing

## Similar
- [improve-codebase-architecture](https://affpapa.org/en/nevibecode/skills/improve-codebase-architecture.md) — skill · 1163035 installs
- [tdd](https://affpapa.org/en/nevibecode/skills/tdd.md) — skill · 1141062 installs
- [triage](https://affpapa.org/en/nevibecode/skills/triage.md) — skill · 990453 installs
- [codebase-design](https://affpapa.org/en/nevibecode/skills/codebase-design.md) — skill · 850344 installs
- [code-review](https://affpapa.org/en/nevibecode/skills/code-review.md) — skill · 789521 installs
- [implement](https://affpapa.org/en/nevibecode/skills/implement.md) — skill · 774700 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