qt-qml-docs — скилл для Claude Code: документация QML-компонентов

Что делает qt-qml-docs

Скилл собирает справочную документацию по QML-компонентам и приложениям на Qt Quick. Агент разбирает исходники — сами .qml-файлы, а рядом C++-бэкенды, модули, qmldir, CMakeLists.txt — и пишет по каждому компоненту отдельный <ComponentName>.md. Структура жёсткая: обзор компонента, его место в проекте и зависимости, иерархия типов, таблица свойств с колонками Property, Type, Default, Required, Description, сигналы и методы отдельными подразделами, связи с другими частями приложения.

Свойства всегда идут таблицей, а не списком. Код в блоках не приводится нигде, кроме раздела Usage Example — и только для переиспользуемых компонентов, у которых корневой тип не Window и не ApplicationWindow. Для каждого сигнала указано, что его вызывает и что должен делать обработчик; для методов — параметры, возвращаемый тип и побочные эффекты вроде перезапуска таймера.

Перед чтением исходников скилл проверяет, нет ли уже готовых файлов в doc/ рядом с кодом. Если документация нашлась, агент не начинает заново, а спрашивает: обновить существующие файлы, пропустить их, перегенерировать всё или отменить. Это заметно, когда правишь один компонент в большом проекте — не приходится потом вычищать перезаписанные файлы соседей. Формат QDoc скилл не выдаёт, для него нужен другой инструмент.