winui-ui-testing

Automates UI testing of Windows desktop apps via UI Automation batch scripts.

3|Updated Aug 8, 2026
One-click install
npx skills add https://github.com/Jose-Polanco-Oxte/Echos-Live-Music-Visualizer --skill winui-ui-testing-jose-polanco-oxte
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: winui-ui-testing
Source: https://github.com/Jose-Polanco-Oxte/Echos-Live-Music-Visualizer/tree/main/.agents/skills/winui/sub-skills/winui-ui-testing
Command: npx skills add https://github.com/Jose-Polanco-Oxte/Echos-Live-Music-Visualizer --skill winui-ui-testing-jose-polanco-oxte

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually clicking through a Windows desktop app to verify every button, text field, dialog, and navigation flow is slow and unrepeatable. This Skill generates and runs a scripted UI Automation test suite that exercises the app's controls, asserts expected values, audits accessibility, and captures screenshots in one pass. ## Core Features & Use Cases - Batch Test Script Generation: Creates a ui-tests.ps1 PowerShell script using the winapp ui harness to assert element existence, values, navigation, and interactions in a single run. - Rich Input Simulation: Supports keyboard shortcuts and typing (send-keys), hover, drag-and-drop, touch gestures, pen input, file pickers, context menus, flyouts, and ContentDialogs. - Accessibility & Visual Verification: Audits controls for missing AutomationIds and captures screenshots or H.264 video recordings for visual review of clipping, overlap, and theming issues. - Use Case: After building a WinUI 3 settings page, generate a test script that sets a username TextBox, toggles a switch, selects a ComboBox theme, clicks Save, verifies persisted values, and screenshots each state. ## Quick Start Generate and run a UI test script for my running Windows app that verifies all buttons, text fields, and navigation work as expected.

Frequently Asked Questions about winui-ui-testing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate UI testing for a WinUI 3 app?

Generate a ui-tests.ps1 script that uses the winapp ui harness to wait for elements by AutomationId, invoke buttons, set values, and assert expected states with wait-for --value. Run it against the app's PID and read pass/fail results from test-results.json.

Can UI Automation test WPF, WinForms, and Win32 apps?

Yes. The winapp ui tool drives Windows UI Automation, the accessibility layer exposed by every Windows UI framework, so the same verbs and script template work on Win32, WPF, WinForms, and WinUI 3 apps, packaged or unpackaged.

Why does set-value not update my TextBox binding?

WinUI 3 x:Bind TwoWay TextBox bindings commit on LostFocus by default, and UIA set-value does not trigger focus events. Use UpdateSourceTrigger=PropertyChanged in the app, or invoke a button or focus another element after set-value to force the commit.

How do I test file open and save dialogs in a Windows app?

File pickers run in a separate PickerHost process, so use list-windows to find the picker HWND, then interact with it using the -w flag: set-value the filename field and invoke Open, Save, or Cancel. Then verify the app processed the file.

How do I test keyboard shortcuts like Ctrl+S in a desktop app?

Use send-keys with the send-input transport, for example winapp ui send-keys "ctrl+s" --via send-input, which fires real per-key input that triggers KeyboardAccelerators. The default post-message transport does not raise the KeyDown events accelerators need.