dotnet-wpf-migration

Guide migration of WPF, WinForms, and UWP apps to .NET 8+.

1|Updated Feb 22, 2026
One-click install
npx skills add https://github.com/rudironsoni/dotnet-agent-harness --skill dotnet-wpf-migration-rudironsoni
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dotnet-wpf-migration
Source: https://github.com/rudironsoni/dotnet-agent-harness/tree/main/.rulesync/skills/dotnet-wpf-migration
Command: npx skills add https://github.com/rudironsoni/dotnet-agent-harness --skill dotnet-wpf-migration-rudironsoni

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps developers migrate legacy desktop applications (WPF, WinForms, UWP) to modern .NET versions and frameworks, reducing technical debt and enabling access to new platform features.

Core Features & Use Cases

  • Migration Guidance: Provides decision matrices and step-by-step instructions for various migration paths (e.g., WPF .NET Framework to .NET 8+, UWP to WinUI 3).
  • Tooling Recommendations: Details the use of tools like dotnet-upgrade-assistant and highlights manual steps required.
  • Use Case: A team has a large WPF .NET Framework application and needs to modernize it for better performance and maintainability. This Skill guides them through migrating to WPF .NET 8+, outlining the necessary code changes and tool usage.

Quick Start

Use the dotnet-wpf-migration skill to get guidance on migrating a WPF .NET Framework application to .NET 8+.

Frequently Asked Questions about dotnet-wpf-migration

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

FAQPage Schema
How do I migrate a WPF .NET Framework application to .NET 8?

To migrate a WPF .NET Framework application to .NET 8, use the .NET Upgrade Assistant tool to automate initial changes and follow manual steps to address API compatibility and XAML differences for a successful migration.

What is the best path to migrate UWP apps to a modern .NET framework?

Migrating UWP apps to modern .NET involves targeting WinUI 3, Uno Platform, or WPF .NET 8+. Decision matrices help evaluate paths while addressing API compatibility and tooling requirements for desktop app modernization.

Can I use the .NET Upgrade Assistant for WinForms migration?

Yes, the .NET Upgrade Assistant supports WinForms migration to .NET 8+. It automates project file updates but manual steps are required to resolve API compatibility issues and ensure desktop application stability.

What are common API compatibility issues when upgrading desktop apps to modern .NET?

Common API compatibility issues during desktop app migration involve unavailable framework-specific APIs and XAML differences. Resolving these requires manual code adjustments after running the .NET Upgrade Assistant.

Does migrating to WinUI 3 from WPF require handling XAML differences?

Yes, migrating from WPF to WinUI 3 requires handling XAML differences due to distinct namespace structures and control implementations. Migration guidance details necessary manual adjustments for compatibility.

When should I not use the .NET Upgrade Assistant for desktop app migration?

Avoid relying solely on the .NET Upgrade Assistant for complex desktop migrations with heavily customized APIs. Manual intervention is necessary to resolve compatibility issues and finalize the WPF or WinForms .NET 8+ transition.