Official agentic skills for Qt software development and quality assurance, designed for use with AI coding tools such as Claude Code, Codex CLI, and GitHub Copilot. Skills have been tested with frontier LLMs from the Claude, Gemini, and GPT model families.
Claude Code
> /plugin marketplace add TheQtCompanyRnD/agent-skills> /plugin install qt-development-skills@qt-skills-and-tools
Codex
$ npx skills add TheQtCompanyRnD/agent-skills -a codex
Cursor
$ npx skills add TheQtCompanyRnD/agent-skills -a cursor
Gemini CLI
$ npx skills add TheQtCompanyRnD/agent-skills -a gemini-cli
GitHub Copilot
$ copilot plugin marketplace add TheQtCompanyRnD/agent-skills$ copilot plugin install qt-development-skills@qt-skills-and-tools
OpenCode
$ npx skills add TheQtCompanyRnD/agent-skills -a opencode
Windsurf
$ npx skills add TheQtCompanyRnD/agent-skills -a windsurf
Official agentic skills for Qt software development and quality assurance, designed for use with AI coding tools such as Claude Code, Codex CLI, and GitHub Copilot.
Skills have been tested with frontier LLMs from the Claude, Gemini, and GPT model families.
There is no settled industry standard for AI skill packaging.
Each platform has its own conventions. Our canonical format
uses SKILL.md with YAML frontmatter in a directory-based
structure — this works natively on Claude Code, Codex CLI,
and GitHub Copilot, and can be adapted to other platforms
through condensed variants. See CONTRIBUTING.md
for the full cross-platform story.
These agentic development skills use AI and can make mistakes. Always double-check the output carefully.
Before using the skills under Qt commercial licensing, make sure you have understood and agree to the Qt AI Services Terms & Conditions. By using the skills or MCP tools, you accept these terms & conditions and that you have the right to do so on behalf of your employer.
| Skill | Type | Description |
|---|---|---|
qt-cpp-review | Review | Deterministic linting + deep analysis for Qt C++ code (inline for small scopes, parallel shard agents above about 2,500 lines). Covers model rule compliance, memory ownership, thread safety, correctness, error handling, and performance. |
qt-qml-review | Review | Deterministic QML linting (48+ rules) + deep analysis (inline for small scopes, parallel shard agents above about 1,500 lines) for bindings, layout, loaders, delegates, states, and performance. |
qt-qml | Conceptual | QML best practices for writing, reviewing, fixing, and refactoring. Corrects systematic LLM pre-training biases around bindings, scoping, modules, JS interop, and types. |
qt-canvas2d | Conceptual | Qt Canvas2D (Qt 6.12+, Qt Canvas Painter) best practices for GPU-accelerated imperative 2D drawing in QML — gauges, charts, waveforms, freehand drawing. Corrects LLM confusion with the legacy Qt Quick Canvas and HTML5 <canvas> APIs |
qt-ui-design | Conceptual | UI design and audit for Qt/QML, web, and embedded (MPU/MCU) targets. Covers screen layout, navigation, and UX review with platform-aware defaults for geometry, viewing distance, input, and locale. |
qt-qml-docs | Process | Generates Markdown reference documentation for QML components and applications from .qml source files. |
qt-cpp-docs | Process | Generates Markdown reference documentation for Qt/C++ source files — classes, modules, utilities, headers, and entry points. |
qt-qml-profiler | Tool | Runs qmlprofiler on a 2D QML / Qt Quick application, parses the .qtd trace, and analyzes hotspots against the source code with frame-time, memory, and pixmap-cache summaries. Does not cover Qt Quick 3D. |
qt-qml-test | Process | Generates Qt Quick Test cases (tst_*.qml) for QML components using TestCase, SignalSpy, and tryCompare. Handles single files and batches. Does not cover CMake or runner setup. |
qt-qml-test-run | Tool | Builds and runs Qt Quick Test (qmltestrunner) tests for a CMake project, parses the JUnit XML, and writes a Markdown report. Opt-in CMake test-infrastructure wiring with --wire-up. Companion to qt-qml-test. |
qt-figma-token-extraction | Process | Extracts design tokens, text styles, and variables from a Figma design system and produces a design-tokens.json plus ready-to-use QML singletons. |
qt-figma-component-generation | Process | Extracts component metadata from a Figma design system and generates production-ready QML controls mapped to Qt Quick Controls 2 patterns. Requires tokens from qt-figma-token-extraction. |
qt-cmake-project | Conceptual | Sets up and manages Qt 6 projects built with CMake — fresh projects, executables, libraries, QML modules, plugins, folder layout, and static resources. Corrects systematic LLM biases around qmake-isms and the legacy qt5_* macros. |
| Tool | Description |
|---|---|
qt-documentation-mcp | Hosted MCP server for Qt API documentation lookup across the latest release and active LTS branches. Bundled with the qt-development-skills plugin; also available standalone via the official MCP registry as io.qt/qt-documentation-mcp. |
qml-live-preview-mcp | A local MCP server that launches a Qt Quick application and live-previews QML edits in it, without a rebuild. |
See mcp/qt-documentation-mcp/README.md
for endpoint and manual setup instructions for AI clients other than
Claude Code.
Read the Introducing the QML Live Preview MCP Tool for Agentic Development of Embedded Devices blog post to gain more information about the QML-Live-Preview-MCP-Server.
See mcp/qml-live-preview-mcp/README.md for endpoint and manual setup instructions.
skills/ # All skills live here
qt-cpp-review/ # Each skill is a directory
SKILL.md # with a SKILL.md entry point
references/ # and optional reference docs
lint-scripts/
qt-review-checklist.md
platforms/ # Platform-specific variants
qt-qml-review/
qt-qml/
qt-canvas2d/
qt-ui-design/
qt-qml-docs/
qt-cpp-docs/
qt-qml-profiler/
qt-qml-test/
qt-qml-test-run/
qt-cmake-project/
mcp/ # MCP servers bundled with the plugin
qt-documentation-mcp/ # Each server is a directory
README.md # with its own README
.mcp.json # MCP registration for Claude Code
.claude-plugin/ # Claude Code CLI & Copilot CLI plugin config
gemini-extension.json # Gemini CLI extension manifest
docs/ # Source for the docs site (MkDocs)
CONTRIBUTING.md
LICENSE
README.md
Every skill is a directory containing a SKILL.md file with
YAML frontmatter. This format aligns with what Claude Code and
Codex CLI support natively:
---
name: qt-qml-review
description: >-
Reviews QML source files for correctness, performance, and
maintainability. Deterministic linting (48+ rules) plus
deep analysis (parallel shard agents for large scopes) for
bindings, layout, loaders, delegates, states, and performance.
license: LicenseRef-Qt-Commercial OR BSD-3-Clause
compatibility: >-
Designed for Claude Code, GitHub Copilot, and similar agents.
metadata:
author: qt-ai-skills
version: "1.0"
qt-version: "6.x"
---
name must be lowercase alphanumeric + hyphens, max
64 chars, and must match the directory namedescription must describe what the skill does AND when
to use it — front-load the key information in the first 250
characters, as some platforms truncate beyond that pointreferences/ filesname/description at startup, read SKILL.md body on
activation, and pull references/ files only when neededSkills are authored to be tool-agnostic wherever possible. However, different AI coding tools consume skills in different ways:
| Tool | Skill Location | Format | Notes |
|---|---|---|---|
| Claude Code CLI | ~/.claude/skills/ | SKILL.md + references (native) | Full directory model with progressive loading |
| Codex CLI | ~/.codex/skills/ | SKILL.md + references (native) | Full directory model; registered in ~/.codex/config.toml |
| GitHub Copilot | .github/skills/ or .claude/skills/ (project), ~/.copilot/skills/ (personal) | SKILL.md + references (native) | Auto-discovered across Copilot CLI, coding agent, and VS Code; existing .claude/skills/ setups Just Work |
Most skills work across tools without changes. When a skill
needs to reach platforms that cannot read multi-file directories
(e.g. Windsurf, Amazon Q), create variants in a platforms/
directory:
skills/qt-qml-review/
├── SKILL.md # Core skill (tool-agnostic)
├── references/
│ ├── qml-lint-rules.md
│ └── qml-review-checklist.md
└── platforms/ # Platform-specific variants
└── windsurf.md # Self-contained compact variant
The platforms/ directory is a convention for this repository.
See CONTRIBUTING.md for full details on
creating platform variants.
Condensed variants and tools that can't run scripts or subagents give less thorough results. For example, GitHub Copilot loads only the static guidance of the review skills, without the linter or the deep-analysis agents. See Requirements and platform support for per-skill requirements and limits.
Most AI coding tools can install skills directly from this GitHub repository. Choose the method for your platform below.
Install as a plugin using the Claude Code CLI plugin system:
/plugin marketplace add TheQtCompanyRnD/agent-skills
/plugin install qt-development-skills
Or install individual skills manually:
# Symlink a skill into your personal skills directory
ln -s "$(pwd)/skills/qt-qml-review" ~/.claude/skills/qt-qml-review
# Or copy into a project for team use
cp -r skills/qt-qml-review .claude/skills/qt-qml-review
# Review skills only: also install their review agents. The plugin
# install does this for you; a skill-only copy does not include agents/.
mkdir -p ~/.claude/agents
cp agents/cpp-review-agent.md agents/qml-review-agent.md ~/.claude/agents/
Without the agents, qt-cpp-review and qt-qml-review still work:
they fall back to the general-purpose agent.
Claude Code auto-discovers skills — no restart needed.
Use Vercel's cross-platform skill installer:
npx skills add TheQtCompanyRnD/agent-skills
Or copy skills manually:
cp -r skills/qt-qml-review ~/.codex/skills/qt-qml-review
Restart Codex after adding skills.
Note: Codex is evolving rapidly. If
~/.codex/skills/does not work, try~/.agents/skills/or.agents/skills/in your project root.
Copilot natively reads the same SKILL.md directory format as
Claude Code. Install individual skills using GitHub CLI (preview):
gh skill install TheQtCompanyRnD/agent-skills qt-qml-review
Or copy/symlink the skill into one of Copilot's discovery paths:
# User-wide (available in any project)
cp -r skills/qt-qml-review ~/.copilot/skills/qt-qml-review
# Or scoped to a specific project
cp -r skills/qt-qml-review .github/skills/qt-qml-review
Copilot also auto-discovers skills installed for Claude Code
under .claude/skills/, so a single install can serve both
tools. Use /skills list inside Copilot CLI to confirm what
loaded.
qt-qml-test also ships a self-contained Copilot variant in
skills/qt-qml-test/platforms/copilot.prompt.md.
Stars on GitHub
A development methodology for coding agents that makes the agent brainstorm before building, follow plans, run parallel work and finish branches in a disciplined way. You get fewer skipped steps and more consistent results from your coding assistant.
@obraHelps you take a change from a rough idea or bug report through to a tested, reviewed result, with each step handled by a focused skill. Its skills cover pinning down domain terms, designing module interfaces, diagnosing hard bugs, and reviewing changes against your repo's coding standards.
@mattpocockGives your coding agent a planning, testing and review routine to follow on every task. It plans before building, checks changes with tests, has a fresh reviewer look for regressions, and saves repeated wins as reusable skills.
@affaan-mDeveloper tools for working on the React codebase itself. Provides skills for extracting error messages, managing and debugging feature flags across release channels, running Flow type checks, and fixing lint and formatting issues before committing.
@facebookOfficial agentic skills for Qt software development and quality assurance, designed for use with AI coding tools such as Claude Code, Codex CLI, and GitHub Copilot. Skills have been tested with frontier LLMs from the Claude, Gemini, and GPT model families. Install it with the command on its page. It includes qt-canvas2d, qt-cmake-project, qt-cpp-docs. Its skills do not fire on their own yet. Free and open source.
Is this plugin yours?
Claim it with GitHubSubmit a pluginPromote it