# Qt UI Inspector

> Infrastructure skill — DCC-agnostic Qt UI introspection: list top-level windows, find widgets by name/class, describe widget properties, walk the widget tree, and poll for availability. Works in any DCC with a Qt binding (Maya, Blender, Houdini, Unreal, etc.). All tools are read-only and lazy-loaded. Trigger this helper during CUA, UI Control, or dcc-cua workflows when a Qt selector can replace coordinate discovery.

- Skill: `dcc-mcp/qt-ui-inspector` (Agent Skill, multi-file: 7 files)
- Install (CLI): `npx skillmds@latest add dcc-mcp/qt-ui-inspector`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dcc-mcp/qt-ui-inspector/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- License: MIT
- Author: dcc-mcp (https://skillmd.com/u/dcc-mcp)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/dcc-mcp/qt-ui-inspector

---


# Qt UI Inspector

Cross-DCC Qt UI introspection tools. All tools lazy-import the host's Qt binding
(qtpy, PySide6, PySide2, PyQt6, or PyQt5).

This skill is read-only and complements core 0.20 `ui_control__*` tools backed
by dcc-cua 0.4. It may identify a stable Qt selector before an action, but it
does not capture the native desktop or inject input.

## Tools

### ``dcc_qt_ui_inspector__list_windows``
List every top-level Qt window with object name, class, visibility, geometry,
and child count.

### ``dcc_qt_ui_inspector__find_widgets``
Locate Qt widgets by object name (exact/substring/regex), class name, and
visibility. Bounded result count.

### ``dcc_qt_ui_inspector__describe_widget``
Return a single Qt widget's structured state - class, geometry, flags,
accessible name/description, and bounded property snapshot.

### ``dcc_qt_ui_inspector__snapshot_tree``
Walk the Qt widget tree under a root and return it as a JSON-safe tree with
depth and node-count budgets.

### ``dcc_qt_ui_inspector__wait_for_widget``
Poll for a Qt widget by name/class with visible/enabled gates and bounded
timeout.