{
  "markdown": "# Qt5 AI Skills\n\nOfficial agentic skills for **Qt5 software development**, adapted from the\n[Qt Company's agent-skills](https://github.com/TheQtCompanyRnD/agent-skills) project.\nDesigned for use with AI coding tools such as Claude Code, Codex CLI, OpenCode CLI,\nGemini CLI, and GitHub Copilot.\n\nThese skills teach AI coding agents how to work effectively with Qt5 APIs,\npatterns, and build systems (qmake and CMake). They address the specific\ndifferences between Qt5 and Qt6 that mainstream LLMs frequently get wrong.\n\n> These agentic development skills use AI and can make mistakes.\n> Always double-check the output carefully.\n\n## Skills\n\n| Skill | Type | Description |\n|-------|------|-------------|\n| `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. |\n| `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. |\n| `qt-qml` | Conceptual | QML best practices for Qt5 — versioned imports, `PropertyChanges { target: ... }` syntax, `QtGraphicalEffects` patterns, and other Qt5-specific idioms. |\n| `qt-ui-design` | Conceptual | UI design and audit for Qt5/QML, web, and embedded (MPU/MCU) targets. Covers screen layout, navigation, and UX review. |\n| `qt-qml-docs` | Process | Generates Markdown reference docs for QML components from .qml source files. |\n| `qt-cpp-docs` | Process | Generates Markdown reference documentation for Qt5/C++ source files — classes, modules, utilities, headers. |\n| `qt-qml-profiler` | Tool | Runs `qmlprofiler` on Qt5 QML/Quick applications, parses trace, and analyzes hotspots. |\n| `qt-qml-test` | Process | Generates Qt Quick Test cases (`tst_*.qml`) for QML components. |\n| `qt-qml-test-run` | Tool | Builds and runs Qt Quick Test, parses JUnit XML, writes Markdown report. |\n| `qt-figma-token-extraction` | Process | Extracts design tokens from Figma, generates Qt5-compatible QML singletons. |\n| `qt-figma-component-generation` | Process | Generates Qt5 production-ready QML controls from Figma components. |\n| `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. |\n\n### Skill types\n\n- **Review** — structured code review with deterministic linters + parallel deep analysis\n- **Process** — workflows and decision frameworks (docs, scaffolding, test generation)\n- **Conceptual** — mental model corrections for LLMs on Qt5 patterns\n- **Tool** — guidance on Qt5 CLI tools\n\n## Key changes from the original (Qt6 → Qt5)\n\n| Area | Qt6 original | Qt5 adaptation |\n|------|-------------|----------------|\n| **Build system default** | CMake | **qmake** (.pro files) |\n| **Qt version** | 6.x | **5.x** (5.12–5.15 primarily) |\n| **QML imports** | Versionless (no version numbers) | **Version numbers required** |\n| **PropertyChanges** | Without `target` | **With `target`** |\n| **CMake commands** | `qt_add_executable`, `qt_add_qml_module` | Plain CMake + `qt5_*` commands |\n| **`qt_standard_project_setup()`** | Available | **Not available** |\n| **QML effects** | `MultiEffect` (Qt 6.5+) | **QtGraphicalEffects** |\n| **Delegate reuse** | `reuseItems: true` (Qt 6.7+) | Manual pattern |\n| **FluentWinUI3 style** | Qt 6.7+ | **Not available** |\n| **qmllint** | Built-in | Limited availability |\n\n## Installation\n\n### Claude Code\n\n```\n/plugin marketplace add liueggy/qt5-skills\n```\nOr symlink individual skills:\n```bash\nln -s \"$(pwd)/skills/qt-cpp-review\" ~/.claude/skills/qt-cpp-review\n```\n\n### Codex CLI\n\n```bash\nnpx skills add liueggy/qt5-skills\n```\nOr copy manually:\n```bash\ncp -r skills/qt-cpp-review ~/.codex/skills/qt-cpp-review\n```\n\n### OpenCode CLI\n\nOpenCode reads the same SKILL.md format natively. Copy skills:\n```bash\ncp -r skills/qt-cpp-review ~/.opencode/skills/qt-cpp-review\n```\nOr reference them in an `AGENTS.md` file:\n```markdown\n@skills/qt-cpp-review/SKILL.md\n```\n\n### GitHub Copilot CLI\n\n```bash\ngh skill install liueggy/qt5-skills qt-cpp-review\n```\nOr copy to `~/.copilot/skills/` or `.github/skills/`.\n\n### Gemini CLI\n\n```bash\ngemini extensions install https://github.com/liueggy/qt5-skills\n```\n\n### Manual installation\n\n```bash\ngit clone https://github.com/liueggy/qt5-skills.git\ncd qt5-skills\n# Symlink desired skills\nfor skill in skills/*/; do\n  ln -s \"$(pwd)/$skill\" ~/.claude/skills/$(basename $skill)\ndone\n```\n\n## Repository Structure\n\n```\nqt5-skills/\n  skills/                           # All skills\n    qt-cpp-review/\n      SKILL.md                      # Entry point\n      references/                   # Rules, checklists, scripts\n    qt-qml-review/\n    qt-qml/\n    ...\n  mcp/                              # MCP server configs\n    .mcp.json                       # Qt5 docs MCP registration\n  .claude-plugin/                   # Claude Code plugin config\n  gemini-extension.json             # Gemini CLI extension manifest\n  docs/                             # Documentation site source\n  gen_skills.py                     # Skill page generator\n  README.md\n  CONTRIBUTING.md\n  LICENSE\n```\n\n## Qt5 Documentation MCP\n\nA hosted MCP server for Qt5 API documentation is available at:\n\n```\nhttps://qt5-docs-mcp.example.com/mcp  # replace with actual endpoint\n```\n\nOr use the local Qt5 help system via:\n```\nassistant -collectionFile qt5.qhc\n```\n\n## License\n\nBSD-3-Clause — same as the original Qt Company project.\n",
  "bytes": 5586,
  "sha": "b50e728de25eeda2099530ac26387192b88c0b8580dd79bb9335c3a264403263",
  "repo_slug": "liueggy/qt5-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_liueggy_qt5_skills_28401aca/readme"
}