Back to Skills

winui3-migration-guide

UWP-to-WinUI 3 migration reference. Maps legacy UWP APIs to correct Windows App SDK equivalents with before/after code snippets. Covers namespace changes, threading (CoreDispatcher to DispatcherQueue), windowing (CoreWindow to AppWindow), dialogs, pickers, sharing, printing, background tasks, and the most common Copilot code generation mistakes.

31,451stars3,809forksUpdated 4/28/2026

Security Assessment

Medium Risk(60/100)

Detected risks:

Privilege Escalation([SKILL.md] RunAs)
Security Score60/100

About winui3-migration-guide

The 'winui3-migration-guide' skill assists developers in migrating their Universal Windows Platform (UWP) applications to WinUI 3, the modern Windows UI framework. It provides comprehensive guidance by mapping legacy UWP APIs to their appropriate Windows App SDK equivalents, helping users transition smoothly from older frameworks. This guide aims to eliminate confusion around UWP-to-WinUI 3 API changes and assists developers in verifying their migrated code to ensure it adheres to the new WinUI 3 standards. By providing before-and-after code snippets, this skill ensures users can quickly spot differences and implement solutions effectively, reducing the risk of compatibility issues and errors during migration.

FAQ

What is the purpose of this migration guide?

The purpose of this guide is to help developers transition from UWP to WinUI 3 by mapping legacy UWP APIs to their WinUI 3 equivalents, addressing common issues, and providing clear before/after code examples to ensure proper migration.

Is this skill compatible with all UWP applications?

This skill is specifically designed for migrating UWP apps to WinUI 3. However, certain UWP features or APIs may not have direct WinUI 3 counterparts, so some adjustments might be necessary depending on the specific UWP app.

Does this guide address all WinUI 3 APIs?

No, this guide focuses on the most common UWP-to-WinUI 3 migrations, covering key areas such as namespaces, windowing, dialogs, threading, and other frequently used APIs. It may not cover every possible WinUI 3 API.

Can this skill help with Copilot code generation mistakes?

Yes, the skill specifically highlights the most common Copilot-generated code mistakes, such as incorrect dialog usage or outdated dispatcher calls, and offers corrected solutions.

Install winui3-migration-guide

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill