中文 EN

AI Skills Integration

StyleKit AI Skills Integration

The StyleKit Skill is a product knowledge package for AI assistants. It describes QSS theme loading, dynamic properties, icon resources, style directory packaging, and common troubleshooting rules. With this skill, Codex, ChatGPT, or an internal AI assistant can generate Qt Widgets styling code that follows StyleKit conventions.

Downloads

Folder Structure

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

SKILL.md defines when the skill should be used and the core operating rules. The references files provide detailed integration steps, APIs, and QSS conventions.

Suitable AI Tasks

  • Generate QSS loading code for Qt Widgets projects.
  • Design runtime theme switching.
  • Explain StyleKit dynamic properties, object names, and icon usage.
  • Troubleshoot missing styles, missing icons, and invalid theme paths.
  • Generate page styling guidance that stays within StyleKit conventions.

Integration Steps

  1. Download and extract qt-ui-uigears-stylekit-skill.zip.
  2. Place uigears-stylekit in the AI tool's skills directory, or store it in a team knowledge base.
  3. Ask the AI to use StyleKit explicitly, for example: "Use UIGears StyleKit to generate theme loading code."
  4. Let the AI read references/integration.md first, and read references/api-reference.md only when API or QSS details are needed.

Example Prompts

Use the uigears-stylekit skill to load styles/blueLight.qss from the application directory and support switching to light.qss at runtime.
Use the uigears-stylekit skill to check why a button does not refresh after setting variant=primary.

Code Generation Rules

  • Prefer qApp->setStyleSheet(...) for global QSS loading.
  • Use Qt dynamic properties for button, progress, and state variants.
  • Use object names for local page styling.
  • Avoid hard-coding many colors in business UI pages.
  • After changing dynamic properties at runtime, refresh with unpolish / polish / update.