# qt-cpp-review

Reviews Qt6 C++ diffs or codebases before commits. Combines a 60-rule deterministic linter with deep agent analysis for threading, model contracts, and ownership.

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

## What it does

This skill provides a read-only review pipeline tailored for Qt6 C++ codebases. It executes in two structured stages. First, a standalone Python script evaluates code against more than 60 rules covering include hygiene, error propagation, model contracts, and lifecycle patterns. Next, it triggers an agent-driven analysis focusing on thread safety, API correctness, and performance hotspots. Findings only make it into the final report when the confidence score exceeds 80 out of 100.

The review workflow protects token budgets. For scopes under 2,500 lines, the orchestrator handles the analysis inline. When reviewing larger changes, it splits the files into shards of roughly 2,500 lines and passes each slice to an isolated agent. Adding the framework flag activates checks for private d-pointers, export macros, CMake module setups, and binary compatibility.

The deterministic phase relies on Python 3.7+ installed locally without third-party packages. If Python is missing, the tool issues a warning and proceeds with the diff list generated by git.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

## When to use it
- audit Qt6 C++ changes before committing
- detect thread safety and object lifecycle defects
- verify Qt model contracts and data handling
- enforce export macros and d-pointer rules in framework mode

## Example prompts
- /qt-cpp-review
- /qt-cpp-review framework
- Audit my staged Qt6 changes before I commit

## Similar
- [cpp-coding-standards](https://affpapa.org/en/nevibecode/skills/cpp-coding-standards.md) — skill · 5100 installs
- [review-delta](https://affpapa.org/en/nevibecode/skills/review-delta.md) — skill · 1200 installs
- [c-review](https://affpapa.org/en/nevibecode/skills/c-review.md) — skill · 3700 installs
- [cpp-pro](https://affpapa.org/en/nevibecode/skills/httpsgithubcomjeffallan-cpp-pro.md) — skill · 5300 installs
- [unreal-engine-cpp-pro](https://affpapa.org/en/nevibecode/skills/unreal-engine-cpp-pro.md) — skill · 1400 installs
- [skill-review](https://affpapa.org/en/nevibecode/skills/skill-review.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