Qt Testing

What it does

When your agent uses it

• Asked to verify GUI rendering
• Test widget appearance
• Visually inspect any FreeCCR widget (image preview

Example prompts

• “/qt-testing”

Requirements

• Python 3

Workflow steps

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

1. 1Create/obtain the FreeCCR widget to test (see examples below)
2. 2Call capture_widget(widget, "description")
3. 3Read the saved screenshot with the Read tool
4. 4Analyze with vision to verify correctness (layout, spacing, theming, labels)

What it can do on your machine

Read from SKILL.md and the folder at commit db1b679. 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

  Ships 1 file in scripts/ (Python), which the agent can run.

  Shell commands in SKILL.md call:

  • python

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

• Network

  No URLs in SKILL.md.

  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

Qt Testing loads about 1.3k tokens when it runs. Until then it costs about 108 tokens; SKILL.md has 265 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~108

When it runs · the whole SKILL.md, loaded when a task matches

~1.3k

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from toonoumi/FreeCCR at commit db1b679, republished under its AGPL-3.0 licence (© toonoumi). 265 words, ~1,339 tokens.

name

qt-testing

description

Capture and visually inspect FreeCCR's PySide6/Qt GUI widgets using screenshots. Use when asked to verify GUI rendering, test widget appearance, check layouts, theming/QSS, or visually inspect any FreeCCR widget (image preview, sliders panel, curve editor, thumbnail list, dust panel, export dialog, main window). Enables Claude to "see" the Qt interface by capturing offscreen screenshots and analyzing them with vision.

# Capture any widget
import sys
sys.path.insert(0, ".claude/skills/qt-testing")   # so `from scripts.qt_capture import ...` works
from scripts.qt_capture import capture_widget, init_qt, setup_freeccr_path

setup_freeccr_path()          # puts repo root + src/ on sys.path
app = init_qt()               # creates the QApplication

path = capture_widget(my_widget, "description_here")
# Then read the screenshot with the Read tool

# Standalone self-test (renders a throwaway widget, saves a PNG)
python .claude/skills/qt-testing/scripts/qt_capture.py

from core.ccr_backend import ccr_backend          # ensures the global singleton exists

from ui.main_window import MainWindow              # MainWindow()              — full app shell
from widgets.sliders_panel import SlidersPanel     # SlidersPanel(None)        — Kelvin/tint/exposure controls
from widgets.image_preview import ImagePreview     # ImagePreview(None)        — central canvas + toolbar
from widgets.curve_editor import CurveEditor       # CurveEditor(None)         — tone curve tool
from widgets.thumbnail_list import ThumbnailList   # ThumbnailList(lambda *a: None)  — sidebar (needs a callback)
from widgets.tether_banner import TetherBanner     # TetherBanner(None)        — tether status strip

# Widgets that need collaborators — pass lightweight stubs:
from widgets.dust_panel import DustRemovalPanel    # DustRemovalPanel(main_window, image_preview)
from widgets.export_dialog import ExportSettingsDialog  # ExportSettingsDialog()  — reads ccr_backend.images

import sys
sys.path.insert(0, ".claude/skills/qt-testing")
from scripts.qt_capture import capture_widget, init_qt, setup_freeccr_path

setup_freeccr_path()
app = init_qt()

from core.ccr_backend import ccr_backend           # singleton ready
from widgets.sliders_panel import SlidersPanel

panel = SlidersPanel(None)
panel.resize(360, 700)                              # give it a sensible size before grab()
path = capture_widget(panel, "sliders_panel_default")
print(f"Inspect: {path}")

import sys
sys.path.insert(0, ".claude/skills/qt-testing")
from scripts.qt_capture import capture_widget, init_qt, setup_freeccr_path

setup_freeccr_path()
app = init_qt()

from ui.main_window import MainWindow

win = MainWindow()
win.resize(1280, 800)
path = capture_widget(win, "main_window_empty")
win.close()
print(f"Inspect: {path}")

# Find widget at coordinates (from vision analysis)
target = widget.childAt(x, y)

# Trigger it directly (not mouse events)
if hasattr(target, 'click'):
    target.click()
    QApplication.processEvents()

# Capture result
capture_widget(widget, "after_click")

© toonoumi, AGPL-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

SKILL.md and 1 other file (scripts) in .claude/skills/qt-testing of toonoumi/FreeCCR.

• SKILL.md
• scripts/qt_capture.py

Open the folder on GitHubat commit db1b679