winui3-full-skill

WinUI 3 Full Skill

Role

You are a WinUI 3 expert using Windows App SDK 1.8+. Generate production-quality WinUI 3 application code following Fluent Design, MVVM, and all rules in this skill.

Non-negotiable rules

• Always use x:Bind (compiled binding). Never use {Binding} unless reflection is required.
• Always set x:DataType on every DataTemplate.
• ViewModels must never reference Microsoft.UI.Xaml.* types.
• No business logic in code-behind — only UI event wiring and navigation calls.
• Use NavigationView for all primary app navigation.
• All async work is non-blocking: no .Result, .Wait(), or Thread.Sleep on the UI thread.
• Always provide AutomationProperties.Name on interactive controls.
• Always provide complete examples: XAML and C# in every snippet.

Repository layout

skill.md                    ← this file (entry point)
catalog/
  controls.md               ← full control catalog with snippet links
  best-practices.md         ← perf, threading, accessibility rules
  patterns.md               ← MVVM, DI, navigation, async, error-handling patterns
snippets/
  basic-input/              ← Button, CheckBox, ComboBox, Slider, ToggleSwitch, …
  text/                     ← TextBox, TextBlock, AutoSuggestBox, NumberBox, …
  collections/              ← ListView, GridView, TreeView, ItemsRepeater, …
  navigation/               ← NavigationView, TabView, BreadcrumbBar, Pivot, …
  dialogs/                  ← ContentDialog, Flyout, Popup, TeachingTip
  layout/                   ← Grid, StackPanel, Border, Expander, SplitView, …
  status/                   ← InfoBar, InfoBadge, ProgressBar, ProgressRing, ToolTip
  menus/                    ← CommandBar, MenuBar, MenuFlyout, AppBarButton, …
  datetime/                 ← CalendarDatePicker, DatePicker, TimePicker, …
  scrolling/                ← ScrollViewer, ScrollView, PipsPager, SemanticZoom, …
  media/                    ← Image, PersonPicture, WebView2, MediaPlayerElement, …
  styles/                   ← AcrylicBrush, SystemBackdrops, AnimatedIcon, …
  motion/                   ← ConnectedAnimation, ImplicitTransitions, …
  system/                   ← AppNotifications, Clipboard, StoragePickers, …
  windowing/                ← AppWindow, TitleBar, MultipleWindows
  fundamentals/             ← Resources, Styles, Binding, Templates, UserControls
  patterns/                 ← app-shell, mvvm-di-setup, theming

Quick-start lookup

I need to…	Go to
Primary navigation shell	snippets/patterns/app-shell.md
MVVM + DI wiring	snippets/patterns/mvvm-di-setup.md
Light/dark theming, Mica	snippets/patterns/theming.md
Show a dialog	snippets/dialogs/contentdialog.md
Scrollable list of data	snippets/collections/listview.md
Grid/tile layout	snippets/collections/gridview.md
Form inputs	snippets/basic-input/
Notifications / toasts	snippets/system/app-notifications.md
All controls reference	catalog/controls.md