# qt-qml

Enforces QML coding standards during component authoring, refactoring, and code review. Designed for developers building Qt 6 user interfaces.

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

## What it does

The skill instructs the agent to write compact QML without boilerplate comments or unnecessary nesting. During code reviews, the model evaluates files silently against the checklist and reports only broken rules alongside the relevant line numbers. When issues accumulate, it highlights the five most impactful violations.

Project structure rules keep `main.qml` strictly as an entry bootstrap file. Separate files are required once a component exceeds three nesting levels or roughly 150–200 lines. For Qt 6, the skill removes version numbers from `import` statements and omits redundant `QtQuick.Window` imports. Controls rely on dedicated style imports such as `QtQuick.Controls.Basic` instead of generic imports when styling properties change.

The skill also checks for the `run_qmlPreview` MCP tool to enable live reloading. Live preview requires Qt 6.12 or newer. On older versions, preview sessions fail silently. You need to verify `PACKAGE_VERSION` in `CMakeCache.txt` before relying on it.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

## When to use it
- Audit legacy QML files against modern Qt 6 practices
- Extract nested UI elements from `main.qml` into separate components
- Configure asynchronous loading for heavy dialogs using `Loader`
- Strip redundant import version numbers across a Qt 6 project

## Example prompts
- Review this QML file and report any style violations with line numbers
- Extract the navigation drawer from main.qml into a dedicated component
- Refactor this dialog to load asynchronously with Loader

## Similar
- [emil-design-eng](https://affpapa.org/en/nevibecode/skills/emil-design-eng.md) — skill · 388200 installs
- [better-interface](https://affpapa.org/en/nevibecode/skills/better-interface.md) — skill · 30000 installs
- [interface-review](https://affpapa.org/en/nevibecode/skills/interface-review.md) — skill · 18500 installs
- [om-ux-review-pr](https://affpapa.org/en/nevibecode/skills/om-ux-review-pr.md) — skill · 2600 installs
- [shadcn-component-review](https://affpapa.org/en/nevibecode/skills/shadcn-component-review.md) — skill · 635 installs
- [design-qa-checklist](https://affpapa.org/en/nevibecode/skills/design-qa-checklist.md) — skill · 2200 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