Desktop WinUI 3 Engineering

Purpose

This skill encapsulates all the necessary architectural knowledge, design paradigms, and coding standards required to develop, test, and deploy robust desktop applications on Windows using WinUI 3 and the Windows App SDK. It provides agents and developers with precise operational semantics, troubleshooting heuristics, and structural templates to craft high-performance, fluent-design experiences.

Core Principles

Unify the Presentation Layer: Always rely on WinUI 3 as the primary native UI framework, abstracting away Win32/UWP differences when possible.
Prioritize Asynchronous Operations: Leverage asynchronous programming (async/await in C#, co_await in C++/WinRT) for all I/O and intensive computations to maintain a responsive UI thread.
Adopt Fluent Design Natively: Implement native materials (Mica, Acrylic) and coherent animations consistently to match the Windows 11 design philosophy.
Decouple Logic and View: Implement strict MVVM (Model-View-ViewModel) patterns to ensure maintainability and testability of business logic.
Optimize Resource Utilization: Use virtualization for long lists and compiled bindings (x:Bind) extensively for minimal memory footprint and optimal execution speed.

Agent Protocol

Triggers

When the user asks to "Create a new WinUI 3 app" or "Add a page to the desktop app".
When encountering errors related to Microsoft.UI.Xaml, DispatcherQueue, or Windows App SDK.