# Winui3 Full Skill

> Generates production-quality WinUI 3 (Windows App SDK 1.8+) code — XAML + C# snippets for all ~70 controls, MVVM/DI patterns, Fluent Design, async, accessibility, and theming best practices.

- Skill: `sudocode76/winui3-full-skill` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add sudocode76/winui3-full-skill`
- Raw SKILL.md: https://api.skillmd.com/api/skills/sudocode76/winui3-full-skill/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: sudocode76 (https://skillmd.com/u/sudocode76)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/sudocode76/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` |