Agent skill

Gui Development

by SurveyController in SurveyController/SurveyController

面向 SurveyController 桌面端的 GUI 开发与界面修复技能。用于修改 software/ui/ 下的 PySide6 + QFluentWidgets 页面、弹窗、导航、配置编辑、运行状态展示和日志界面,处理信号槽、线程协作、对象生命周期、布局、主题和窗口缩放问题。适合做桌面界面开发、交互修复和配置同步,不适合把耗时逻辑直接塞进主线程。

GPL-3.0Auto-check passedTesting & QA

Install Gui Development

skills CLI
$ npx skills add SurveyController/SurveyController --skill gui-development -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install SurveyController/SurveyController gui-development --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/SurveyController/SurveyController.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.codex/skills/gui-development .claude/skills/gui-development && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
gui-development
GitHub stars
142
Token cost
~580 tokens
SKILL.md length
115 words
Files
1
Skills in repo
9
Repo updated
First seen
Licence
GPL-3.0

At a glance

面向 SurveyController 桌面端的 GUI 开发与界面修复技能。用于修改 software/ui/ 下的 PySide6 + QFluentWidgets 页面、弹窗、导航、配置编辑、运行状态展示和日志界面,处理信号槽、线程协作、对象生命周期、布局、主题和窗口缩放问题。适合做桌面界面开发、交互修复和配置同步,不适合把耗时逻辑直接塞进主线程。

  • Works in 8 steps: 先读入口和页面装配点。 → 优先复用现有 PySide6 / QFluentWidgets 组件。 → 耗时任务别堵主线程。 → …
  • Testing & QA work in your project
  • SKILL.md covers name, description, when_to_use and instructions, plus 3 more sections
  • Calls uv and rg

What it does

Gui Development is an agent skill from SurveyController/SurveyController. 面向 SurveyController 桌面端的 GUI 开发与界面修复技能。用于修改 software/ui/ 下的 PySide6 + QFluentWidgets 页面、弹窗、导航、配置编辑、运行状态展示和日志界面,处理信号槽、线程协作、对象生命周期、布局、主题和窗口缩放问题。适合做桌面界面开发、交互修复和配置同步,不适合把耗时逻辑直接塞进主线程。

Its SKILL.md is about 580 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Testing & QA. The repository describes itself as: 适用于问卷星、腾讯问卷、Credamo见数平台的纯HTTP高并发提交程序. The licence is GPL-3.0.

When your agent uses it

  • Testing & QA work in your project

Example prompts

  • “/gui-development”

Requirements

  • Python 3

Workflow steps

8 steps, taken from the first numbered list in SKILL.md.

  1. 先读入口和页面装配点。
  2. 优先复用现有 PySide6 / QFluentWidgets 组件。
  3. 耗时任务别堵主线程。
  4. UI 改动时至少检查这些东西
  5. 涉及配置编辑时,先找真实读写路径。
  6. 涉及运行状态时,优先检查
  7. 不要吞异常。
  8. 修改后做基本 smoke test。

What it can do on your machine

Read from SKILL.md and the folder at commit 1a22ba3. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • uv
    • rg

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use uv, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Gui Development loads about 580 tokens when it runs. Until then it costs about 49 tokens; SKILL.md has 115 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~49
When it runs · the whole SKILL.md, loaded when a task matches
~580

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from SurveyController/SurveyController at commit 1a22ba3, republished under its GPL-3.0 licence (© SurveyController). 115 words, ~580 tokens.

Download SKILL.mdSave it as .claude/skills/gui-development/SKILL.md (or your agent's skills folder).
name
gui-development
description
面向 SurveyController 桌面端的 GUI 开发与界面修复技能。用于修改 software/ui/ 下的 PySide6 + QFluentWidgets 页面、弹窗、导航、配置编辑、运行状态展示和日志界面,处理信号槽、线程协作、对象生命周期、布局、主题和窗口缩放问题。适合做桌面界面开发、交互修复和配置同步,不适合把耗时逻辑直接塞进主线程。

gui-development

name

gui-development

description

这个 skill 处理桌面 GUI。 重点是页面、弹窗、交互逻辑、配置编辑、日志展示和运行状态反馈。 技术栈是 PySide6 加 QFluentWidgets。

when_to_use

出现这些情况时用:

  • 要改 software/ui/ 下的页面、对话框、导航、卡片、表格、日志面板。
  • 配置项在 UI 里显示错、保存错、同步错。
  • 运行状态、错误提示、日志展示不清楚。
  • 主线程卡死、信号槽没接好、对象生命周期出问题。

这些情况别乱搞:

  • 把网络、解析、平台逻辑直接塞进页面类。
  • 在主线程里跑 HTTP、磁盘大 IO、长循环。

instructions

  1. 先读入口和页面装配点。 必读:
    • software/app/main.py
    • software/ui/shell/main_window.py
    • software/ui/shell/main_window_parts/lazy_pages.py
    • 相关页面模块
  2. 优先复用现有 PySide6 / QFluentWidgets 组件。 不要自己造一套风格。
  3. 耗时任务别堵主线程。 需要走线程、异步桥接、任务队列或现有控制层。
  4. UI 改动时至少检查这些东西:
    • 信号槽连接
    • 对象生命周期
    • 布局是否挤炸
    • 深色模式
    • DPI 缩放
    • 异常提示是否能看懂
  5. 涉及配置编辑时,先找真实读写路径。 重点看:
    • software/app/settings_store.py
    • software/app/user_paths.py
    • 相关 software/io/ 和页面同步模块
  6. 涉及运行状态时,优先检查:
    • software/ui/controller/
    • software/ui/pages/workbench/runtime_panel/
    • software/ui/pages/workbench/log_panel/
    • software/ui/pages/workbench/dashboard/
  7. 不要吞异常。 用户至少要看到清楚的错误反馈,日志里也要能追。
  8. 修改后做基本 smoke test。 至少确保应用能启动,并能进入相关页面。

project_conventions

  • GUI 主目录是真实存在的 software/ui/。
  • 设置页、更多页、工作台页都通过主窗口懒加载组织,别乱改路由键。
  • 资源路径别写死安装目录。只读资源看 software/app/runtime_paths.py,用户可写配置看 software/app/user_paths.py。
  • 改 UI 优先用 QFluentWidgets 原生组件。
  • 不要把内部解释、迁移提示、开发说明直接写进图形界面。
  • 如果用了 Playwright MCP,本项目约束是用系统 Edge;但当前仓库规则同时禁止引入浏览器自动化依赖,普通 GUI 改动优先用 Qt smoke test。

common_commands

bash
uv run python SurveyController.py
uv run pytest CI/unit_tests/app
uv run pytest CI/unit_tests/app/test_runtime_panel_cards_qtbot.py
uv run pytest CI/unit_tests/app/test_question_wizard_dialog_qtbot.py
uv run pytest CI/unit_tests/app/test_quota_redeem_dialog.py
uv run python CI/python_ci.py
uv run python CI/python_ci.py --full
rg "QFluent|Signal|slot|qtbot|Page|Dialog" software/ui CI/unit_tests/app

validation_checklist

  • 是否先读了主窗口、目标页面、相关控制器和配置读写代码。
  • 是否复用了现有 PySide6 / QFluentWidgets 组件。
  • 是否没有把耗时任务放到主线程。
  • 信号槽、对象生命周期、布局、深色模式、缩放是否检查过。
  • 配置项显示和实际配置读写是否一致。
  • 日志、任务状态、错误反馈是否清楚,没有吞异常。
  • 是否做了基本 GUI smoke test;没跑要说明原因。

© SurveyController, GPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .codex/skills/gui-development of SurveyController/SurveyController.

Open the folder on GitHubat commit 1a22ba3

Compare with similar skills

Gui Development next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Gui Development compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Gui Development this skillSurveyController/SurveyController142—~580Automated safety check: PassGPL-3.0
Web Application Testinganthropics/skills180k51 repos~966Automated safety check: PassApache-2.0
Diagnosing Bugsfossasia/eventyay-interpretation1.6k32 repos~2.1kAutomated safety check: PassApache-2.0
TDDpietheinstrengholt/rssmonster56430 repos~906Automated safety check: PassMIT
TDD WorkflowhellangleZ/burn-in-cceverywhere-ralph11211 repos~2.4kAutomated safety check: PassNone
TDDsanity-io/sanity6.4k20 repos~1kAutomated safety check: PassMIT

Similar skills

  • Web Application Testing

    anthropics/skills

    Official

    Tests local web applications with Python Playwright scripts, checking frontend behavior, capturing screenshots and reading browser console logs.

    180k GitHub starsUsed in 51 repos~966 tokens
    Testing & QAAuto-check passed
  • Diagnosing Bugs

    fossasia/eventyay-interpretation

    Diagnosis loop for hard bugs and performance regressions. An agent skill from fossasia/eventyay-interpretation.

    1.6k GitHub starsUsed in 32 repos~2.1k tokens
    Testing & QAAuto-check passed
  • TDD

    pietheinstrengholt/rssmonster

    Test-driven development. An agent skill from pietheinstrengholt/rssmonster.

    564 GitHub starsUsed in 30 repos~906 tokens
    Testing & QAAuto-check passed
  • TDD Workflow

    hellangleZ/burn-in-cceverywhere-ralph

    A skill your agent uses when writing new features, fixing bugs, or refactoring code.

    112 GitHub starsUsed in 11 repos~2.4k tokens
    Testing & QAAuto-check passed
  • TDD

    sanity-io/sanity

    Official

    Test-driven development with red-green-refactor loop. An agent skill from sanity-io/sanity.

    6.4k GitHub starsUsed in 20 repos~1k tokens
    Testing & QAAuto-check passed
  • Context Driven Development

    Ibrahim-3d/orchestrator-supaconductor

    A skill your agent uses when working with Conductor's context-driven development methodology, managing project context artifacts, or understanding the relationship between product.md, tech-stack.md…

    380 GitHub starsUsed in 9 repos~2.9k tokens
    Testing & QAAuto-check passed

More from SurveyController/SurveyController

All 9 skills in this repo
  • App Settings Migration

    SurveyController/SurveyController

    面向 SurveyController 仓库的设置、路径与配置迁移技能。用于修改 software/app/、software/io/config/、software/core/config/ 里的 QSettings 键、用户目录、配置文件路径、schema 版本、序列化字段、默认值和兼容策略,避免升级后读错配置、写错目录或把旧配置直接干爆。适合做预防性演进,不适合只修表面报错。

    142 GitHub stars~732 tokensUpdated 19 days ago
    Auto-check passed
  • Async HTTP Pipeline

    SurveyController/SurveyController

    面向 SurveyController 仓库的全异步 HTTP 解析与执行链路技能。用于修改或排查 software/network/http/、software/core/engine/、software/providers/、software/network/proxy/ 以及各平台 provider 的异步请求、响应解析、任务调度、并发控制、超时、重试、取消和资源释放问题。适合处理纯…

    142 GitHub stars~648 tokensUpdated 19 days ago
    Auto-check passed
  • Log Config Debugging

    SurveyController/SurveyController

    面向 SurveyController 的日志、配置与报错排查技能。用于根据用户提供的日志、截图、配置文件、调用栈、运行环境和最近改动定位根因,修复 software/app/、software/io/、software/logging/、software/network/、software/ui/…

    142 GitHub stars~481 tokensUpdated 19 days ago
    Auto-check passed
  • Playwright Pipeline

    SurveyController/SurveyController

    面向 SurveyController 仓库 v3 分支的 Playwright 作答执行层技能。仅在修改或排查 Playwright 作答链路、异步浏览器 owner/context 池、BrowserDriver 封装、页面加载、运行时答题、翻页、提交、取消、超时、资源释放和并发调度时使用。只能用于 v3 分支;只允许系统自带 Microsoft Edge,不允许安装或引入…

    142 GitHub stars~945 tokensUpdated 19 days ago
    Auto-check passed
  • Question Parser Rules

    SurveyController/SurveyController

    面向 SurveyController 仓库的题型解析、字段映射与 parser 规则技能。用于修改 wjx/provider/、tencent/provider/、credamo/provider/、software/core/questions/、software/providers/ 中的题目结构解析、元数据字段、题型识别、逻辑规则标记、答案模型映射和最小兼容适配。适合处理 parser…

    142 GitHub stars~653 tokensUpdated 19 days ago
    Auto-check passed
  • Structure Refactor

    SurveyController/SurveyController

    面向 SurveyController 仓库的目录结构重构与模块拆分技能。用于整理 software/、wjx/、tencent/、credamo/、CI/unittests/ 等真实目录,处理文件移动、命名调整、导入修复、测试路径更新、资源路径修复、CI 检查联动。适合在需要小步重构、保持行为不变、清理屎山边界时使用,不适合纯样式改名或无关大洗牌。

    142 GitHub stars~645 tokensUpdated 19 days ago
    Auto-check passed

Categories

Questions about Gui Development

What does Gui Development do?

面向 SurveyController 桌面端的 GUI 开发与界面修复技能。用于修改 software/ui/ 下的 PySide6 + QFluentWidgets 页面、弹窗、导航、配置编辑、运行状态展示和日志界面,处理信号槽、线程协作、对象生命周期、布局、主题和窗口缩放问题。适合做桌面界面开发、交互修复和配置同步,不适合把耗时逻辑直接塞进主线程。. Gui Development is an agent skill from SurveyController/SurveyController.

When should I use Gui Development?

Gui Development fits situations like: testing & QA work in your project.

How do I install Gui Development in Claude Code?

Run `npx skills add SurveyController/SurveyController --skill gui-development -a claude-code`. Or copy the skill folder (.codex/skills/gui-development in SurveyController/SurveyController) into .claude/skills/gui-development in your project. Claude Code loads it when a task matches its description.

How do I install Gui Development in Codex?

Run `npx skills add SurveyController/SurveyController --skill gui-development -a codex`. Or copy the skill folder (.codex/skills/gui-development in SurveyController/SurveyController) into .agents/skills/gui-development in your project. Codex loads it when a task matches its description.

Can I use Gui Development in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add SurveyController/SurveyController --skill gui-development -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/gui-development, .gemini/skills/gui-development, .github/skills/gui-development and .opencode/skills/gui-development in your project.

What does Gui Development need to run?

Going by SKILL.md and its folder, Gui Development needs the command-line tools its instructions call (uv and rg). Our summary lists: Python 3.

Does Gui Development access the network?

SKILL.md contains no URLs. Its commands use uv, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Gui Development safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Gui Development use?

Gui Development is published under the GPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Gui Development use?

About 580 tokens (SKILL.md is roughly 2.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Gui Development?

Skills that share tags, products or a category with Gui Development: Web Application Testing (anthropics/skills, 180k stars), Diagnosing Bugs (fossasia/eventyay-interpretation, 1.6k stars), TDD (pietheinstrengholt/rssmonster, 564 stars) and TDD Workflow (hellangleZ/burn-in-cceverywhere-ralph, 112 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Gui Development?

SurveyController (a GitHub organization) maintains it in SurveyController/SurveyController, which has 142 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on September 18, 2026.

Source: SurveyController/SurveyController on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.