中文 EN

AI Skills Integration

WidgetKit AI Skills Integration

The WidgetKit Skill is a product knowledge package for AI assistants. It covers the UIGQ control system, theme JSON, container layouts, button/icon states, SVG color behavior, scroll bars, serialization, and common troubleshooting rules. It helps AI generate or modify WidgetKit pages, theme configuration, and control code.

Downloads

Folder Structure

uigears-widgetkit/
  SKILL.md
  agents/openai.yaml
  references/
    integration.md
    api-reference.md

Suitable AI Tasks

  • Generate WidgetKit initialization code and resource loading flow.
  • Assemble pages with UIGQContainer, UIGQPushButton, UIGQLineEdit, and related controls.
  • Write or review theme.json and style.json.
  • Move reusable visual styles from C++ into theme configuration.
  • Troubleshoot SVG icons, button hover states, fade animation, scroll bar direction, layout ratios, and absolute docking.
  • Generate JSON property documentation and serialization guidance for controls.

Integration Steps

  1. Download and extract qt-ui-uigears-widgetkit-skill.zip.
  2. Place uigears-widgetkit in the AI tool's skills directory.
  3. Ask the AI to use WidgetKit explicitly, for example: "Use UIGears WidgetKit controls for this settings page."
  4. For new integrations, have the AI read references/integration.md first.
  5. For control APIs, theme JSON, or layout problems, have the AI read references/api-reference.md.

Example Prompts

Use the uigears-widgetkit skill to build a top toolbar with UIGQContainer and UIGQPushButton, with appearance configured in theme.json/style.json.
Use the uigears-widgetkit skill to check why an SVG icon renders black after being assigned to a button.

Code Generation Rules

  • Keep startup order as UIGQtLib::init(), set skin directory, load theme directory, then create windows.
  • Prefer UIGQ* controls on WidgetKit pages instead of mixing in plain QWidget + QLayout.
  • Put reusable appearance in theme.json and style.json.
  • Keep drawing behavior such as setDrawBackground(false) in C++ when appropriate.
  • Theme switching should not unexpectedly change layout size unless geometry fields are intentionally configured.