qt5-ai-skills
Official Qt5 agentic engineering skills for Qt software development and quality assurance
Open source Open in the app JSON README (API)
About
Official Qt5 agentic engineering skills for Qt software development and quality assurance
Details
- Kind
- Plugins
- Topic
- No topic detected
- Publisher
- liueggy
- Origin
- gemini
- Category
- ferramentas
- Version
- 1.0.0
- Last push
- 2026-07-08T01:54:08Z
- Repository state
- ativo
- Language
- Python
- License
- BSD-3-Clause
- Added
- 2026-08-30 14:13:39
- Updated
- 2026-08-30 14:13:39
- Origin id
liueggy/qt5-skills
README
# Qt5 AI Skills
Official agentic skills for **Qt5 software development**, adapted from the
[Qt Company's agent-skills](https://github.com/TheQtCompanyRnD/agent-skills) project.
Designed for use with AI coding tools such as Claude Code, Codex CLI, OpenCode CLI,
Gemini CLI, and GitHub Copilot.
These skills teach AI coding agents how to work effectively with Qt5 APIs,
patterns, and build systems (qmake and CMake). They address the specific
differences between Qt5 and Qt6 that mainstream LLMs frequently get wrong.
> These agentic development skills use AI and can make mistakes.
> Always double-check the output carefully.
## Skills
| Skill | Type | Description |
|-------|------|-------------|
| `qt-cpp-review` | Review | Deterministic linting + 6 parallel deep-analysis agents for Qt5 C++ code. Covers model rule compliance, memory ownership, thread safety, correctness, error handling, and performance. |
| `qt-qml-review` | Review | Deterministic QML linting (47+ rules) + parallel deep-analysis agents for bindings, layout, loaders, delegates, states, and performance. Qt5 QML-specific version awareness. |
| `qt-qml` | Conceptual | QML best practices for Qt5 — versioned imports, `PropertyChanges { target: ... }` syntax, `QtGraphicalEffects` patterns, and other Qt5-specific idioms. |
| `qt-ui-design` | Conceptual | UI design and audit for Qt5/QML, web, and embedded (MPU/MCU) targets. Covers screen layout, navigation, and UX review. |
| `qt-qml-docs` | Process | Generates Markdown reference docs for QML components from .qml source files. |
| `qt-cpp-docs` | Process | Generates Markdown reference documentation for Qt5/C++ source files — classes, modules, utilities, headers. |
| `qt-qml-profiler` | Tool | Runs `qmlprofiler` on Qt5 QML/Quick applications, parses trace, and analyzes hotspots. |
| `qt-qml-test` | Process | Generates Qt Quick Test cases (`tst_*.qml`) for QML components. |
| `qt-qml-test-run` | Tool | Builds and runs Qt Quick Test, parses JUnit XML, writes Markdown report. |
| `qt-figma-token-extraction` | Process | Extracts design tokens from Figma, generates Qt5-compatible QML singletons. |
| `qt-figma-component-generation` | Process | Generates Qt5 production-ready QML controls from Figma components. |
| `qt-project` | Conceptual | Sets up Qt5 projects with **qmake (.pro) or CMake**. Defaults to qmake. Corrects systematic LLM biases around Qt6→Qt5 build system differences. |
### Skill types
- **Review** — structured code review with deterministic linters + parallel deep analysis
- **Process** — workflows and decision frameworks (docs, scaffolding, test generation)
- **Conceptual** — mental model corrections for LLMs on Qt5 patterns
- **Tool** — guidance on Qt5 CLI tools
## Key changes from the original (Qt6 → Qt5)
| Area | Qt6 original | Qt5 adaptation |
|------|-------------|----------------|
| **Build system default** | CMake | **qmake** (.pro files) |
| **Qt version** | 6.x | **5.x** (5.12–5.15 primarily) |
| **QML imports** | Versionless (no version numbers) | **Version numbers required** |
| **PropertyChanges** | Without `target` | **With `target`** |
| **CMake commands** | `qt_add_executable`, `qt_add_qml_module` | Plain CMake + `qt5_*` commands |
| **`qt_standard_project_setup()`** | Available | **Not available** |
| **QML effects** | `MultiEffect` (Qt 6.5+) | **QtGraphicalEffects** |
| **Delegate reuse** | `reuseItems: true` (Qt 6.7+) | Manual pattern |
| **FluentWinUI3 style** | Qt 6.7+ | **Not available** |
| **qmllint** | Built-in | Limited availability |
## Installation
### Claude Code
```
/plugin marketplace add liueggy/qt5-skills
```
Or symlink individual skills:
```bash
ln -s "$(pwd)/skills/qt-cpp-review" ~/.claude/skills/qt-cpp-review
```
### Codex CLI
```bash
npx skills add liueggy/qt5-skills
```
Or copy manually:
```bash
cp -r skills/qt-cpp-review ~/.codex/skills/qt-cpp-review
```
### OpenCode CLI
OpenCode reads the same SKILL.md format natively. Copy skills:
```bash
cp -r skills/qt-cpp-review ~/.opencode/skills/qt-cpp-review
```
Or reference them in an `AGENTS.md` file:
```markdown
@skills/qt-cpp-review/SKILL.md
```
### GitHub Copilot CLI
```bash
gh skill install liueggy/qt5-skills qt-cpp-review
```
Or copy to `~/.copilot/skills/` or `.github/skills/`.
### Gemini CLI
```bash
gemini extensions install https://github.com/liueggy/qt5-skills
```
### Manual installation
```bash
git clone https://github.com/liueggy/qt5-skills.git
cd qt5-skills
# Symlink desired skills
for skill in skills/*/; do
ln -s "$(pwd)/$skill" ~/.claude/skills/$(basename $skill)
done
```
## Repository Structure
```
qt5-skills/
skills/ # All skills
qt-cpp-review/
SKILL.md # Entry point
references/ # Rules, checklists, scripts
qt-qml-review/
qt-qml/
...
mcp/ # MCP server configs
.mcp.json # Qt5 docs MCP registration
.claude-plugin/ # Claude Code plugin config
gemini-extension.json # Gemini CLI extension manifest
docs/ # Documentation site source
gen_skills.py # Skill page generator
README.md
CONTRIBUTING.md
LICENSE
```
## Qt5 Documentation MCP
A hosted MCP server for Qt5 API documentation is available at:
```
https://qt5-docs-mcp.example.com/mcp # replace with actual endpoint
```
Or use the local Qt5 help system via:
```
assistant -collectionFile qt5.qhc
```
## License
BSD-3-Clause — same as the original Qt Company project.